Re: [Boost-docs] [Boost-build] Strange warning when building docuimentation

Subject: Re: [Boost-docs] [Boost-build] Strange warning when building docuimentation
From: Edward Diener (eldiener_at_[hidden])
Date: 2011-02-18 14:31:25

On 2/18/2011 5:34 AM, Paul A. Bristow wrote:
>
>
>> -----Original Message-----
>> From: Steven Watanabe [mailto:watanabesj_at_[hidden]]
>> Sent: Wednesday, February 09, 2011 6:17 PM
>> To: Boost.Build developer's and user's list
>> Subject: Re: [Boost-build] Strange warning when building docuimentation
>>
>> AMDG
>>
>> On 2/9/2011 10:00 AM, Edward Diener wrote:
>>> When building documentation within a quickbook, boostbook, doxygen
>>> chain, I am getting this message:
>>>
>>> warning: Unsupported xml/html tag<_>  found
>>>
>>> from some doxygen documentation I have which reads:
>>>
>>> "The easiest way to generate the lambda expression is to use a Boost
>>> MPL placeholder expression of the form 'metafunction<_>'"
>>>
>>> In the build the message comes in this sequence (leaving out many
>>> extra
>>> lines):
>>>
>>> "doxygen-action ...
>>>
>>> <snip>
>>> ...
>>> finished...
>>>
>>
> C:/Programming/VersionControl/sandbox/tti/boost/tti/TTIntrospection.hpp:123
>> 9:
>>> warning: Unsupported xml/html tag<_>  found xslt-xsltproc.windows
>>>
>>> Anybody have any ideas why the sequence '<_>' in a doxygen detail
>>> block is producing these warnings, and which documentation building
>>> tool is giving the warning ? I thought it might be doxygen but that
>>> 'finished...' line in the bjam output makes me think it is something
> else.
>>>
>>
>> It's doxygen.  Everything after doxygen-action up to the next action is
> the output
>> of doxygen.  You can get around this by using @c metafunction<_>.  Using
> &lt;
>> probably works too.
>
> Probably using \<  and \>  works too?

Yes, that is what I ended up doing. I had forgot that one's doxygen 
comments can be HTML and of course < and > is part of HTML syntax.