Menu
▾
▴
[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
|
From: <bl...@us...> - 2003-05-10 15:17:35
|
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> </p>
--- 45,117 ----
</blockquote>
+ <h2 id="extension">extension</h2>
+
+ <blockquote>
+
+ <p><code>std::string extension( const path & 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> —
+ 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 & 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 & ph, const std::string & new_extension );</code></p>
+
+ <p><b>Postcondition:</b> <code>basename(return_value) == basename(ph)
+ && 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> </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>
</li>
- <li>Replace filesystem_error impl with shared_ptr. (Dave Abrahams).<br>
- </li>
- <li>Consider changing who()
- interface (and ctors to const char *).<br>
- </li>
<li>Add a path::swap member function guaranteed not to throw. (Geurt Vos).<br>
</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 ****
<p>The design evolved based on user requests to ease portability and
! internationalization.</p>
<h2><a name="Synopsis">Synopsis</a></h2>
--- 26,31 ----
<p>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.</p>
<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 & who() const;</pre>
! <p><b>Returns:</b> The <code>who</code> argument to the constructor.</p>
</blockquote>
--- 145,151 ----
<pre>const std::string & who() const;</pre>
! <p><b>Returns:</b> The <code>who</code> argument to the constructor. An
! implementation is permitted to return an empty string if an exception, for
! example, std::bad_alloc, occurs during processing.</p>
</blockquote>
***************
*** 142,146 ****
<p><b>Returns:</b> The <code>path1</code> argument to the constructor, if any,
! otherwise <code>path()</code>.</p>
</blockquote>
--- 155,161 ----
<p><b>Returns:</b> 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, occurs during
! processing.</p>
</blockquote>
***************
*** 150,154 ****
<p><b>Returns:</b> The <code>path2</code> argument to the constructor, if any,
! otherwise <code>path()</code>.</p>
</blockquote>
--- 165,171 ----
<p><b>Returns:</b> 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, occurs during
! processing.</p>
</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 ****
<p>A lengthy discussion on the C++ committee's library reflector illuminated the "illusion
! of portability" problem, particularly in postings by JP Plauger and Pete Becker.</p>
<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 ----
<p>A lengthy discussion on the C++ committee's library reflector illuminated the "illusion
! of portability" problem, particularly in postings by PJ Plauger and Pete Becker.</p>
<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>
|
