Boost-Commit mailing page: [Boost-commit] svn:boost r60189 - sandbox/filesystem-v3/libs/filesystem/doc

Date view	Thread view	Subject view	Author view

Subject: [Boost-commit] svn:boost r60189 - sandbox/filesystem-v3/libs/filesystem/doc
From: bdawes_at_[hidden]
Date: 2010-03-05 10:38:46

Next message: joel_at_[hidden]: "[Boost-commit] svn:boost r60190 - in trunk/libs/spirit: doc/qi test/qi"
Previous message: erwann.rogard_at_[hidden]: "[Boost-commit] svn:boost r60188 - sandbox/statistics/detail/assign/boost/assign/auto_size/detail"

Author: bemandawes
Date: 2010-03-05 10:38:45 EST (Fri, 05 Mar 2010)
New Revision: 60189
URL: http://svn.boost.org/trac/boost/changeset/60189

Log:
path_table cleanup complete
Text files modified:
   sandbox/filesystem-v3/libs/filesystem/doc/do_list.html | 6
   sandbox/filesystem-v3/libs/filesystem/doc/path_table.cpp | 11
   sandbox/filesystem-v3/libs/filesystem/doc/path_table.txt | 12 +
   sandbox/filesystem-v3/libs/filesystem/doc/reference.html | 371 +++++++++++++++------------------------
   4 files changed, 170 insertions(+), 230 deletions(-)

Modified: sandbox/filesystem-v3/libs/filesystem/doc/do_list.html
==============================================================================
--- sandbox/filesystem-v3/libs/filesystem/doc/do_list.html (original)
+++ sandbox/filesystem-v3/libs/filesystem/doc/do_list.html 2010-03-05 10:38:45 EST (Fri, 05 Mar 2010)
@@ -16,7 +16,7 @@
<body>

<h1>Boost Filesystem Do List 
-03 March 2010</h1>
+05 March 2010</h1>

<h2>Beta 1 comments</h2>
<ul>
@@ -86,10 +86,6 @@
 But is that really correct?</li>
 <li style="font-size: 10pt">Behavior of root_path() has been changed. Change
 needs to be propagated to trunk?</li>
- <li style="font-size: 10pt">reference.html#Path-decomposition-table needs rows
- for //, //netname, //netname/foo Make sure current trunk has passing tests for
- those cases, all decompositions. See test_decompositions() in
- path_unit_test.cpp.</li>
 <li style="font-size: 10pt">Add docs for scoped_path_locale.</li>
 <li style="font-size: 10pt">Regenerate path decomposition table.</li>
</ul>

Modified: sandbox/filesystem-v3/libs/filesystem/doc/path_table.cpp
==============================================================================
--- sandbox/filesystem-v3/libs/filesystem/doc/path_table.cpp (original)
+++ sandbox/filesystem-v3/libs/filesystem/doc/path_table.cpp 2010-03-05 10:38:45 EST (Fri, 05 Mar 2010)
@@ -116,8 +116,13 @@
 else
 {
 std::getline(posix_infile, temp);
- value += " ";
- value += temp;
+ if (value != temp) // POSIX and Windows differ
+ {
+ value.insert(0, " ");
+ value.insert(0, temp);
+ value.insert(0, "");
+ value += "";
+ }
 outfile << value;
 }
 outfile << "</td>\n";
@@ -171,6 +176,8 @@
 string test_case;
 while ( std::getline( infile, test_case ) )
 {
+ if (!test_case.empty() && *--test_case.end() == '\r')
+ test_case.erase(test_case.size()-1);
 if (test_case.empty() || test_case[0] != '#')
 do_row( test_case );
 }

