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

Subject: Re: [Boost-docs] [Boost-build] Strange warning when building docuimentation
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2011-02-18 10:34:40

> -----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?

http://www.stack.nl/~dimitri/doxygen/commands.html#cmdgt

which says
"
\<

This command writes the < character to the output. This character has to be
escaped because it has a special meaning in HTML.

"
It also lists the many others that will get you (and have got me)  into
trouble if you innocently use them  ;-)

Paul

---
Paul A. Bristow,
Prizet Farmhouse, Kendal LA8 8AB  UK
[phone]  07714330204
pbristow_at_[hidden]