Eric Niebler wrote:
Rene Rivera wrote:
Eric Niebler wrote:
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 prefer the vertical space, it makes the text easier to read.
IMO, it's wasteful and decreases the amount of information that can be
displayed at once. Personal preference, I guess.
Many times it is personal preference. Some people like whitespace more
than others :-)
One of the problems with tabular layout I noticed, from looking at all
the docs, is that it creates inconsistent tab points as your example
shows. From my experience tabular layouts only work when you have
strict control of the horizontal tab points and hence can make them
look consistent. Otherwise the effect is of a lower quality page, and
harder to read as it makes one jump around left to right to follow the
tabs.
Wow, I couldn't disagree more. For me, the different column widths
visually separate the parameters variable list from the
returns/requires/throws variable list. This is exactly what the fop/PDF
transforms do by default, and I think the result is very intuitive and
easy to read.
Do you really expect all columns to have the same widths everywhere?
No. But I expect similar information tables to be the same. That is, if
they look the same in style, the should follow the same sizing and
spacing. In this particular case they both look like bold term plus
regular text next to it. So I expect all the text to be at the same
indent position.
I
must be misinterpreting you. What are you saying exactly? Where else in
our docs do we micromanage with table widths as you suggest? An example
might help.
The example I have is of my own style, of course ;-) From the Parameter
docs (and hence any other docutils docs) of the info section at the top,
before:
<http://www.boost.org/libs/parameter/doc/html/index.html>
After:
<http://boost.redshift-software.com/doc/libs/1_33_1/libs/parameter/doc/html/index.html>
If you do, at minimum and if possible, please add class attributes to
the tables so that they can be distinguished from other tables.
Yep, the tables can be formatted separately because each one is in its
own div.variablelist block. It would be possible via the CSS to force
all variblelists-as-tables to have the same column widths, but I
wouldn't do that, personally.
And if the above wasn't clear. I, personally, would make all the widths
the same :-)
--
-- Grafik - Don't Assume Anything
-- Redshift Software, Inc. - http://redshift-software.com
-- rrivera/acm.org - grafik/redshift-software.com
-- 102708583/icq - grafikrobot/aim - grafikrobot/yahoo
-------------------------------------------------------
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
