David Abrahams wrote:

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?

Both the doc and tutorial could stand improvement. I've created ticket #1937 Thanks, --Beman