Re: [Boost-bugs] [Boost C++ Libraries] #1014: rename throws an exception that is not documented

Subject: Re: [Boost-bugs] [Boost C++ Libraries] #1014: rename throws an exception that is not documented
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2007-08-27 23:34:51

#1014: rename throws an exception that is not documented
-----------------------------+----------------------------------------------
  Reporter:  anonymous       |       Owner:  bemandawes
      Type:  Bugs            |      Status:  closed    
 Milestone:                  |   Component:  filesystem
   Version:  release 1.34.0  |    Severity:  Problem   
Resolution:  invalid         |    Keywords:            
-----------------------------+----------------------------------------------
Changes (by bemandawes):

  * status:  new => closed
  * resolution:  => invalid

Comment:

 It is documented in the 'requirements on implementations' section, which
 says:

 Implementations of functions described in this clause are permitted to
 call the applications program interface (API) provided by the operating
 system. If such an operating system API call results in an error,
 implementations shall report the error by throwing exception
 basic_filesystem_error, unless otherwise specified.

     [Note: Such exceptions and the conditions that cause them to be thrown
 are not explicitly described in each Throws element within this clause.
 Because hardware failures, network failures, race conditions, and a
 plethora of other errors occur frequently in file system operations, users
 should be aware that unless otherwise specified any file system operation,
 not matter how apparently innocuous, may throw an exception. -- end note]

 --Beman

-- 
Ticket URL: <http://svn.boost.org/trac/boost/ticket/1014#comment:2>
Boost C++ Libraries <http://www.boost.org/>
Boost provides free peer-reviewed portable C++ source libraries.