Boost logo

Boost :

Subject: Re: [boost] [filesystem] Horrible documentation
From: Edward Diener (eldiener_at_[hidden])
Date: 2016-03-31 13:19:58


On 3/31/2016 6:42 AM, Tatsuyuki Ishi wrote:
>> From: Edward Diener <eldiener_at_[hidden]>
>> Date: Wed, 30 Mar 2016 00:06:00 -0400
>> Subject: Re: [boost] [filesystem] Horrible documentation
>>
>> What sort of documentation unification with other libraries do you mean ?
>
> By saying unification, I'm talking about the green-background header. It's
> in most documentation and also on the homepage.

Which version of Boost are you using for viewing the filesystem docs ? I
noticed that for most library docs the green background header does not
exist. But you have brought up a good point that some library docs have
that green background header and some do not and that variance might
seem irregular to an end-user such as you. However each Boost library is
free to create its own documentation styles.

>
>> Can you not increase the font size, if it is too small for you to read,
> in your preferred browser since the doc is HTML ?
>
> The layout is quite problematic. Not only the font, text breaks border, and
> the page is too tall(long).

For me personally I find the filesystem docs very readable. Maybe if you
specify which HTML pages are giving you problems reading them and why
they are problems for you the filesystem library developer will address
your concerns.

>
> I noticed it's created with FrontPage 2002. Come on, this is 2016.

I did not create the docs. I am just asking about your problems with it.


Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk