[Cpptool-cvs] rfta/deplib/boostcvs/libs/filesystem/doc convenience.htm,1.1,1.2 do-list.htm,1.2,1.3 e

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/cpptool/rfta/deplib/boostcvs/libs/filesystem/doc
In directory sc8-pr-cvs1:/tmp/cvs-serv22050/libs/filesystem/doc

Modified Files:
	convenience.htm do-list.htm exception.htm index.htm 
Log Message:
* updated to the current boost cvs (2003/05/10)

Index: convenience.htm
===================================================================
RCS file: /cvsroot/cpptool/rfta/deplib/boostcvs/libs/filesystem/doc/convenience.htm,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** convenience.htm	5 Apr 2003 11:23:23 -0000	1.1
--- convenience.htm	10 May 2003 15:17:32 -0000	1.2
***************
*** 25,29 ****
  <dl class="index">
  <dt><a href="#create_directories">create_directories</a>
! </ol>

  <h2 id="create_directoies">create_directories</h2>
--- 25,32 ----
  <dl class="index">
  <dt><a href="#create_directories">create_directories</a>
! <dt><a href="#extension">extension</a>
! <dt><a href="#basename">basename</a>
! <dt><a href="#change_extension">change_extension</a>
! </dl>

  <h2 id="create_directoies">create_directories</h2>
***************
*** 42,49 ****
  </blockquote>

  <hr>
! <p>© Copyright Beman Dawes, 2002</p>
  <p>Revised
! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->23 December, 2002<!--webbot bot="Timestamp" endspan i-checksum="38510" --></p>
  <p>&nbsp;</p>

--- 45,117 ----
  </blockquote>

+ <h2 id="extension">extension</h2>
+ 
+ <blockquote>
+ 
+ <p><code>std::string extension( const path &amp; ph );</code></p>
+ 
+ <p><b>Returns:</b> if <code>ph.leaf()</code> contains a dot ('.'),
+ returns the substring of <code>ph.leaf()</code> starting from the last dot and
+ ending at the string's end. Otherwise, returns empty string.
+ <p><b>Rationale:</b> <ul>
+ <li>The dot is included in the return value so that it's
+ possible to tell if extension is empty or absent.
+ <li>It was noted that this defintion of extension is probably not sufficient
+ when using <a href="http://tinyurl.com/9tih">Alternate Data Streams</a> &mdash;
+ a filesystem feature specific to NTFS. However, semantic in this case was not
+ clear, and the current one is quite usefull still.
+ </ul>
+ <p><b>Acknowlegements:</b> Carl Daniel and Pavel Vozenilek noticed and
+ discussed the ADS issue.
+ 
+ <p>Contributed by Vladimir Prus.</p>
+ 
+ </blockquote>
+ 
+ <h2 id="basename">basename</h2>
+ 
+ <blockquote>
+ 
+ <p><code>std::string basename( const path &amp; ph );</code></p>
+ 
+ <p><b>Returns:</b> if <code>ph.leaf()</code> contains a dot ('.'),
+ returns the substring of <code>ph.leaf()</code> starting from beginning and
+ ending at the last dot (the dot is not included). Otherwise, returns 
+ <code>ph.leaf()</code>
+ 
+ </p>
+ 
+ <p>Contributed by Vladimir Prus.</p>
+ 
+ </blockquote>
+ 
+ <h2 id="change_extension">change_extension</h2>
+ 
+ <blockquote>
+ 
+ <p><code>path basename( const path &amp; ph, const std::string &amp; new_extension );</code></p>
+ 
+ <p><b>Postcondition:</b> <code>basename(return_value) == basename(ph)
+ &amp;&amp; extension(return_value) == new_extension</code>
+ <p><b>Note:</b> It follows from the semantic of <code>extension</code> that 
+ <code>new_extension</code> should include dot to achieve reasonable results.
+ </p>
+ <p><b>Rationale:</b> Previously, this functions had
+ <code>!ph.leaf().empty()</code> as precondition. It's not clear if it was
+ right or wrong. Changing extension of an empty path looks pointless. On the
+ other hand, the value of precondition was questionable: one would better place such
+ checks at the points where paths are entered by the user. Current decision
+ is to drop the precondition.</p>
+ 
+ <p>Contributed by Vladimir Prus.</p>
+ 
+ </blockquote>
+ 
+ 
+ 
  <hr>
! <p>© Copyright Vladimir Prus, 2003</p>
  <p>Revised
! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->5 May, 2003<!--webbot bot="Timestamp" endspan i-checksum="38510" --></p>
  <p>&nbsp;</p>

Index: do-list.htm
===================================================================
RCS file: /cvsroot/cpptool/rfta/deplib/boostcvs/libs/filesystem/doc/do-list.htm,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** do-list.htm	1 Apr 2003 08:25:45 -0000	1.2
--- do-list.htm	10 May 2003 15:17:32 -0000	1.3
***************
*** 10,18 ****
    and complete(). Also, path_test cases at line 410 need review, correction.<br>
  &nbsp;</li>
-   <li>Replace filesystem_error impl with shared_ptr. (Dave Abrahams).<br>
- &nbsp;</li>
-   <li>Consider changing who() 
-   interface (and ctors to const char *).<br>
- &nbsp;</li>
    <li>Add a path::swap member function guaranteed not to throw. (Geurt Vos).<br>
  &nbsp;</li>
--- 10,13 ----
***************
*** 44,46 ****
  <p>© Copyright Beman Dawes, 2002</p>
  <p>Revised
! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->17 March, 2003<!--webbot bot="Timestamp" endspan i-checksum="28843" --></p>
\ No newline at end of file
--- 39,41 ----
  <p>© Copyright Beman Dawes, 2002</p>
  <p>Revised
! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->23 March, 2003<!--webbot bot="Timestamp" endspan i-checksum="28836" --></p>
\ No newline at end of file

Index: exception.htm
===================================================================
RCS file: /cvsroot/cpptool/rfta/deplib/boostcvs/libs/filesystem/doc/exception.htm,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** exception.htm	1 Apr 2003 08:25:45 -0000	1.2
--- exception.htm	10 May 2003 15:17:32 -0000	1.3
***************
*** 26,30 ****

The design evolved based on user requests to ease portability and 
! internationalization.

  <h2><a name="Synopsis">Synopsis</a></h2>
--- 26,31 ----

The design evolved based on user requests to ease portability and 
! internationalization. See the Boost <a href="../../../more/error_handling.html">
! Error and Exception Handling</a> guidelines.

  <h2><a name="Synopsis">Synopsis</a></h2>
***************
*** 54,58 ****
      };

!     class filesystem_error : public std::runtime_error
      {
      public:
--- 55,59 ----
      };

!     class filesystem_error : public std::exception
      {
      public:
***************
*** 73,76 ****
--- 74,79 ----
        ~filesystem_error() throw();

+       virtual const char * what() const throw();
+ 
        <i>sys_err</i> <a href="#native_error">native_error</a>() const;
        error_code <a href="#error">error</a>() const;
***************
*** 115,118 ****
--- 118,129 ----
    <p><b>Effects:</b> Constructs a <i>filesystem_error</i> object.</p>
  </blockquote>
+ <h3><a name="what">what</a></h3>
+ <blockquote>
+ <p><code>virtual const char * what() const throw();</code></p>
+ <p><b>Returns:</b> A string identifying the error, including who(), path1(), 
+ path2(), and related messages. If an error occurs in the preparation of the 
+ string, particularly in low-memory situations, an implementation is permitted to 
+ return a simpler static string.</p>
+ </blockquote>
  <h3><a name="native_error">native_error</a></h3>
  <blockquote>
***************
*** 134,138 ****
    <pre>const std::string &amp; who() const;</pre>

! Returns: The <code>who</code> argument to the constructor.
 </blockquote>

--- 145,151 ----
    <pre>const std::string &amp; who() const;</pre>

! Returns: The <code>who</code> argument to the constructor. An 
! implementation is permitted to return an empty string if an exception, for 
! example,&nbsp; std::bad_alloc,&nbsp; occurs during processing.
 </blockquote>

***************
*** 142,146 ****

Returns: The <code>path1</code> argument to the constructor, if any, 
! otherwise <code>path()</code>.
 </blockquote>

--- 155,161 ----

Returns: The <code>path1</code> argument to the constructor, if any, 
! otherwise <code>path()</code>. An implementation is permitted to return an empty 
! path if an exception, for example, std::bad_alloc,&nbsp; occurs during 
! processing.
 </blockquote>

***************
*** 150,154 ****

Returns: The <code>path2</code> argument to the constructor, if any, 
! otherwise <code>path()</code>.
 </blockquote>

--- 165,171 ----

Returns: The <code>path2</code> argument to the constructor, if any, 
! otherwise <code>path()</code>. An implementation is permitted to return an empty 
! path if an exception, for example, std::bad_alloc,&nbsp; occurs during 
! processing.
 </blockquote>

***************
*** 160,164 ****
  <p>© Copyright Beman Dawes, 2002</p>
  <p>Revised
! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->02 January, 2003<!--webbot bot="Timestamp" endspan i-checksum="38568" --></p>

  </body>
--- 177,181 ----
  <p>© Copyright Beman Dawes, 2002</p>
  <p>Revised
! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->23 March, 2003<!--webbot bot="Timestamp" endspan i-checksum="28836" --></p>

  </body>

Index: index.htm
===================================================================
RCS file: /cvsroot/cpptool/rfta/deplib/boostcvs/libs/filesystem/doc/index.htm,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** index.htm	1 Apr 2003 08:25:46 -0000	1.2
--- index.htm	10 May 2003 15:17:32 -0000	1.3
***************
*** 428,437 ****

A lengthy discussion on the C++ committee's library reflector illuminated the &quot;illusion 
! of portability&quot; problem, particularly in postings by JP Plauger and Pete Becker.

  <hr>
  <p>© Copyright Beman Dawes, 2002</p>
  <p>Revised
! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->16 March, 2003<!--webbot bot="Timestamp" endspan i-checksum="28841" --></p>

  </body>
--- 428,437 ----

A lengthy discussion on the C++ committee's library reflector illuminated the &quot;illusion 
! of portability&quot; problem, particularly in postings by PJ Plauger and Pete Becker.

  <hr>
  <p>© Copyright Beman Dawes, 2002</p>
  <p>Revised
! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->08 April, 2003<!--webbot bot="Timestamp" endspan i-checksum="29884" --></p>

  </body>

[Cpptool-cvs] rfta/deplib/boostcvs/libs/filesystem/doc convenience.htm,1.1,1.2 do-list.htm,1.2,1.3 e

[Cpptool-cvs] rfta/deplib/boostcvs/libs/filesystem/doc convenience.htm,1.1,1.2 do-list.htm,1.2,1.3 exception.htm,1.2,1.3 index.htm,1.2,1.3