Re: Tool maintenance

From: Edward Diener (eldiener_at_[hidden])
Date: 2021-05-27 10:11:09

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
> <boost_at_[hidden]> wrote:
>>
>> On 5/26/2021 3:41 PM, Andrey Semashev via Boost wrote:
>>> If you add "<xsl:param>boost.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.