[boost] [filesystem] "implementation defined"

From: David Abrahams (dave_at_[hidden])
Date: 2008-05-19 17:57:27

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