On Fri, December 2, 2005 12:50 pm, Eric Wilhelm said:

> Now consider the more comprehensible, discoverable single tree under
> FF::
>
> FF::GBF - Front end to GBF read/write interface
> FF::GBF::Parser
> FF::GBF::Bytes
> FF::GBF::DOM
> FF::GBF::Constants
> FF::GBF::Writer
> FF::GBF::Simple
> FF::GBF::Writer::Stream
>
> Does that sound better?

It's better than the other examples, which doesn't mean it is good.  How
about FileFormat:: ?

FileFormat::GBF - Front end to GBF read/write interface
FileFormat::GBF::Parser
FileFormat::GBF::Bytes
FileFormat::GBF::DOM
FileFormat::GBF::Constants
FileFormat::GBF::Writer
FileFormat::GBF::Simple
FileFormat::GBF::Writer::Stream

Now you know just by looking at it what it means: GBF is a file format,
and we have a parser, writer, stream, etc. for that format.

Daniel T. Staal

---------------------------------------------------------------
This email copyright the author.  Unless otherwise noted, you
are expressly allowed to retransmit, quote, or otherwise use
the contents for non-commercial purposes.  This copyright will
expire 5 years after the author's death, or in 30 years,
whichever is longer, unless such a period is in excess of
local copyright law.
---------------------------------------------------------------

Reply via email to