Re: [boost] [Documentation] Does Boost-Build support Doxygen documentation for tutorials (rather then quickbook)

Subject: Re: [boost] [Documentation] Does Boost-Build support Doxygen documentation for tutorials (rather then quickbook)
From: Steven Watanabe (watanabesj_at_[hidden])
Date: 2010-12-13 10:37:07

AMDG

On 12/13/2010 7:26 AM, Daniel James wrote:
> We do use straight doxygen documentation in at least on place:
>
> http://www.boost.org/doc/libs/1_45_0/libs/gil/doc/index.html
>
> To create boost documentation, you don't have to use boost build, but
> you do have to make it reasonably easy for others to generate the
> documentation. In GIL's case, it uses shell scripts, which isn't ideal
> for windows users. Also, be aware that doxygen can generate long file
> names which don't meet our requirements. GIL uses a script to rename
> them (although there are some broken links, I haven't looked into why
> that is, I don't really know doxygen).
>
> I think boost build's doxygen support is tailored for boostbook, but
> it would be nice to be able to use it for other purposes. I'm not sure
> what that would be involved, you might want to ask on the build list.

Boost.Build will generate html from doxygen
if the target name ends with ".html".

In Christ,
Steven Watanabe