Re: [boost] [random] new documentation

Subject: Re: [boost] [random] new documentation
From: Steven Watanabe (watanabesj_at_[hidden])
Date: 2010-02-22 10:00:51

AMDG

John Maddock wrote:
>> This is hopefully the final version of the work I did back in November
>> to convert the Random docs to Quickbook/Doxygen/Boostbook.
>> I've uploaded the generated documentation to
>> http://www.cs.hmc.edu/~swatanabe/random_doc/libs/random/doc/html/
>
> Steven, I've only scanned those docs a little but this looks really 
> good: much better than the old documentation!
>
> One thing I did notice were some very long lines in the reference 
> section, for example: 
> http://www.cs.hmc.edu/~swatanabe/random_doc/libs/random/doc/html/boost/taus88.html 
>
>
> These are verging on the unreadable in HTML, but will just get 
> truncated in PDF output :-(
>
> I suspect though that this is Doxygen mangling the formatting?

Yep.  You mentioned this before, but I couldn't find a way
to force it to be formatted properly.  The best I can think of
would be to get rid of the long type name and change it to
something like

typedef xor_combine<...> taus88;

for doxygen builds.

In Christ,
Steven Watanabe