Re: [boost] [filesystem] "implementation defined"

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

Thanks,

--Beman