id	summary	reporter	owner	description	type	status	milestone	component	version	severity	resolution	keywords	cc
1937	Boost.Filesystem documentation and tutorial needs	Beman Dawes	Beman Dawes	"The documentation for Boost.Filesystem uses the phrase ""implementation
defined"" in at least one place without subsequently defining whatever it
is (see the pathname grammar).  Since these docs have to describe a
particular implementation and not just be a prototype for
standardization, don't we need to fill in the details?

I also wonder if adhering to the standard documentation form for
reference materials really makes this library accessible enough for
general use.  Even understanding the first example program (""simple ls"")
requires me to read through a great deal of reference material to
understand what's going on.  Maybe that just means a more complete
tutorial is needed?

-- Dave Abrahams BoostPro Computing http://www.boostpro.com "	Tasks	closed	Boost 1.36.0	filesystem	Boost 1.35.0	Problem	fixed