Re: [boost] [docbook] Add detail namespace to Reference section

On August 16, 2014 10:06:05 AM EDT, Benedek Thaler wrote:

On Sat, Aug 16, 2014 at 4:00 PM, Rob Stewart wrote:

...

I don't know how to make it appear, but the real question is why you would want to document an implementation detail.

As shown in the example, the class to be documented is lifted to the public namespace. Real code: https://github.com/erenon/pipeline/blob/master/include/boost/pipeline/type_e...

It can't be in the public namespace because related operators are in the detail namespace which also serve other classes in the that namespace.

If you're lifting them into the public namespace, they aren't implementation details. Choose another name for the namespace with those identifiers and keep only implementation details in the detail namespace. ___ Rob (Sent from my portable computation engine)