Modified: sandbox/filesystem-v3/libs/filesystem/doc/path_table.txt
==============================================================================
--- sandbox/filesystem-v3/libs/filesystem/doc/path_table.txt (original)
+++ sandbox/filesystem-v3/libs/filesystem/doc/path_table.txt 2010-03-05 10:38:45 EST (Fri, 05 Mar 2010)
@@ -1,3 +1,13 @@
+# Paths for the reference.html Path Decomposition Table
+#
+# This is the input file for path_table, which generates the actual html
+#
+# Copyright Beman Dawes 2010
+#
+# Distributed under the Boost Software License, Version 1.0.
+# See www.boost.org/LICENSE_1_0.txt
+#
+# Note that an empty line is treated as input rather than as a comment

.
..
@@ -8,6 +18,8 @@
/foo/
foo/bar
/foo/bar
+//net
+//net/foo
///foo///
///foo///bar
/.

Modified: sandbox/filesystem-v3/libs/filesystem/doc/reference.html
==============================================================================
--- sandbox/filesystem-v3/libs/filesystem/doc/reference.html (original)
+++ sandbox/filesystem-v3/libs/filesystem/doc/reference.html 2010-03-05 10:38:45 EST (Fri, 05 Mar 2010)
@@ -7,12 +7,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>Filesystem Reference
</title>
-<style type="text/css">
- ins {background-color:#A0FFA0}
- del {background-color:#FFA0A0}
- body { font-family: sans-serif;}
-
-</style>
+<link rel="stylesheet" type="text/css" href="minimal.css">
</head>

<body>
@@ -923,7 +918,9 @@
decomposition</a></h3>
See the
<a href="#Path-decomposition-table">Path decomposition table</a> for examples
-for values returned by decomposition functions.
+for values returned by decomposition functions. The
+Tutorial may also be
+helpful.
<pre>path <a name="path-root_name">root_name</a>() const;</pre>
<blockquote>
Returns: root-name, if <code>pathname</code> includes 
@@ -1080,9 +1077,6 @@
 Returns: The end iterator.
</blockquote>
<h3> <a name="path-deprecated-functions"><code> path</code> deprecated functions</a></h3>
- index.htm
-also has a section (see macros) partially duplicating this material. Change to
-reference this.
 Several member functions from previous versions of <code>class path</code>
have been deprecated, either because they have been renamed or because the
functionality is no longer desirable or has become obsolete.
@@ -1105,8 +1099,6 @@
const string_type external_file_string() const { return native(); }
const string_type external_directory_string() const { return native(); }</pre>
</blockquote>
-Functions no longer available:
-TBS
<h3> <a name="path-non-member-functions"> <code>path</code>
non-member functions</a></h3>
<pre>void swap( path& lhs, path& rhs )</pre>
@@ -1624,8 +1616,7 @@
iterator.
<blockquote>
The above wording is based on the
-Standard Library's istream_iterator wording. Commentary was shortened and
-moved into a note.
+Standard Library's istream_iterator wording.
</blockquote>
The result of calling the <code>path()</code> member of the <code>
directory_entry</code> object obtained by dereferencing a <code>
@@ -2135,19 +2126,16 @@
 </blockquote>
<pre><code>bool <a name="is_regular_file3">is_regular_file</a>(const path& p, system::error_code& ec);</code></pre>
<blockquote>
- Effects: Sets <code>ec</code> as if by <code>status(p, ec)</code>.
- [Note:
- 
- <code>status_error</code>,
- 
- <code>file_not_found</code>
- and 
- <code>type_unknown</code>
- cases set <code>ec</code>
- to error values. To distinguish between cases, call the <code>
- status</code>
- function directly. -- end
- note] 
+ Effects: Sets <code>ec</code> as if by <code>status(p, ec)</code>. [Note:
+ <code>status_error</code>,
+ <code>file_not_found</code>
+ and
+ <code>type_unknown</code>
+ cases set <code>ec</code>
+ to error values. To distinguish between cases, call the <code>
+ status</code>
+ function directly. -- end
+ note] 
 Returns: <code>is_regular_file(status(p, ec))</code>.
 Throws: Nothing.
</blockquote>
@@ -2325,10 +2313,6 @@
 of the file
 <code>p</code> resolves to, as if by POSIX <code>
 <a href="http://www.opengroup.org/onlinepubs/000095399/functions/stat.html">stat()</a></code>.
- [Note: If a symbolic link is encountered during pathname
- resolution,
- pathname resolution continues using the contents of the symbolic link. --
- end note]
 If, during attribute determination, the underlying file system API reports
 an error, sets <code>ec</code> to indicate the specific error reported.
 Otherwise, <code>ec.clear()</code>.<blockquote>
@@ -2410,6 +2394,9 @@
 </ul>
 </blockquote>
Throws: Nothing.
+ Remarks: If a symbolic link is encountered during pathname
+ resolution,
+ pathname resolution continues using the contents of the symbolic link.
</blockquote>
<pre>bool <a name="status_known">status_known</a>(file_status s);</pre>
<blockquote>
@@ -2417,8 +2404,8 @@
 <code>s.type() != status_error</code>
 Throws: Nothing.
</blockquote>
-<pre>file_status <a name="symlink_status">symlink_status</a>(const path& p);
-file_status <a name="symlink_status2">symlink_status</a>(const path& p, system::error_code& ec);</pre>
+<pre>file_status <a name="symlink_status">symlink_status</a>(const path& p);
+file_status <a name="symlink_status2">symlink_status</a>(const path& p, system::error_code& ec);</pre>
<blockquote>
 Effects:  Same as status(), above,
 except that the attributes
@@ -2428,14 +2415,12 @@
 lstat()</a></code>.
</blockquote>
<blockquote>
- <blockquote>
- [Note: Pathname resolution terminates if <code>p</code> names a symbolic link. --
- end note]
- </blockquote>
- Returns: Same as status(), above,
- except ....
-Throws: <code>filesystem_error</code>; overload with <code>error_code&</code> throws
-nothing.
+ Returns: Same as status(), above, except
+ that if the attributes indicate a symbolic link, as if by POSIX
+ <a class="external" href="http://www.opengroup.org/onlinepubs/000095399/basedefs/sys/stat.h.html">
+ S_ISLNK()</a>, return <code>file_status(symlink_file)</code>.
+Throws: Nothing.
+ Remarks: Pathname resolution terminates if <code>p</code> names a symbolic link.
</blockquote>
<pre>path <a name="system_complete">system_complete</a>(const path& p);
path <a name="system_complete2">system_complete</a>(const path& p, system::error_code& ec);</pre>
@@ -2485,64 +2470,6 @@
 provided by the operating system. [Note: Such generators may block
 until sufficient entropy develops. --end note]
</blockquote>
-<h4><a name="Convenience-functions">Convenience functions</a></h4>
-<table border="1" cellpadding="5" cellspacing="1" style="border-collapse: collapse" bordercolor="#111111">
- <tr>
- <td>
- <h4>Deprecated convenience functions</h4>
- The following functions have been replaced by
- <code>path</code>
- member functions <code>extension()</code>,
- <code>stem()</code>, and
- <code>
- replace_extension()</code>.
-<pre>typename Path::string_type extension(const path& p);</pre>
-<blockquote>
- Returns: if
- <code>p.filename()</code> contains a
- dot, returns
- the substring of
- <code>p.filename()</code> starting at the rightmost
- dot
- and ending at the string's end. Otherwise, returns an empty string. 
- [Note:
- The 
- dot is included in the return value so that
- it is possible to distinguish between no extension and an empty extension.
- 
- Implementations are permitted but not required to define additional
- behavior for file systems which append additional elements to extensions, such
- as alternate data stream or partitioned dataset names. 
- -- end note]
-</blockquote>
-<pre>typename Path::string_type basename(const path& p);</pre>
-<blockquote>
- Returns: if
- <code>p.filename()</code> contains a
- dot, returns
- the substring of
- <code>p.filename()</code> starting at its beginning and
- ending at the last dot (the
- dot is not included). Otherwise,
- returns <code>
- p.filename()</code>.
-</blockquote>
-<pre>template <class Path>
- Path change_extension(const path& p, const typename Path::string_type & new_extension);</pre>
-<blockquote>
- Postcondition:
- <code>basename(return_value) == basename(p) &&
- extension(return_value) == new_extension</code>
- 
- [Note: It follows from the semantics of
- <code>extension()</code>
- that <code>new_extension</code> should include
- dot to achieve
- reasonable results. -- end note]
-</blockquote>
- </td>
- </tr>
-</table>
<h3><a name="File-streams">File streams</a> -
<a href="../../../boost/filesystem/fstream.hpp"><boost/filesystem/fstream.hpp></a></h3>
Replacements are provided for the file stream classes from the C++ standard
@@ -2607,17 +2534,17 @@
Shaded entries indicate cases where POSIX and Windows
implementations yield different results. The top value is the
POSIX result and the bottom value is the Windows result. 
- <table border="1" cellspacing="0" cellpadding="5" width="1066">
+ <table border="1" cellspacing="0" cellpadding="5">

-<tr><td>Constructor argument</td>
-<td>Iteration over Elements</td>
+<tr><td>Constructor argument</td>
+<td>Iteration over Elements</td>
<td><code>string()</code></td>
<td><code>generic_ string()</code></td>
<td><code>root_ path()</code></td>
<td><code>root_ name()</code></td>
<td><code>root_ directory()</code></td>
<td><code>relative_ path()</code></td>
-<td><code>parent_ path(</code></td>
+<td><code>parent_ path()</code></td>
<td><code>filename()</code></td>
</tr>
<tr>
@@ -2741,6 +2668,30 @@
<td><code>bar</code></td>
</tr>
<tr>
+<td><code>//net</code></td>
+<td><code>//net</code></td>
+<td><code>//net</code></td>
+<td><code>//net</code></td>
+<td><code>//net</code></td>
+<td><code>//net</code></td>
+<td>empty</td>
+<td>empty</td>
+<td>empty</td>
+<td><code>//net</code></td>
+</tr>
+<tr>
+<td><code>//net/foo</code></td>
+<td><code>//net,/,foo</code></td>
+<td><code>//net/foo</code></td>
+<td><code>//net/foo</code></td>
+<td><code>//net/</code></td>
+<td><code>//net</code></td>
+<td><code>/</code></td>
+<td><code>foo</code></td>
+<td><code>//net/</code></td>
+<td><code>foo</code></td>
+</tr>
+<tr>
<td><code>///foo///</code></td>
<td><code>/,foo,.</code></td>
<td><code>///foo///</code></td>
@@ -2901,82 +2852,82 @@
<td><code>c:</code></td>
<td><code>c:</code></td>
<td><code>c:</code></td>
-<td><code>c:</code></td>
-<td><code>c:</code></td>
-<td>empty</td>
+<td>empty <code>c:</code></td>
+<td>empty <code>c:</code></td>
<td>empty</td>
+<td><code>c:</code> empty</td>
<td>empty</td>
<td><code>c:</code></td>
</tr>
<tr>
<td><code>c:/</code></td>
-<td><code>c:,/</code></td>
-<td><code>c:/</code></td>
+<td><code>c:,.</code> <code>c:,/</code></td>
<td><code>c:/</code></td>
<td><code>c:/</code></td>
+<td>empty <code>c:/</code></td>
+<td>empty <code>c:</code></td>
+<td>empty <code>/</code></td>
+<td><code>c:/</code> empty</td>
<td><code>c:</code></td>
-<td><code>/</code></td>
-<td>empty</td>
-<td><code>c:</code></td>
-<td><code>/</code></td>
+<td><code>.</code> <code>/</code></td>
</tr>
<tr>
<td><code>c:foo</code></td>
-<td><code>c:,foo</code></td>
+<td><code>c:foo</code> <code>c:,foo</code></td>
<td><code>c:foo</code></td>
<td><code>c:foo</code></td>
-<td><code>c:</code></td>
-<td><code>c:</code></td>
+<td>empty <code>c:</code></td>
+<td>empty <code>c:</code></td>
<td>empty</td>
-<td><code>foo</code></td>
-<td><code>c:</code></td>
-<td><code>foo</code></td>
+<td><code>c:foo</code> <code>foo</code></td>
+<td>empty <code>c:</code></td>
+<td><code>c:foo</code> <code>foo</code></td>
</tr>
<tr>
<td><code>c:/foo</code></td>
-<td><code>c:,/,foo</code></td>
+<td><code>c:,foo</code> <code>c:,/,foo</code></td>
<td><code>c:/foo</code></td>
<td><code>c:/foo</code></td>
-<td><code>c:/</code></td>
-<td><code>c:</code></td>
-<td><code>/</code></td>
-<td><code>foo</code></td>
-<td><code>c:/</code></td>
+<td>empty <code>c:/</code></td>
+<td>empty <code>c:</code></td>
+<td>empty <code>/</code></td>
+<td><code>c:/foo</code> <code>foo</code></td>
+<td><code>c:</code> <code>c:/</code></td>
<td><code>foo</code></td>
</tr>
<tr>
<td><code>c:foo/</code></td>
-<td><code>c:,foo,.</code></td>
+<td><code>c:foo,.</code> <code>c:,foo,.</code></td>
<td><code>c:foo/</code></td>
<td><code>c:foo/</code></td>
-<td><code>c:</code></td>
-<td><code>c:</code></td>
+<td>empty <code>c:</code></td>
+<td>empty <code>c:</code></td>
<td>empty</td>
-<td><code>foo/</code></td>
+<td><code>c:foo/</code> <code>foo/</code></td>
<td><code>c:foo</code></td>
<td><code>.</code></td>
</tr>
<tr>
<td><code>c:/foo/</code></td>
-<td><code>c:,/,foo,.</code></td>
+<td><code>c:,foo,.</code> <code>c:,/,foo,.</code></td>
<td><code>c:/foo/</code></td>
<td><code>c:/foo/</code></td>
-<td><code>c:/</code></td>
-<td><code>c:</code></td>
-<td><code>/</code></td>
-<td><code>foo/</code></td>
+<td>empty <code>c:/</code></td>
+<td>empty <code>c:</code></td>
+<td>empty <code>/</code></td>
+<td><code>c:/foo/</code> <code>foo/</code></td>
<td><code>c:/foo</code></td>
<td><code>.</code></td>
</tr>
<tr>
<td><code>c:/foo/bar</code></td>
-<td><code>c:,/,foo,bar</code></td>
+<td><code>c:,foo,bar</code> <code>c:,/,foo,bar</code></td>
<td><code>c:/foo/bar</code></td>
<td><code>c:/foo/bar</code></td>
-<td><code>c:/</code></td>
-<td><code>c:</code></td>
-<td><code>/</code></td>
-<td><code>foo/bar</code></td>
+<td>empty <code>c:/</code></td>
+<td>empty <code>c:</code></td>
+<td>empty <code>/</code></td>
+<td><code>c:/foo/bar</code> <code>foo/bar</code></td>
<td><code>c:/foo</code></td>
<td><code>bar</code></td>
</tr>
@@ -2985,126 +2936,100 @@
<td><code>prn:</code></td>
<td><code>prn:</code></td>
<td><code>prn:</code></td>
-<td><code>prn:</code></td>
-<td><code>prn:</code></td>
-<td>empty</td>
+<td>empty <code>prn:</code></td>
+<td>empty <code>prn:</code></td>
<td>empty</td>
+<td><code>prn:</code> empty</td>
<td>empty</td>
<td><code>prn:</code></td>
</tr>
<tr>
<td><code>c:\</code></td>
-<td><code>c:,/</code></td>
+<td><code>c:\</code> <code>c:,/</code></td>
<td><code>c:\</code></td>
-<td><code>c:/</code></td>
-<td><code>c:\</code></td>
-<td><code>c:</code></td>
-<td><code>\</code></td>
-<td>empty</td>
-<td><code>c:</code></td>
-<td><code>\</code></td>
+<td><code>c:\</code> <code>c:/</code></td>
+<td>empty <code>c:\</code></td>
+<td>empty <code>c:</code></td>
+<td>empty <code>\</code></td>
+<td><code>c:\</code> empty</td>
+<td>empty <code>c:</code></td>
+<td><code>c:\</code> <code>\</code></td>
</tr>
<tr>
<td><code>c:foo</code></td>
-<td><code>c:,foo</code></td>
+<td><code>c:foo</code> <code>c:,foo</code></td>
<td><code>c:foo</code></td>
<td><code>c:foo</code></td>
-<td><code>c:</code></td>
-<td><code>c:</code></td>
+<td>empty <code>c:</code></td>
+<td>empty <code>c:</code></td>
<td>empty</td>
-<td><code>foo</code></td>
-<td><code>c:</code></td>
-<td><code>foo</code></td>
+<td><code>c:foo</code> <code>foo</code></td>
+<td>empty <code>c:</code></td>
+<td><code>c:foo</code> <code>foo</code></td>
</tr>
<tr>
<td><code>c:\foo</code></td>
-<td><code>c:,/,foo</code></td>
+<td><code>c:\foo</code> <code>c:,/,foo</code></td>
<td><code>c:\foo</code></td>
-<td><code>c:/foo</code></td>
-<td><code>c:\</code></td>
-<td><code>c:</code></td>
-<td><code>\</code></td>
-<td><code>foo</code></td>
-<td><code>c:\</code></td>
-<td><code>foo</code></td>
+<td><code>c:\foo</code> <code>c:/foo</code></td>
+<td>empty <code>c:\</code></td>
+<td>empty <code>c:</code></td>
+<td>empty <code>\</code></td>
+<td><code>c:\foo</code> <code>foo</code></td>
+<td>empty <code>c:\</code></td>
+<td><code>c:\foo</code> <code>foo</code></td>
</tr>
<tr>
<td><code>c:foo\</code></td>
-<td><code>c:,foo,.</code></td>
+<td><code>c:foo\</code> <code>c:,foo,.</code></td>
<td><code>c:foo\</code></td>
-<td><code>c:foo/</code></td>
-<td><code>c:</code></td>
-<td><code>c:</code></td>
-<td>empty</td>
-<td><code>foo\</code></td>
-<td><code>c:foo</code></td>
-<td><code>.</code></td>
+<td><code>c:foo\</code> <code>c:foo/</code></td>
+<td>empty <code>c:</code></td>
+<td>empty <code>c:</code></td>
+<td>empty</td>
+<td><code>c:foo\</code> <code>foo\</code></td>
+<td>empty <code>c:foo</code></td>
+<td><code>c:foo\</code> <code>.</code></td>
</tr>
<tr>
<td><code>c:\foo\</code></td>
-<td><code>c:,/,foo,.</code></td>
+<td><code>c:\foo\</code> <code>c:,/,foo,.</code></td>
<td><code>c:\foo\</code></td>
-<td><code>c:/foo/</code></td>
-<td><code>c:\</code></td>
-<td><code>c:</code></td>
-<td><code>\</code></td>
-<td><code>foo\</code></td>
-<td><code>c:\foo</code></td>
-<td><code>.</code></td>
+<td><code>c:\foo\</code> <code>c:/foo/</code></td>
+<td>empty <code>c:\</code></td>
+<td>empty <code>c:</code></td>
+<td>empty <code>\</code></td>
+<td><code>c:\foo\</code> <code>foo\</code></td>
+<td>empty <code>c:\foo</code></td>
+<td><code>c:\foo\</code> <code>.</code></td>
</tr>
<tr>
<td><code>c:\foo/</code></td>
-<td><code>c:,/,foo,.</code></td>
+<td><code>c:\foo,.</code> <code>c:,/,foo,.</code></td>
<td><code>c:\foo/</code></td>
-<td><code>c:/foo/</code></td>
-<td><code>c:\</code></td>
-<td><code>c:</code></td>
-<td><code>\</code></td>
-<td><code>foo/</code></td>
+<td><code>c:\foo/</code> <code>c:/foo/</code></td>
+<td>empty <code>c:\</code></td>
+<td>empty <code>c:</code></td>
+<td>empty <code>\</code></td>
+<td><code>c:\foo/</code> <code>foo/</code></td>
<td><code>c:\foo</code></td>
<td><code>.</code></td>
</tr>
<tr>
<td><code>c:/foo\bar</code></td>
-<td><code>c:,/,foo,bar</code></td>
+<td><code>c:,foo\bar</code> <code>c:,/,foo,bar</code></td>
<td><code>c:/foo\bar</code></td>
-<td><code>c:/foo/bar</code></td>
-<td><code>c:/</code></td>
-<td><code>c:</code></td>
-<td><code>/</code></td>
-<td><code>foo\bar</code></td>
-<td><code>c:/foo</code></td>
-<td><code>bar</code></td>
+<td><code>c:/foo\bar</code> <code>c:/foo/bar</code></td>
+<td>empty <code>c:/</code></td>
+<td>empty <code>c:</code></td>
+<td>empty <code>/</code></td>
+<td><code>c:/foo\bar</code> <code>foo\bar</code></td>
+<td><code>c:</code> <code>c:/foo</code></td>
+<td><code>foo\bar</code> <code>bar</code></td>
</tr>
</table>
-<h2><a name="Suggestions-for-fstream">Suggestions for <code><fstream></code></a>
-implementations</h2>
-The change in semantics to functions
-taking <code>const char*</code> arguments can break existing code, but only on
-operating systems where implementations don't implicitly accept native format pathnames or
-operating systems that allow slashes in filenames. Thus on POSIX,
-Windows, and OpenVMS, for example, there is no problem if the
-implementation follows encouraged behavior.
-For most of the Filesystem Library,
-there is no existing code, so the issue preserving existing code that uses
-slashes in filenames doesn't arise. New code simply must use path
-constructors with <code>path_format_t</code> arguments of <code>native</code>.
-To preserve existing fstream code that uses slashes in filenames, an
-implementation may wish to provide a mechanism such as a macro to control
-selection of the old behavior.
-Implementations are already required
-by the TR front-matter to provide a mechanism such as a macro to control
-selection of the old behavior (useful to guarantee protection of existing code)
-or new behavior (useful in new code, and code being ported from other systems)
-for headers. Because use of the rest of the Filesystem Library is independent of
-use of the <code><fstream></code> additions, affected implementations are
-encouraged to allow disabling the <code><fstream></code> additions separately
-from other TR features.
-An rejected alternative was to supply
-new fstream classes in namespace <code>filesystem</code>, inheriting from the current
-classes, overriding the constructors and opens taking pathname arguments, and
-providing the additional overloads. In Lillehammer LWG members indicated lack of
-support for this alternative, feeling that costs outweigh benefits.
+<table border="1" cellspacing="0" cellpadding="5" width="1066">
+</table>
<h2><a name="Acknowledgements">Acknowledgements</a></h2>
This Filesystem Library is dedicated to my wife, Sonda, who provided the
support necessary to see both a trial implementation and the proposal itself
@@ -3144,11 +3069,11 @@
 </tr>
</table>
<hr>
-ï¿½ Copyright Beman Dawes, 2002, 2006, 2007, 2009
+© Copyright Beman Dawes, 2002, 2006, 2007, 2009, 2010
Distributed under the Boost Software License, Version 1.0. See
<a href="http://www.boost.org/LICENSE_1_0.txt">www.boost.org/LICENSE_1_0.txt</a>
Revised
-03 March 2010
+05 March 2010

</body>

Next message: joel_at_[hidden]: "[Boost-commit] svn:boost r60190 - in trunk/libs/spirit: doc/qi test/qi"
Previous message: erwann.rogard_at_[hidden]: "[Boost-commit] svn:boost r60188 - sandbox/statistics/detail/assign/boost/assign/auto_size/detail"

Date view	Thread view	Subject view	Author view