Re: [Boost-docs] FW: [Doxygen-announce] Doxygen version 1.7.3 released

Subject: Re: [Boost-docs] FW: [Doxygen-announce] Doxygen version 1.7.3 released
From: Daniel James (dnljms_at_[hidden])
Date: 2011-01-21 22:10:09

On 20 January 2011 14:41, Paul A. Bristow <pbristow_at_[hidden]> wrote:
>
> But I think the more important ugliness is the too-big size of the
> description like " public construct/copy/destruct" etc bit
>
> for example:
>
> <h3>
> <a name="close_toconstruct-copy-destruct"></a><code
> class="computeroutput">close_to</code>
>        public  construct/copy/destruct</h3>  << why is this h3 and not
> smaller?

'h3' is the correct header type for its location in the document
(since 'Description' is a h2). It would be better to resize it using
css than by changing the header type.

> While you are at it, I have a violent objection to the syntax colouring - I
> *need* comments in green ;-)
>
> So the idea of a single boostbook.css isn't working right for me.

Feel free to propose a new stylesheet for the doc/src directory. For example:

doc/src/boostbook-green.css:

    @import url(boostbook.css)
    .comment { color: green; }
    .refentry h3 { font-size: 1.1em; }

In your jamfile:

    <xsl:param>html.stylesheet=../../../../doc/src/boostbook-green.css

Daniel