[boost] boost/filesystem/directory.hpp attached for comment

From: Beman Dawes (bdawes_at_[hidden])
Date: 2002-03-20 10:25:42

Attached (hopefully) is boost/filesystem/directory.hpp

Please remember that this header is only part of the picture; there will 
additional headers (dealing with paths, attributes/properties, and 
exceptions) in a complete filesystem library.

Right now, the only documentation is supplied as comments in the header 
code.  Once the header is stable, I'll move the specifications to an HTML 
document.

There are a number of comments in the code which begin "TODO".  These often 
represent uncertainties; I'd appreciate opinions on how to deal with these.

There are a number of comments in the code which begin "Rationale" that try 
to explain why various decisions were made.  Of course these are in the 
context of the design document: 
http://groups.yahoo.com/group/boost/files/filesystem/filesystem_library_design.htm 
If you disagree with any of the decisions, I'd appreciate rationale for 
alternatives.

I have a Win32 implementation; once the header is stable perhaps someone 
else would like to contribute a POSIX implementation.

Comments would be appreciated.  And of course, thanks to everyone who 
provided comments leading to the current design.

--Beman