Subject: Re: [Boost-docs] ReST: inconsistent style?
From: David Abrahams (dave_at_[hidden])
Date: 2008-02-04 20:15:29
on Fri Feb 01 2008, Rene Rivera <grafikrobot-AT-gmail.com> wrote:
> David Abrahams wrote:
>> and http://beta.boost.org/doc/libs/1_34_1/libs/python/doc/building.html
>> are both generated from ReST sources. The former uses the style I have
>> come to understand is the agreed-upon Boost documentation style. The
>> latter seems to use something else. I prefer the former, and took pains
>> to ensure that both documents presented that way on the old site... but
>> regardless of that, why the inconsistency?
> Because the default for library docs presentation on the beta web site
> does post-processing to make the style conform to the style of the web
seems to indicate it's being a little too aggressive. Puting
class="pre" stuff in all-caps seems like a mistake.
> And the "more/*" happens to be outside of the default for
Not sure what that last part means.
> We can disable the post-processing on a case by case basis.
> Oh, and the TOC showing as it does on the latter is a bug. It shouldn't
> have the "NOTE" wrapper around it. And in the former the ReST style
> doesn't seem to set the background color, yet from the logo it seems to
> assume a white background.
What would I need to do to fix that assumption?
-- Dave Abrahams Boost Consulting http://boost-consulting.com
This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:40 UTC