|
Boost-Commit : |
From: bdawes_at_[hidden]
Date: 2008-03-18 15:52:59
Author: bemandawes
Date: 2008-03-18 15:52:58 EDT (Tue, 18 Mar 2008)
New Revision: 43710
URL: http://svn.boost.org/trac/boost/changeset/43710
Log:
Fix inspect boo boos; mostly broken links
Removed:
branches/release/libs/filesystem/example/vc++.bat
Text files modified:
branches/release/libs/filesystem/doc/do-list.htm | 5 +--
branches/release/libs/filesystem/doc/faq.htm | 8 -----
branches/release/libs/filesystem/doc/i18n.html | 32 ++++++++++++--------------
branches/release/libs/filesystem/doc/index.htm | 48 +++++++++++++++++++--------------------
branches/release/libs/filesystem/doc/reference.html | 7 ++---
branches/release/libs/filesystem/src/operations.cpp | 8 +++---
6 files changed, 48 insertions(+), 60 deletions(-)
Modified: branches/release/libs/filesystem/doc/do-list.htm
==============================================================================
--- branches/release/libs/filesystem/doc/do-list.htm (original)
+++ branches/release/libs/filesystem/doc/do-list.htm 2008-03-18 15:52:58 EDT (Tue, 18 Mar 2008)
@@ -4,8 +4,7 @@
Do-list</h1>
<h2>Current</h2>
<ul>
- <li>Add test cases and docs for Windows \\?\ and
- \\?\UNC\ naming conventions.</li>
+ <li>Add test cases and docs for Windows \\?\ and \\?\UNC\ naming conventions.</li>
<li>Should operations.cpp assert or BOOST_ASSERT on more preconditions?</li>
<li>Apply PJP's Wide/Narrow conversion proposal to traits, once he stabilizes it.</li>
<li>Glob syntax -> regex syntax converter. See
@@ -35,7 +34,7 @@
</ul>
<hr>
<p>Revised
-<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->06 February, 2006<!--webbot bot="Timestamp" endspan i-checksum="40411" --></p>
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->18 March, 2008<!--webbot bot="Timestamp" endspan i-checksum="29005" --></p>
<p>© Copyright Beman Dawes, 2002</p>
<p> Use, modification, and distribution are subject to the Boost Software
License, Version 1.0. (See accompanying file <a href="../../../LICENSE_1_0.txt">
Modified: branches/release/libs/filesystem/doc/faq.htm
==============================================================================
--- branches/release/libs/filesystem/doc/faq.htm (original)
+++ branches/release/libs/filesystem/doc/faq.htm 2008-03-18 15:52:58 EDT (Tue, 18 Mar 2008)
@@ -141,15 +141,9 @@
basic_path</i> member
functions, while operations performed by the operating system are provided as
free functions.</p>
-<p><b>Why is path normalized form different
-from canonical form?</b></p>
-<p>On operating systems such as POSIX which allow symbolic links to directories,
-the normalized form of a path can represent a different location than the
-canonical form. See use case
-from Walter Landry.</p>
<hr>
<p>Revised
-<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->08 November, 2007<!--webbot bot="Timestamp" endspan i-checksum="39371" --></p>
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->18 March, 2008<!--webbot bot="Timestamp" endspan i-checksum="29005" --></p>
<p>© Copyright Beman Dawes, 2002</p>
<p> Use, modification, and distribution are subject to the Boost Software
License, Version 1.0. See <a href="http://www.boost.org/LICENSE_1_0.txt">
Modified: branches/release/libs/filesystem/doc/i18n.html
==============================================================================
--- branches/release/libs/filesystem/doc/i18n.html (original)
+++ branches/release/libs/filesystem/doc/i18n.html 2008-03-18 15:52:58 EDT (Tue, 18 Mar 2008)
@@ -37,8 +37,7 @@
</li>
<li>More efficient operations when iterating over directories.<br>
</li>
- <li>A
- <a href="tr2_proposal.html#Class-template-basic_recursive_directory_iterator">recursive
+ <li>A <a href="reference.html#recursive_directory_iterator">recursive
directory iterator</a> is now provided. </li>
</ul>
<p>Rationale for some of the changes is also provided.</p>
@@ -68,10 +67,10 @@
file systems the <i>wpath</i> external encoding is <a href="design.htm#Kuhn">
UTF-8</a>, while for modern Windows file systems such as NTFS it is
<a href="http://en.wikipedia.org/wiki/UTF-16">UTF-16</a>.</p>
-<p>The operational functions in
+<p>The operational functions in
<a href="../../../boost/filesystem/operations.hpp">operations.hpp</a> are provided with overloads for
<i>path</i>, <i>wpath</i>, and user-defined <i>basic_path</i>'s. A
-"do-the-right-thing" rule
+"do-the-right-thing" rule
applies to implementations, ensuring that the correct overload will be chosen.</p>
<h2><a name="Simplification">Simplification</a> of path interface</h2>
<p>Prior versions of the library required users of class <i>path</i> to identify
@@ -90,11 +89,10 @@
it, but with much less impact on those who don't need it.</li>
</ul>
<p>Additionally,
-basic_filesystem_error has been put
+basic_filesystem_error has been put
on a diet and generally simplified.</p>
-<p>Error codes have been simplified and aligned with [POSIX-01]. A supporting
-header <a href="../../../boost/filesystem/cerrno.hpp">
-<boost/filesystem/cerrno.hpp></a> is also provided.</p>
+<p>Error codes have been moved to a separate library,
+Boost.System.</p>
<p><code>"//:"</code> has been introduced as a path escape prefix to identify
native paths. Rationale: simplifies basic_path constructor interfaces, easier
use for platforms needing explicit native format identification.</p>
@@ -112,19 +110,19 @@
<p>As part of the predicate discussions, particularly with Rob Stewart, it
became obvious that sometimes applications need access to raw status information
without any possibility of an exception being thrown. The
-status() function was added to meet this
+status() function was added to meet this
need. It also proved clearer to specify the semantics of predicate functions in
terms of status().</p>
<h3><a name="is_file">is_file</a>()</h3>
<p>About the same time, Jeff Garland suggested that an
-is_file() predicate would
-compliment is_directory(). In working on the analysis below, it became obvious
+is_file() predicate would
+compliment is_directory(). In working on the analysis below, it became obvious
that the expectations for is_file() were different from the expectations for !is_directory(),
so is_file() was added. </p>
<h3><a name="is_other">is_other</a>()</h3>
<p>On some operating systems, it is possible to have a directory entry which is
not for either a directory or a file. The
-is_other()
+is_other()
function identifies such cases.</p>
<h3>Should predicates throw on errors?</h3>
<p>Some conditions reported by operating systems as errors (see
@@ -132,7 +130,7 @@
false, rather than indicating serious failure. But other errors represent
serious hardware or network problems, or permissions problems.</p>
<p>Some people, particularly Rob Stewart, argue that in a function like
-is_directory(), any error should simply cause the function to return false. If
+is_directory(), any error should simply cause the function to return false. If
there is actually an underlying problem, it will be detected it due course when
a directory_iterator or fstream operation is attempted.</p>
<p>That view is was rejected because of the following considerations:</p>
@@ -390,7 +388,7 @@
the problem worse.<br>
</li>
</ul>
-<h3>No versions of status() which throw exceptions on
+<h3>No versions of status() which throw exceptions on
errors</h3>
<p>The rationale for not including versions of status()
which throw exceptions on errors is that (1) the primary purpose of this
@@ -398,7 +396,7 @@
unwanted, and (2) exceptions on errors are already provided by the predicate
functions. There would be little or no efficiency gain from providing a throwing
version of status().</p>
-<h3>Symlink identifying version of status() function</h3>
+<h3>Symlink identifying version of status() function</h3>
<p>A symlink identifying version of the status() function is distinguished by a
second argument. Often separately named functions are more appropriate than
overloading when behavior
@@ -417,8 +415,8 @@
is also provided, to meet unforeseen needs.</p>
<hr>
<p>Revised
-<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->03 June, 2007<!--webbot bot="Timestamp" endspan i-checksum="19946" --></p>
-<p>© Copyright Beman Dawes, 2005</p>
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->18 March, 2008<!--webbot bot="Timestamp" endspan i-checksum="29005" --></p>
+<p>© Copyright Beman Dawes, 2005</p>
<p>Distributed under the Boost Software License, Version 1.0.
(See accompanying file LICENSE_1_0.txt or
copy at www.boost.org/LICENSE_1_0.txt)</p>
Modified: branches/release/libs/filesystem/doc/index.htm
==============================================================================
--- branches/release/libs/filesystem/doc/index.htm (original)
+++ branches/release/libs/filesystem/doc/index.htm 2008-03-18 15:52:58 EDT (Tue, 18 Mar 2008)
@@ -128,12 +128,12 @@
using boost::filesystem; // for ease of tutorial presentation;
// a namespace alias is preferred practice in real code</pre>
</blockquote>
-<p>A class path object can be created:</p>
+<p>A class path object can be created:</p>
<blockquote>
<pre>path my_path( "some_dir/file.txt" );</pre>
</blockquote>
<p>The string passed to the <i>path</i> constructor may be in a
-portable generic path format or an
+portable generic path format or an
implementation-defined native operating system format. Access functions
make <i>my_path</i> contents available to the underlying operating system API in an operating system dependent format,
such as <code>"some_dir:file.txt"</code>, <code>"[some_dir]file.txt"</code>,
@@ -166,7 +166,7 @@
<p>Paths can include references to the current directory, using "<code>.</code>"
notation, and the parent directory, using "<code>..</code>"
notation.</p>
-<p>Class basic_directory_iterator
+<p>Class basic_directory_iterator
is an important component of the library. It provides an input iterator over the
contents of a directory, with the value type being class <i>basic_path</i>.
Typedefs <i>directory_iterator</i> and <i>wdirectory_iterator</i> are provided
@@ -227,7 +227,7 @@
<h4><b>Effects and Postconditions not guaranteed in the presence of race-conditions</b></h4>
<p>Filesystem function specifications follow the C++ Standard Library form, specifying behavior in terms of
effects and postconditions. If
-a race-condition exists, a function's
+a race-condition exists, a function's
postconditions may no longer be true by the time the function returns to the
caller.</p>
<blockquote>
@@ -259,7 +259,7 @@
</blockquote>
<h4><b>May throw exceptions</b></h4>
<p>Unless otherwise specified, Boost.Filesystem functions throw <i>
-basic_filesystem_error</i>
+basic_filesystem_error</i>
exceptions if they cannot successfully complete their operational
specifications. Also, implementations may use C++ Standard Library functions,
which may throw <i>std::bad_alloc</i>. These exceptions may be thrown even
@@ -292,10 +292,8 @@
<p>The programs used to generate the Boost regression test status tables use the
Filesystem Library extensively. See:</p>
<ul>
- <li><a href="../../../tools/regression/process_jam_log.cpp">
- process_jam_log.cpp</a></li>
- <li><a href="../../../tools/regression/compiler_status.cpp">
- compiler_status.cpp</a></li>
+ <li>process_jam_log.cpp</li>
+ <li>compiler_status.cpp</li>
</ul>
<p>Test programs are sometimes useful in understanding a library, as they
illustrate what the developer expected to work and not work. See:</p>
@@ -498,12 +496,12 @@
<li>Clearer specification, by reference to [POSIX-01],
the ISO/IEEE Single Unix Standard, with provisions for Windows and other
operating systems.</li>
- <li>New functions status,
- symlink_status,
- is_file,
- is_symlink,
- create_hard_link,
- create_symlink, path member and non-member swap, path inserter, path
+ <li>New functions status,
+ symlink_status,
+ is_file,
+ is_symlink,
+ create_hard_link,
+ create_symlink, path member and non-member swap, path inserter, path
extractor, additional path relational and "/" operator overloads, additional
path member template functions taking iterator arguments.</li>
<li>More efficient operations when iterating over directories.</li>
@@ -522,19 +520,19 @@
<h3>Version 1.32.0</h3>
<ul>
- <li>file_size() function added.</li>
- <li>Class path relational operators added.</li>
- <li>equivalent() function added.</li>
- <li>create_directory() no longer
+ <li>file_size() function added.</li>
+ <li>Class path relational operators added.</li>
+ <li>equivalent() function added.</li>
+ <li>create_directory() no longer
throws if the directory already exists. A bool is returned, indicating that
the directory did not preexist. Similar changes made to
- create_directories().</li>
+ create_directories().</li>
<li>Docs added for users wishing Cygwin/POSIX behavior
on Windows.</li>
<li>For POSIX, Large File Support (LSF) is enabled if available, such as on
Linux.</li>
- <li>current_path() and
- initial_path() on POSIX now handle
+ <li>current_path() and
+ initial_path() on POSIX now handle
very long paths correctly.</li>
</ul>
@@ -544,7 +542,7 @@
<li>The object library can now be built for either
static or dynamic (shared/dll) linking. </li>
<li>Several added functions, including improved checking for directory and
- file name portability. See <a href="portability_guide.htm#name_checkÂ_functions">
+ file name portability. See <a href="portability_guide.htm#name_checkÃÂ_functions">
Name check functions</a>.</li>
<li>Separation of canonical form and normalized form and a new path member
function normalize(). This changes behavior,
@@ -555,9 +553,9 @@
<hr>
<p>Revised
-<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->30 November, 2007<!--webbot bot="Timestamp" endspan i-checksum="39358" --></p>
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->18 March, 2008<!--webbot bot="Timestamp" endspan i-checksum="29005" --></p>
-<p>© Copyright Beman Dawes, 2002-2005</p>
+<p>© Copyright Beman Dawes, 2002-2005</p>
<p> Use, modification, and distribution are subject to 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>
Modified: branches/release/libs/filesystem/doc/reference.html
==============================================================================
--- branches/release/libs/filesystem/doc/reference.html (original)
+++ branches/release/libs/filesystem/doc/reference.html 2008-03-18 15:52:58 EDT (Tue, 18 Mar 2008)
@@ -343,7 +343,7 @@
template <class Path> class basic_recursive_directory_iterator;
- typedef basic_recursive_directory_iterator<path> recursive_directory_iterator;
+ typedef basic_recursive_directory_iterator<path> <a name="recursive_directory_iterator">recursive_directory_iterator</a>;
typedef basic_recursive_directory_iterator<wpath> wrecursive_directory_iterator;
enum file_type { status_unknown, file_not_found, regular_file, directory_file,
@@ -2260,8 +2260,7 @@
be <b>residue left over from a prior program</b> run by the command
processor! Although these semantics are often useful, they are also very
error-prone.</p>
- <p>See
- <a href="file:///C|/boost/site/libs/filesystem/doc/operations.htm#complete_note">
+ <p>See <a href="#complete_note">
<i>complete()</i> note</a> for usage suggestions. <i>-- end note</i>]</p>
</blockquote>
<h4><a name="Convenience-functions">Convenience functions</a></h4>
@@ -3058,7 +3057,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 -->14 November 2007<!--webbot bot="Timestamp" endspan i-checksum="40333" --></p>
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B %Y" startspan -->18 March 2008<!--webbot bot="Timestamp" endspan i-checksum="27357" --></p>
</body>
Deleted: branches/release/libs/filesystem/example/vc++.bat
==============================================================================
--- branches/release/libs/filesystem/example/vc++.bat 2008-03-18 15:52:58 EDT (Tue, 18 Mar 2008)
+++ (empty file)
@@ -1,5 +0,0 @@
-set BOOST_ROOT=..\..\..
-rem A more robust script would test for BOOST_ROOT already set in the environment.
-
-cl -EHsc -I%BOOST_ROOT% %* -link -LIBPATH:%BOOST_ROOT%\lib
-
Modified: branches/release/libs/filesystem/src/operations.cpp
==============================================================================
--- branches/release/libs/filesystem/src/operations.cpp (original)
+++ branches/release/libs/filesystem/src/operations.cpp 2008-03-18 15:52:58 EDT (Tue, 18 Mar 2008)
@@ -1319,12 +1319,12 @@
if ( result == 0 ) return dir_itr_close( handle, buffer );
target = entry->d_name;
# ifdef BOOST_FILESYSTEM_STATUS_CACHE
- if ( entry->d_type == DT_UNKNOWN ) // filesystem does not supply d_type value
+ if ( entry->d_type == DT_UNKNOWN ) // filesystem does not supply d_type value
{
sf = symlink_sf = fs::file_status(fs::status_unknown);
}
- else // filesystem supplies d_type value
- {
+ else // filesystem supplies d_type value
+ {
if ( entry->d_type == DT_DIR )
sf = symlink_sf = fs::file_status( fs::directory_file );
else if ( entry->d_type == DT_REG )
@@ -1335,7 +1335,7 @@
symlink_sf = fs::file_status( fs::symlink_file );
}
else sf = symlink_sf = fs::file_status( fs::status_unknown );
- }
+ }
# else
sf = symlink_sf = fs::file_status( fs::status_unknown );
# endif
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