[RFC] Header/namespace policy draft
Joel de Guzman <joel <at> boost-consulting.com>
2007-12-01 04:47:40 GMT
Hi,
As promised, here's a draft of the proposed
"Boost Header And Namespace Policy" (attached)
Comments, suggestions, etc. very welcome.
Regards,
--
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net
Boost Header And Namespace Policy
There has been an unwritten standard practice on header placement and
namespaces that has been developed over the years. The Boost policy
gives library authors a huge amount of freedom to organize and evolve
their libraries as they see fit. Authors of newer libraries, however,
had to try and figure out from the way existing libraries are
structured or ask help from fellow boosters with more boost experience
in "boostifying" their code. With very few exceptions, this worked
well in the past. Library authors stayed within the bounds of the
standard practice. Yet, with the rate Boost is growing, it would be
crucial to put the Boost standard practice in writing to avoid
confusion in the future.
This short document will attempt to formalize the Boost standard
practice on header placement, subdirectory and library organization,
and namespace conventions. One purpose of the review process is to
(Continue reading)