Opened 12 years ago

Closed 10 years ago

#5422 closed Bugs (worksforme)

declval Documentation Text Too Small

Reported by: Rob Stewart <robert.stewart@…> Owned by: No-Maintainer
Milestone: To Be Determined Component: utility
Version: Boost 1.46.1 Severity: Cosmetic
Keywords: Cc:

Description

The text, apparently copied from a proposal, is really small compared to other Boost documentation.

Change History (5)

comment:1 by Steven Watanabe, 12 years ago

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.

comment:2 by Rob Stewart <robert.stewart@…>, 12 years ago

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?

comment:3 by Steven Watanabe, 12 years ago

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.

comment:4 by Steven Watanabe, 12 years ago

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

comment:5 by viboes, 10 years ago

Resolution: worksforme
Status: newclosed

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

Note: See TracTickets for help on using tickets.