Subject: Re: [boost] [doxygen] CSS/Temple files for Doxygen
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2011-07-10 06:18:03
> -----Original Message-----
> From: boost-bounces_at_[hidden] [mailto:boost-bounces_at_[hidden]] On Behalf Of Artyom
Beilis
> Sent: Saturday, July 09, 2011 8:50 PM
> To: boost_at_[hidden]
> Subject: Re: [boost] [doxygen] CSS/Temple files for Doxygen
>
>
>
> ----- Original Message ----
> > From: Paul A. Bristow <pbristow_at_[hidden]>
> <snip>
> To be honest...
>
> I prefer to use ONE too for projects I work on.
>
> With Doxygen I can generate both great tutorials and reference (in-source-code) documentation,
easily
> integrate them and what is most important to use ONE - SAME syntax.
>
> The only project using quickbook today is Boost. And it can't be really used outside the scope of
> Boost.Build.
>
> I don't develop for Boost only but rather have several different FOSS projects that use Doxygen
and none
> of them use Boost.Build.
>
> So instead of learning one more tool, create an entire toolchain of Doxyen/Quickbook/DocBook/HTML
I
> prefer to use one tool that can be easily integrated with CMake and easy to install.
>
> To be honest. I find Doxygen a very good tool for documenting software and I don't understand why
Boost
> hadn't adopted one... But this is other story.
>
> Finally I don't want to move to other tool especially when Boost does not enforce me. I'll keep
Doxygen
> as-is and maybe tweak CSS a little
OK, I can see I'm not going to persuade you :-)
But your Doxygen docs looks nice and are up to Boost standards.
(Have you thought of adding custom Doxygen html header/footers to make it look Boostier?)
Paul
PS
> BTW Doxygen knows to produce PDFs as well.
"PDF can be generated from the LaTeX output"
Have you done this for your docs? Boost PDF versions are popular.