Rene Rivera wrote:
Eric Niebler wrote:
Rene Rivera wrote:
Instead I have a simple question. With your changes; How would I get
a regular definition list?
If you don't want definition lists tabularized, simply don't put
<xsl:param>variablelist.as.table=1 in your Jamfile.
OK, I can see why you would misinterpret my question :-\ How would I go
about having both tabular variable lists and regular definition lists in
one document? I think I know the answer, but I'm not certain so I ask.
And I'm asking because I think it would be detrimental to the user
experience to have different parts of the docs use different formatting
for the same elements.
Sorry about the misinterpretation. But actually, my answer is the same.
Simply don't define variablelist.as.table. If you want a definition
list, you use variablelist. When you want a table, you use a table. Of
course, then your Doxygen-generated reference docs will not have
tabularized variable lists and function contracts. Hrm.
You're right that that would lead to an undesirable inconsistency in the
docs. IMO, what we have now is an ugly, unreadable mess. I think the
tabularized parameter lists and function contracts are an improvement,
but perhaps variablelist.as.table is too big a hammer. Can we take my
"before" and "after" as one mock-up for how we might improve things? If
so, I'm sure some XSL hacking could get us what we want (ok, what *I*
want) without tabularizing variable lists across the board. And I'm open
to other suggestions about how to improve the presentation of the
reference docs.
Once again, the "before":
http://tinyurl.com/ho2a3
and the "after":
http://tinyurl.com/fh43h
Others are welcome to jump into this discussion at any time. :-)
--
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
