|
|
Boost-Commit : |
Subject: [Boost-commit] svn:boost r62428 - trunk/libs/filesystem/v3/libs/filesystem/doc
From: bdawes_at_[hidden]
Date: 2010-06-04 12:17:32
Author: bemandawes
Date: 2010-06-04 12:17:31 EDT (Fri, 04 Jun 2010)
New Revision: 62428
URL: http://svn.boost.org/trac/boost/changeset/62428
Log:
Clarify docs driven by comments from Daniel James.
Text files modified:
trunk/libs/filesystem/v3/libs/filesystem/doc/deprecated.html | 318 +++++++++++++++++++++++++++++----------
trunk/libs/filesystem/v3/libs/filesystem/doc/index.htm | 12
trunk/libs/filesystem/v3/libs/filesystem/doc/reference.html | 19 +-
trunk/libs/filesystem/v3/libs/filesystem/doc/tutorial.html | 50 +----
trunk/libs/filesystem/v3/libs/filesystem/doc/v3.html | 25 ++
5 files changed, 277 insertions(+), 147 deletions(-)
Modified: trunk/libs/filesystem/v3/libs/filesystem/doc/deprecated.html
==============================================================================
--- trunk/libs/filesystem/v3/libs/filesystem/doc/deprecated.html (original)
+++ trunk/libs/filesystem/v3/libs/filesystem/doc/deprecated.html 2010-06-04 12:17:31 EDT (Fri, 04 Jun 2010)
@@ -38,165 +38,309 @@
<h2><a name="Deprecated-names">Deprecated names</a> and features</h2>
<p style="font-size: 10pt">As the library evolves over time, names sometimes
-change or features are removed. To ease transition, Boost.Filesystem deprecates
-the old names and features, but continues to provide them unless macro <code>
+change or old features are removed to make way for new features. To ease transition, Boost.Filesystem deprecates
+the old names and features, but by default continues to provide many of them.
+The deprecated names and other workarounds can be suppressed by defining macro <code>
+BOOST_FILESYSTEM_NO_DEPRECATED</code>, and this is recommended for all new code.</p>
+<p style="font-size: 10pt">In the table, ✔ indicates a synonym or other
+workaround is provide unless <code>
BOOST_FILESYSTEM_NO_DEPRECATED</code> is defined.</p>
<table border="1" cellpadding="5" cellspacing="1" style="border-collapse: collapse" bordercolor="#111111">
<tr>
- <td style="font-size: 10pt">
- <b><i>Component</i></b></td>
- <td style="font-size: 10pt">
+ <td style="font-size: 10pt" valign="top">
+ <b><i>Component or location</i></b></td>
+ <td style="font-size: 10pt" valign="top">
<p style="font-size: 10pt"><b><i>Old name, now deprecated</i></b></td>
- <td style="font-size: 10pt">
+ <td style="font-size: 10pt" valign="top">
+ ✔</td>
+ <td style="font-size: 10pt" valign="top">
<p style="font-size: 10pt"><b><i>New name</i></b></td>
</tr>
<tr>
- <td style="font-size: 10pt" valign="top"><code>basic_path</code></td>
- <td style="font-size: 10pt"><code>leaf()</code></td>
- <td style="font-size: 10pt"><code>filename()</code></td>
+ <td style="font-size: 10pt" valign="top"><code>class path</code></td>
+ <td style="font-size: 10pt" valign="top"><code>branch_path()</code></td>
+ <td style="font-size: 10pt" valign="top">✔</td>
+ <td style="font-size: 10pt" valign="top"><code>parent_path()</code></td>
</tr>
<tr>
- <td style="font-size: 10pt" valign="top"><code>basic_path</code></td>
- <td style="font-size: 10pt"><code>branch_path()</code></td>
- <td style="font-size: 10pt"><code>parent_path()</code></td>
+ <td style="font-size: 10pt" valign="top">
+ <code>class path</code></td>
+ <td style="font-size: 10pt" valign="top">
+ <code>canonize()</code></td>
+ <td style="font-size: 10pt" valign="top">
+ </td>
+ <td style="font-size: 10pt" valign="top">
+ <i>Function removed</i></td>
</tr>
<tr>
- <td style="font-size: 10pt" valign="top"><code>basic_path</code></td>
- <td style="font-size: 10pt"><code>has_leaf()</code></td>
- <td style="font-size: 10pt"><code>has_filename()</code></td>
+ <td style="font-size: 10pt" valign="top">
+ <code>class path</code></td>
+ <td style="font-size: 10pt" valign="top">
+ <code>default_name_check()</code></td>
+ <td style="font-size: 10pt" valign="top">
+ ✔</td>
+ <td style="font-size: 10pt" valign="top">
+ <i>Function removed</i></td>
</tr>
<tr>
- <td style="font-size: 10pt" valign="top"><code>basic_path</code></td>
- <td style="font-size: 10pt"><code>has_branch_path()</code></td>
- <td style="font-size: 10pt"><code>has_parent_path()</code></td>
+ <td style="font-size: 10pt" valign="top">
+ <code>class path</code></td>
+ <td style="font-size: 10pt" valign="top">
+ <code>default_name_check(name_check)</code></td>
+ <td style="font-size: 10pt" valign="top">
+ ✔</td>
+ <td style="font-size: 10pt" valign="top">
+ <i>Function removed</i></td>
</tr>
<tr>
<td style="font-size: 10pt" valign="top">
- <code>basic_path</code></td>
- <td style="font-size: 10pt">
- <p style="font-size: 10pt"><code>remove_leaf()</code></td>
- <td style="font-size: 10pt">
- <p style="font-size: 10pt"><code>remove_filename()</code></td>
+ <code>class path</code></td>
+ <td style="font-size: 10pt" valign="top">
+ <code>default_name_check_writable()</code></td>
+ <td style="font-size: 10pt" valign="top">
+ ✔</td>
+ <td style="font-size: 10pt" valign="top">
+ <i>Function removed</i></td>
</tr>
<tr>
- <td style="font-size: 10pt" valign="top">
- <code>basic_path</code></td>
- <td style="font-size: 10pt">
- <code>basic_path( const string_type & str,<br>
- name_check )</code></td>
- <td style="font-size: 10pt">
- <i><code>feature removed</code></i></td>
+ <td style="font-size: 10pt" valign="top"><code>class path</code></td>
+ <td style="font-size: 10pt" valign="top"><code>directory_string()</code></td>
+ <td style="font-size: 10pt" valign="top">✔</td>
+ <td style="font-size: 10pt" valign="top"><code>string</code></td>
+ </tr>
+ <tr>
+ <td style="font-size: 10pt" valign="top"><code>class path</code></td>
+ <td style="font-size: 10pt" valign="top"><code>external_directory_string()</code></td>
+ <td style="font-size: 10pt" valign="top">✔</td>
+ <td style="font-size: 10pt" valign="top"><code>native()</code></td>
+ </tr>
+ <tr>
+ <td style="font-size: 10pt" valign="top"><code>class path</code></td>
+ <td style="font-size: 10pt" valign="top"><code>external_file_string()</code></td>
+ <td style="font-size: 10pt" valign="top">✔</td>
+ <td style="font-size: 10pt" valign="top"><code>native()</code></td>
+ </tr>
+ <tr>
+ <td style="font-size: 10pt" valign="top"><code>class path</code></td>
+ <td style="font-size: 10pt" valign="top"><code>file_string()</code></td>
+ <td style="font-size: 10pt" valign="top">✔</td>
+ <td style="font-size: 10pt" valign="top"><code>string()</code></td>
+ </tr>
+ <tr>
+ <td style="font-size: 10pt" valign="top"><code>class path</code></td>
+ <td style="font-size: 10pt" valign="top"><code>has_branch_path()</code></td>
+ <td style="font-size: 10pt" valign="top">✔</td>
+ <td style="font-size: 10pt" valign="top"><code>has_parent_path()</code></td>
+ </tr>
+ <tr>
+ <td style="font-size: 10pt" valign="top"><code>class path</code></td>
+ <td style="font-size: 10pt" valign="top"><code>has_leaf()</code></td>
+ <td style="font-size: 10pt" valign="top">✔</td>
+ <td style="font-size: 10pt" valign="top"><code>has_filename()</code></td>
+ </tr>
+ <tr>
+ <td style="font-size: 10pt" valign="top"><code>class path</code></td>
+ <td style="font-size: 10pt" valign="top"><code>is_complere()</code></td>
+ <td style="font-size: 10pt" valign="top">✔</td>
+ <td style="font-size: 10pt" valign="top"><code>is_absolute()</code></td>
</tr>
<tr>
+ <td style="font-size: 10pt" valign="top"><code>class path</code></td>
+ <td style="font-size: 10pt" valign="top"><code>leaf()</code></td>
+ <td style="font-size: 10pt" valign="top">✔</td>
+ <td style="font-size: 10pt" valign="top"><code>filename()</code></td>
+ </tr>
+ <tr>
+ <td style="font-size: 10pt" valign="top">
+ <code>class path</code></td>
+ <td style="font-size: 10pt" valign="top">
+ <code>native_directory_string()</code></td>
<td style="font-size: 10pt" valign="top">
- <code>basic_path</code></td>
- <td style="font-size: 10pt">
- <code>basic_path( const string_type::value_type * s,<br>
- name_check )</code></td>
- <td style="font-size: 10pt">
- <i><code>feature removed</code></i></td>
+ ✔</td>
+ <td style="font-size: 10pt" valign="top">
+ <code>string()</code></td>
</tr>
<tr>
<td style="font-size: 10pt" valign="top">
- <code>basic_path</code></td>
- <td style="font-size: 10pt">
+ <code>class path</code></td>
+ <td style="font-size: 10pt" valign="top">
<code>native_file_string()</code></td>
- <td style="font-size: 10pt">
- <code>file_string()</code></td>
+ <td style="font-size: 10pt" valign="top">
+ ✔</td>
+ <td style="font-size: 10pt" valign="top">
+ <code>string()</code></td>
</tr>
<tr>
<td style="font-size: 10pt" valign="top">
- <code>basic_path</code></td>
- <td style="font-size: 10pt">
- <code>native_directory_string()</code></td>
- <td style="font-size: 10pt">
- <code>directory_string()</code></td>
+ <code>class path</code></td>
+ <td style="font-size: 10pt" valign="top">
+ <code>normalize()</code></td>
+ <td style="font-size: 10pt" valign="top">
+ ✔</td>
+ <td style="font-size: 10pt" valign="top">
+ <i>Function removed</i></td>
</tr>
<tr>
<td style="font-size: 10pt" valign="top">
- <code>basic_path</code></td>
- <td style="font-size: 10pt">
- <code>default_name_check_writable()</code></td>
- <td style="font-size: 10pt">
- <i><code>feature removed</code></i></td>
+ <code>class path</code></td>
+ <td style="font-size: 10pt" valign="top">
+ <code>path(const string_type& str, name_check)</code></td>
+ <td style="font-size: 10pt" valign="top">
+ ✔</td>
+ <td style="font-size: 10pt" valign="top">
+ <i>Function removed. Workaround ignores </i><code>name_check</code><i>
+ argument.</i></td>
</tr>
<tr>
<td style="font-size: 10pt" valign="top">
- <code>basic_path</code></td>
- <td style="font-size: 10pt">
- <code>default_name_check( name_check )</code></td>
- <td style="font-size: 10pt">
- <i><code>feature removed</code></i></td>
+ <code>class path</code></td>
+ <td style="font-size: 10pt" valign="top">
+ <code>path(const string_type::value_type* s, name_check)</code></td>
+ <td style="font-size: 10pt" valign="top">
+ ✔</td>
+ <td style="font-size: 10pt" valign="top">
+ <i>Function removed. Workaround ignores </i><code>name_check</code><i>
+ argument.</i></td>
</tr>
<tr>
<td style="font-size: 10pt" valign="top">
- <code>basic_path</code></td>
- <td style="font-size: 10pt">
- <code>default_name_check()</code></td>
- <td style="font-size: 10pt">
- <i><code>feature removed</code></i></td>
+ <code>class path</code></td>
+ <td style="font-size: 10pt" valign="top">
+ <p style="font-size: 10pt"><code>remove_leaf()</code></td>
+ <td style="font-size: 10pt" valign="top">
+ ✔</td>
+ <td style="font-size: 10pt" valign="top">
+ <p style="font-size: 10pt"><code>remove_filename()</code></td>
</tr>
<tr>
<td style="font-size: 10pt" valign="top">
- <code>basic_path</code></td>
- <td style="font-size: 10pt">
- <code>canonize()</code></td>
- <td style="font-size: 10pt">
- <i><code>feature removed</code></i></td>
+ <code>path.hpp</code></td>
+ <td style="font-size: 10pt" valign="top">
+ <code>template<class String, class Traits><br>
+ class basic_path;</code></td>
+ <td style="font-size: 10pt" valign="top">
+ </td>
+ <td style="font-size: 10pt" valign="top">
+ Class template <code>basic_path</code> is replaced by <code>class path</code>.
+ No workaround for an explicitly coded <code>basic_path</code> is provided,
+ but see the next row - <code>path</code>.</td>
</tr>
<tr>
<td style="font-size: 10pt" valign="top">
- <code>basic_path</code></td>
- <td style="font-size: 10pt">
- <code>normalize()</code></td>
- <td style="font-size: 10pt">
- <i><code>feature removed</code></i></td>
+ <code>path.hpp</code></td>
+ <td style="font-size: 10pt" valign="top">
+ <code>typedef basic_path<std::string, path_traits> path;</code></td>
+ <td style="font-size: 10pt" valign="top">
+ ✔</td>
+ <td style="font-size: 10pt" valign="top">
+ <code>class path</code></td>
+ </tr>
+ <tr>
+ <td style="font-size: 10pt" valign="top">
+ <code>path.hpp</code></td>
+ <td style="font-size: 10pt" valign="top">
+ <code>typedef basic_path<std::wstring, wpath_traits> wpath;</code></td>
+ <td style="font-size: 10pt" valign="top">
+ ✔</td>
+ <td style="font-size: 10pt" valign="top">
+ <i>Removed; use </i><code>class path</code><i> instead. Workaround provides
+ </i><code>typedef path wpath;</code></td>
</tr>
<tr>
<td style="font-size: 10pt" valign="top">
<code>operations.hpp</code></td>
- <td style="font-size: 10pt">
- <code>is_regular( file_status f )</code></td>
- <td style="font-size: 10pt">
+ <td style="font-size: 10pt" valign="top">
+ <code>is_regular(file_status f)</code></td>
+ <td style="font-size: 10pt" valign="top">
+ ✔</td>
+ <td style="font-size: 10pt" valign="top">
<code>is_regular_file( file_status f )</code></td>
</tr>
<tr>
<td style="font-size: 10pt" valign="top">
<code>operations.hpp</code></td>
- <td style="font-size: 10pt">
- <code>symbolic_link_exists( const path & ph )</code></td>
- <td style="font-size: 10pt">
- <i><code>feature removed</code></i></td>
+ <td style="font-size: 10pt" valign="top">
+ <code>symbolic_link_exists(const path& ph)</code></td>
+ <td style="font-size: 10pt" valign="top">
+ </td>
+ <td style="font-size: 10pt" valign="top">
+ <i>Function removed</i></td>
</tr>
<tr>
<td style="font-size: 10pt" valign="top">
<code>basic_directory_status</code></td>
- <td style="font-size: 10pt">
+ <td style="font-size: 10pt" valign="top">
<code>filename()</code></td>
- <td style="font-size: 10pt">
- <i><code>feature removed, use path().filename() instead</code></i></td>
+ <td style="font-size: 10pt" valign="top">
+ </td>
+ <td style="font-size: 10pt" valign="top">
+ <i>Function removed, use </i><code>path().filename()</code><i> instead.</i></td>
</tr>
<tr>
<td style="font-size: 10pt" valign="top">
<code>basic_directory_status</code></td>
- <td style="font-size: 10pt">
+ <td style="font-size: 10pt" valign="top">
<code>leaf()</code></td>
- <td style="font-size: 10pt">
- <i><code>feature removed, use path().filename() instead</code></i></td>
+ <td style="font-size: 10pt" valign="top">
+ </td>
+ <td style="font-size: 10pt" valign="top">
+ <i>Function removed, use </i><code>path().filename()</code><i> instead.</i></td>
</tr>
<tr>
<td style="font-size: 10pt" valign="top">
<code>basic_directory_status</code></td>
- <td style="font-size: 10pt">
+ <td style="font-size: 10pt" valign="top">
<code>string()</code></td>
- <td style="font-size: 10pt">
- <i><code>feature removed, use path().string() instead</code></i></td>
+ <td style="font-size: 10pt" valign="top">
+ </td>
+ <td style="font-size: 10pt" valign="top">
+ <i>Function removed, use </i><code>path().filename()</code><i> instead.</i></td>
+ </tr>
+ <tr>
+ <td style="font-size: 10pt" valign="top">
+ Macro definitions</td>
+ <td style="font-size: 10pt" valign="top">
+ <code>BOOST_WINDOW_API</code></td>
+ <td style="font-size: 10pt" valign="top">
+ </td>
+ <td style="font-size: 10pt" valign="top">
+ <i>No longer supported; API selection is always automatic.</i></td>
+ </tr>
+ <tr>
+ <td style="font-size: 10pt" valign="top">
+ Macro definitions</td>
+ <td style="font-size: 10pt" valign="top">
+ <code>BOOST_POSIX_API</code></td>
+ <td style="font-size: 10pt" valign="top">
+ </td>
+ <td style="font-size: 10pt" valign="top">
+ <i>No longer supported; API selection is always automatic.</i></td>
+ </tr>
+ <tr>
+ <td style="font-size: 10pt" valign="top">
+ Macro definitions</td>
+ <td style="font-size: 10pt" valign="top">
+ <code>BOOST_WINDOW_PATH</code></td>
+ <td style="font-size: 10pt" valign="top">
+ </td>
+ <td style="font-size: 10pt" valign="top">
+ <i>No longer supported; native path format selection is always automatic.</i></td>
+ </tr>
+ <tr>
+ <td style="font-size: 10pt" valign="top">
+ Macro definitions</td>
+ <td style="font-size: 10pt" valign="top">
+ <code>BOOST_POSIX_PATH</code></td>
+ <td style="font-size: 10pt" valign="top">
+ </td>
+ <td style="font-size: 10pt" valign="top">
+ <i>No longer supported; native path format selection is always automatic.</i></td>
</tr>
</table>
<hr>
<p>Revised
-<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->17 February, 2010<!--webbot bot="Timestamp" endspan i-checksum="40536" --></p>
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->04 June, 2010<!--webbot bot="Timestamp" endspan i-checksum="19844" --></p>
<p>© Copyright Beman Dawes, 2002-2005, 2010</p>
<p> Use, modification, and distribution are subject to the Boost Software
Modified: trunk/libs/filesystem/v3/libs/filesystem/doc/index.htm
==============================================================================
--- trunk/libs/filesystem/v3/libs/filesystem/doc/index.htm (original)
+++ trunk/libs/filesystem/v3/libs/filesystem/doc/index.htm 2010-06-04 12:17:31 EDT (Fri, 04 Jun 2010)
@@ -309,15 +309,17 @@
Compilation</a> page for a description of the techniques used.</p>
<h3>Note for <a name="Cgywin">Cygwin</a> users</h3>
<p> Cygwin version 1.7 or later is
-required. Only later versions of GCC with wide character strings are supported.
-The library's implementation code treats Cygwin as a Windows platform, and thus
-uses the Windows API.</p>
+required because only versions of GCC with wide character strings are supported.</p>
+
+<p> The library's implementation code treats Cygwin as a Windows platform, and
+thus uses the Windows API and uses Windows path syntax as the native path
+syntax.</p>
<h2><a name="Change-history">Version history</a></h2>
<h3>Version 3</h3>
-<p>Boost 1.??.0 - ???, 2010 - Internationalization via single class <code>path</code>.
+<p>Boost <span style="background-color: #FFFF00">1.??.0 - ???, 2010</span> - Internationalization via single class <code>path</code>.
More uniform error handling.</p>
<p>Peter Dimov suggested use of a single path class rather than a <code>basic_path</code>
@@ -450,7 +452,7 @@
<hr>
<p>Revised
-<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->01 June, 2010<!--webbot bot="Timestamp" endspan i-checksum="19838" --></p>
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->04 June, 2010<!--webbot bot="Timestamp" endspan i-checksum="19844" --></p>
<p>© Copyright Beman Dawes, 2002-2005</p>
<p> Use, modification, and distribution are subject to the Boost Software
Modified: trunk/libs/filesystem/v3/libs/filesystem/doc/reference.html
==============================================================================
--- trunk/libs/filesystem/v3/libs/filesystem/doc/reference.html (original)
+++ trunk/libs/filesystem/v3/libs/filesystem/doc/reference.html 2010-06-04 12:17:31 EDT (Fri, 04 Jun 2010)
@@ -156,9 +156,10 @@
identifies a file. The format is implementation defined. </p>
<blockquote>
<p><i>[Note:</i> For POSIX-like implementations, including<b> </b>Unix
- variants, Linux, and Cygwin, only paths
+ variants, Linux, and Mac OS X, only paths
that begin with a slash are absolute paths.</p>
- <p>For Windows-like implementations, including Windows and
+ <p>For Windows-like implementations, including <a href="http://www.cygwin.com/">
+ Cygwin</a> and
<a href="http://www.mingw.org/">MinGW</a>, only paths that begin with a drive
specifier followed by a slash, or begin with two slashes, are absolute paths. <i>--end
note]</i></p>
@@ -593,10 +594,10 @@
character type used by the implementation to represent pathnames.</p>
<blockquote>
<p><i>[Note:</i> For POSIX-like implementations, including<b> </b>Unixes, Linux,
-and
- Cygwin, <code>path::value_type</code>
+and Mac OS X, <code>path::value_type</code>
is <code>char</code> .</p>
-<p>For Windows-like implementations, including Windows and
+<p>For Windows-like implementations, including
+ Cygwin and
<a href="http://www.mingw.org/">MinGW</a>, <code>path::value_type</code> is <code>
wchar_t</code>. <i>--end note]</i></p>
</blockquote>
@@ -717,10 +718,10 @@
directory separator is implementation-defined.</p>
<blockquote>
<p align="left">[<i>Note: </i>For POSIX-like implementations, including<b> </b>
- Unix variants, Linux, and
- Cygwin, the preferred directory separator is a
+ Unix variants, Linux, and Mac OS X, the preferred directory separator is a
single forward slash.</p>
- <p align="left">For Windows-like implementations, including Windows and
+ <p align="left">For Windows-like implementations, including
+ Cygwin and
<a href="http://www.mingw.org/">MinGW</a>, the preferred directory
separator is a single backslash.<i>--end note</i>]</p>
</blockquote>
@@ -3073,7 +3074,7 @@
<p>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></p>
<p>Revised
-<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B %Y" startspan -->05 March 2010<!--webbot bot="Timestamp" endspan i-checksum="27230" --></p>
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B %Y" startspan -->04 June 2010<!--webbot bot="Timestamp" endspan i-checksum="17550" --></p>
</body>
Modified: trunk/libs/filesystem/v3/libs/filesystem/doc/tutorial.html
==============================================================================
--- trunk/libs/filesystem/v3/libs/filesystem/doc/tutorial.html (original)
+++ trunk/libs/filesystem/v3/libs/filesystem/doc/tutorial.html 2010-06-04 12:17:31 EDT (Fri, 04 Jun 2010)
@@ -810,49 +810,21 @@
<p dir="ltr">The <b>native format</b> is the format as defined by the particular
operating system. For Windows, either the slash or the backslash can be used as
-the directory separator character. If a drive specifier or a backslash appears
-in a pathname on a Windows system, it is always treated as the native format.</p>
-
-<p dir="ltr">We can use <code>tut4</code> to explore the two formats:</p>
-
- <table align="center" border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#111111" bgcolor="#D7EEFF" width="90%">
- <tr>
- <td align="center" width="50%" style="font-size: 10pt"><i><b>Ubuntu Linux </b></i></td>
- <td align="center" style="font-size: 10pt"><i><b>Microsoft Windows</b></i></td>
- </tr>
- <tr>
- <td width="50%" style="font-size: 10pt" valign="top">
- <pre>$ ./tut4 tut4.cpp
-tut4.cpp: 1920
+the directory separator character, so <code>/my_directory\my_file.txt</code>
+would work fine. Of course, if you write that in a C++ string literal, it
+becomes <code>"/my_directory\\my_file.txt"</code>.</p>
-$ ./tut4 ./tut4.cpp
-./tut4.cpp: 1920
-
-$ ./tut4 .\tut4.cpp
-.tut4.cpp: does not exist
-
-$ ./tut4 .\\tut4.cpp
-.\tut4.cpp: does not exist</pre>
- </td>
- <td style="font-size: 10pt" valign="top">
- <pre>>tut4 tut4.cpp
-tut4.cpp: 1984
-
->tut4 ./tut4.cpp
-./tut4.cpp: 1984
-
->tut4 .\tut4.cpp
-.\tut4.cpp: 1984
+<p dir="ltr">If a drive specifier or a backslash appears
+in a pathname on a Windows system, it is always treated as the native format.</p>
->tut4 .\\tut4.cpp
-.\\tut4.cpp: 1984</pre>
- </td>
- </tr>
- </table>
+<p dir="ltr">Class <code>path</code> has observer functions that allow you to
+obtain the string representation of a path object in either the native format
+or the generic format. See the next section
+for how that plays out.</p>
<p>The distinction between generic format and native format is important when
communicating with native C-style API's and with users. Both tend to expect
- paths in the native format and are confused by the generic format. The generic
+ paths in the native format and may be confused by the generic format. The generic
format is great, however, for writing portable programs that work regardless
of operating system.</p>
@@ -1149,7 +1121,7 @@
<p>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></p>
<p>Revised
-<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B %Y" startspan -->02 March 2010<!--webbot bot="Timestamp" endspan i-checksum="27224" --></p>
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B %Y" startspan -->04 June 2010<!--webbot bot="Timestamp" endspan i-checksum="17550" --></p>
</body>
Modified: trunk/libs/filesystem/v3/libs/filesystem/doc/v3.html
==============================================================================
--- trunk/libs/filesystem/v3/libs/filesystem/doc/v3.html (original)
+++ trunk/libs/filesystem/v3/libs/filesystem/doc/v3.html 2010-06-04 12:17:31 EDT (Fri, 04 Jun 2010)
@@ -82,10 +82,14 @@
</li>
<li>A new Tutorial provides a hopefully much
gentler and more complete introduction for new users. Current users might want
- to review the three sections related to class path.<br>
- </li>
+ to review the three sections related to class path.</li>
</ul>
+<h2>Deprecated names and other features</h2>
+
+<p>See the Deprecated Features page for transition
+aids that allow much existing code to compile without change using Version 3.</p>
+
<h2>Breaking changes</h2>
<p>To ease the transition, Versions 2 and 3 will both be included in the next
@@ -93,14 +97,16 @@
cycle, and then Version 3 will become the default version.</p>
<h3>Class <code>path</code></h3>
<ul>
- <li>Class template <code>basic_path</code> and its specializations are gone.</li>
+ <li>Class template <code>basic_path</code> and its specializations are gone.<br>
+ </li>
<li>Certain functions now return <code>path</code> objects rather than <code>
basic_string</code> objects:<ul>
<li><code>root_name()</code></li>
<li><code>root_directory()</code></li>
<li><code>filename()</code></li>
<li><code>stem()</code></li>
- <li><code>extension()</code></li>
+ <li><code>extension()<br>
+ </code></li>
</ul>
</li>
<li> <code>path::iterator::value_type</code> and <code>
@@ -110,10 +116,15 @@
<h3>Compiler support</h3>
<ul>
<li>Compilers and standard libraries that do not fully support wide characters
- and wide character strings (<code>wstring</code>) are no longer supported.
- This impacts primarily Cygwin users; versions prior to 1.7 are no longer
+ and wide character strings (<code>std::wstring</code>) are no longer
supported.<br>
</li>
+ <li>Cygwin versions prior to 1.7 are no longer supported because they lack
+ wide string support. Cygwin now compiles only for the Windows API and path
+ syntax.<br>
+ </li>
+ <li>MinGW versions not supporting wide strings are no longer supported.<br>
+ </li>
<li>Microsoft VC++ 7.1 and earlier are no longer supported.</li>
</ul>
@@ -122,7 +133,7 @@
<p>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></p>
<p>Revised
-<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B %Y" startspan -->22 February 2010<!--webbot bot="Timestamp" endspan i-checksum="40543" --></p>
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B %Y" startspan -->04 June 2010<!--webbot bot="Timestamp" endspan i-checksum="17550" --></p>
</body>
Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk