Re: [boost] Tool maintenance

On 5/27/2021 1:52 AM, Glen Fernandes via Boost wrote:

On Wed, May 26, 2021 at 7:02 PM Edward Diener via Boost wrote:

...

On 5/26/2021 3:41 PM, Andrey Semashev via Boost wrote:

...

If you add "xsl:paramboost.doxygen.detailns=aux" to the "doxygen example_reference" rule requirements, along with other doxygen:param tags, the example_value appears in the output. Here, "aux" is the detail namespace name you want to hide.

Thank you very much, Andrey. I am not intending to criticize Daniel James but evidently his idea of documentation for BoostBook on the level of xsl parameters was "read the source". I am, however, really happy that you figured it out.

All of that (including the detail namespace hiding feature) was implemented by Doug (Gregor) 18 years ago. Many years before Daniel started contributing to it.

OK, my bad. A problem is that what was done is just not documented anywhere that I can see as far as the various BoostBook xsl options are concerned. It should not be necessary to read source files to understand how a library or a tool works.