Rene Rivera wrote:
Eric Niebler wrote:
"The variablelist is similar to an HTML definition list. It is used
when you have a list of terms and definitions."
Well I guess if I knew enough DocBook I would have known that ;-) I
understand now... I was looking at this from the HTML/XHTML POV.
So ... are you unhappy with the way they're rendered in the CSS? Do
you have a better suggestion? Care to submit a patch?
Very unhappy. I won't bother with a patch now. Instead here's what I
have in mind:
<http://boost.redshift-software.com/development/exemplar.html> The list
of markup styles (Heading 4) is a classic definition list. And for
comparison... Current:
<http://www.boost.org/doc/html/InputIterator.html>
Classic:
<http://boost.redshift-software.com/doc/release/doc/html/InputIterator.html>
Without the forced italic style, and column like spacing, one can see
the style for of the "term" itself (bold in the later, but I just
noticed that and I might remove the bold). If that is more to peoples
liking I can go change the CSS directly.
I hate to flog this dead horse, but I'm still not overjoyed with what we
have for variable lists in the CSS. In particular, I think it makes
Doxygen-generated reference docs ugly and take up more vertical space
than necessary.
I found an XSL parameter which formats variablelists as tables, and I
generated xpressive's docs with it. I also hacked our XSL transforms and
boostbook.css to support it.
This is before the change:
http://tinyurl.com/ho2a3
This is after the change:
http://tinyurl.com/fh43h
Look at the Parameters/Requires/Throws/Returns at the bottom to see the
difference. I was motivated by the fop stylesheets which produces PDFs
with beautiful table-like layouts for variable lists.
My changes to the XSL transforms and the CSS are non-intrusive -- I can
commit them if others are interested. Then, to get the table-like
layout, people can just put <xsl:param>variablelist.as.table=1 in their
Jamfiles.
Opinions?
--
Eric Niebler
Boost Consulting
www.boost-consulting.com
-------------------------------------------------------
This SF.Net email is sponsored by xPML, a groundbreaking scripting language
that extends applications into web and mobile media. Attend the live webcast
and join the prime developer group breaking into this new coding territory!
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=110944&bid=241720&dat=121642
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
