Re: [Boost-docs] [stylesheet] forced upcasing of titles

Subject: Re: [Boost-docs] [stylesheet] forced upcasing of titles
From: Rene Rivera (grafikrobot_at_[hidden])
Date: 2008-04-01 16:48:19

David Abrahams wrote:
> It worries me that C++ identifiers appearing in section titles come out
> as ALL_CAPS with the new documentation stylesheet. This one is fairly
> innocuous
> (
> but other cases could easily be really confusing.
> Is the stylistic advantage of small-caps section titles worth the
> potential confusion?

Good question. I think the small-caps are useful overall. But I can see
how it would be confusing in this case. Would a compromise of not
showing the #include part of the heading as small-caps work? It would
generically be showing any "pre" or "tt" within a header as-is.

-- Grafik - Don't Assume Anything
-- Redshift Software, Inc. -
-- rrivera/ (msn) - grafik/
-- 102708583/icq - grafikrobot/aim,yahoo,skype,efnet,gmail

This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:40 UTC