From: Beman Dawes (bdawes_at_[hidden])
Date: 2008-05-20 09:17:10
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
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk