Subject: [Boost-docs] some doc nits
From: Eric Niebler (eric_at_[hidden])
Date: 2010-06-12 05:58:36
On 6/12/2010 1:56 AM, Eric Niebler wrote:
> My messages to this list are bouncing for some reason.
Wow, strange. OK, here's the original:
Just some doc nits, for anyone with the time, interest and xslt chops.
There's a problem with how the xslt is dealing with <purpose> elements
for classes. See the synopsis I just generated for a class with two
There's a lot that has gone wrong here. It seems whitespace matters when
it probably shouldn't. Lines aren't broken sensibly, and when they are,
they aren't preceded by // to indicate they're a comment. Perhaps this
is my bad for writing a <purpose> that doesn't fit on one line, but that
doesn't seem like an unreasonable thing to do.
Also notice how some comments don't get syntax highlighted, like the 3
occurrences of "// types" and "// public member functions".
And as I've pointed out before, code that started out as a
<programlisting> (e.g. the Example in the description) doesn't get
highlighted at all.
The source xml for this page can be found here:
Finally, I noticed a strange CSS thing with free functions. See this page:
Notice that the identifier for the deep_copy function is actually a
link, but is not colored like a link. Odd.
These docs were generated from trunk just now.
-- Eric Niebler BoostPro Computing http://www.boostpro.com
This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC