Boost logo

Boost-Commit :

From: bdawes_at_[hidden]
Date: 2008-03-18 15:35:19


Author: bemandawes
Date: 2008-03-18 15:35:18 EDT (Tue, 18 Mar 2008)
New Revision: 43709
URL: http://svn.boost.org/trac/boost/changeset/43709

Log:
Fix inspect boo boos; mostly broken links
Removed:
   trunk/libs/filesystem/example/vc++.bat
Text files modified:
   trunk/libs/filesystem/doc/do-list.htm | 5 +--
   trunk/libs/filesystem/doc/faq.htm | 8 -----
   trunk/libs/filesystem/doc/i18n.html | 32 ++++++++++++--------------
   trunk/libs/filesystem/doc/index.htm | 48 +++++++++++++++++++--------------------
   trunk/libs/filesystem/doc/reference.html | 7 ++---
   trunk/libs/filesystem/src/operations.cpp | 8 +++---
   6 files changed, 48 insertions(+), 60 deletions(-)

Modified: trunk/libs/filesystem/doc/do-list.htm
==============================================================================
--- trunk/libs/filesystem/doc/do-list.htm (original)
+++ trunk/libs/filesystem/doc/do-list.htm 2008-03-18 15:35:18 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 -&gt; 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: trunk/libs/filesystem/doc/faq.htm
==============================================================================
--- trunk/libs/filesystem/doc/faq.htm (original)
+++ trunk/libs/filesystem/doc/faq.htm 2008-03-18 15:35:18 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: trunk/libs/filesystem/doc/i18n.html
==============================================================================
--- trunk/libs/filesystem/doc/i18n.html (original)
+++ trunk/libs/filesystem/doc/i18n.html 2008-03-18 15:35:18 EDT (Tue, 18 Mar 2008)
@@ -37,8 +37,7 @@
 &nbsp;</li>
   <li>More efficient operations when iterating over directories.<br>
 &nbsp;</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">
-&lt;boost/filesystem/cerrno.hpp&gt;</a> is also provided.</p>
+<p>Error codes have been moved to a separate library,
+Boost.System.</p>
 <p><code>&quot;//:&quot;</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>
 &nbsp;</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: trunk/libs/filesystem/doc/index.htm
==============================================================================
--- trunk/libs/filesystem/doc/index.htm (original)
+++ trunk/libs/filesystem/doc/index.htm 2008-03-18 15:35:18 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( &quot;some_dir/file.txt&quot; );</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>&quot;some_dir:file.txt&quot;</code>, <code>&quot;[some_dir]file.txt&quot;</code>,
@@ -166,7 +166,7 @@
 <p>Paths can include references to the current directory, using &quot;<code>.</code>&quot;
 notation, and the parent directory, using &quot;<code>..</code>&quot;
 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.&nbsp; 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 &quot;/&quot; 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: trunk/libs/filesystem/doc/reference.html
==============================================================================
--- trunk/libs/filesystem/doc/reference.html (original)
+++ trunk/libs/filesystem/doc/reference.html 2008-03-18 15:35:18 EDT (Tue, 18 Mar 2008)
@@ -343,7 +343,7 @@
 
       template &lt;class Path&gt; class basic_recursive_directory_iterator;
 
- typedef basic_recursive_directory_iterator&lt;path&gt; recursive_directory_iterator;
+ typedef basic_recursive_directory_iterator&lt;path&gt; <a name="recursive_directory_iterator">recursive_directory_iterator</a>;
       typedef basic_recursive_directory_iterator&lt;wpath&gt; 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: trunk/libs/filesystem/example/vc++.bat
==============================================================================
--- trunk/libs/filesystem/example/vc++.bat 2008-03-18 15:35:18 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: trunk/libs/filesystem/src/operations.cpp
==============================================================================
--- trunk/libs/filesystem/src/operations.cpp (original)
+++ trunk/libs/filesystem/src/operations.cpp 2008-03-18 15:35:18 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