Boost C++ Libraries: Ticket #5422: declval Documentation Text Too Small

Steven Watanabe — Wed, 06 Apr 2011 20:16:45 GMT

If you're referring to http://www.boost.org/doc/libs/1_46_1/libs/utility/doc/html/declval.html, I'm not seeing that it's any different. It's using the same stylesheet, too.

Thu, 07 Apr 2011 11:04:31 GMT

I am referring to that page. Compare the Overview text with that at http://www.boost.org/doc/libs/1_46_1/libs/utility/ or http://www.boost.org/doc/libs/1_46_1/libs/utility/assert.html, for example. It is quite different. The latter two, it appears, don't specify the face or size of the text, so they appear as I expected. The former overrides my browser settings and renders the text very small (approximately 60% normal size).

Investigating the page source, I see that declval.html uses boostbook.css and assert.html does not. For comparison, I compared against http://www.boost.org/. That page appears to use another stylesheet, but renders like declval.html. Therefore, my complaint would appear to be against the formatting of assert.html, http://www.boost.org/doc/libs/1_46_1/libs/utility/, and any others like them. The dramatic size difference among those pages is disturbing as making one suitably readable makes the other much too large or too small.

Should I apply formatting complaints against the pages that don't look like declval.html, then?

Steven Watanabe — Thu, 07 Apr 2011 14:18:14 GMT

Maybe we should take this to the mailing list. I'd like to see if anyone else has anything to say before I start applying widespread formatting changes.

Steven Watanabe — Thu, 07 Apr 2011 14:24:04 GMT

Of course, the real solution is to use quickbook for everything. :)

status changed; resolution set

viboes — Sun, 03 Jun 2012 19:52:48 GMT

status new → closed
resolution → worksforme

Please, create another ticket, may be for Boost documentation as the style sheets are common.