Subject: Re: [boost] [random] new documentation
From: Rene Rivera (grafikrobot_at_[hidden])
Date: 2010-02-22 11:04:02
Joachim Faulhaber wrote:
> 2010/2/22 Steven Watanabe <watanabesj_at_[hidden]>
>> 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
>>> 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:
>>> 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.
>> I have the same problem in my reference section. E.g.
> If someone knew a trick for a better formatting result, I'd be very
Well the easy way would have been to change the wrapping with a
"white-space: pre-wrap" CSS style. But, when I tried that, it produces
rather bad rendering since those synopsis sections have white-space
"columns". So to really fix things someone first has to change the doc
generation to not use the rather bad white-space column format.
-- -- Grafik - Don't Assume Anything -- Redshift Software, Inc. - http://redshift-software.com -- rrivera/acm.org (msn) - grafik/redshift-software.com -- 102708583/icq - grafikrobot/aim,yahoo,skype,efnet,gmail
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk