Rene Rivera <[EMAIL PROTECTED]> writes: > Eric Niebler wrote: >> Yes, when someone says "variablelist" they literally mean that. And >> they also literally mean "definition list" because *they are the >> same thing*. Even the documentation for DocBook's <variablelist> >> says it is the same thing >> (http://opensource.bureau-cornavin.com/crash-course/variablelist.html) >> "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>
Great page! However, DFN should format as **bold**, not /italic/. This convention is used by Addison-Wesley (see C++TMP) and the rationale is unassailable, IMO. Italics tend to be skinny and actually disappear into the page, whereas bold stands out. When you're scanning text, it's important to be able to quickly pick out the definition and distinguish it from the other uses. > 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> You mean in the "Notation" section, yes? > Without the forced italic style, and column like spacing, one can see > the style for of the "term" itself I agree; it works better and it's an accepted formatting convention. > (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. The bold is good. Question: why the plus signs in the bullet lists? Bullets mean bullets; plus signs mean addition (or "collapsible list item"), no? It seems needlessly unconventional to me. -- Dave Abrahams Boost Consulting www.boost-consulting.com ------------------------------------------------------- This SF.net email is sponsored by: Splunk Inc. Do you grep through log files for problems? Stop! Download the new AJAX search engine that makes searching your log files as easy as surfing the web. DOWNLOAD SPLUNK! http://sel.as-us.falkag.net/sel?cmd=lnk&kid=103432&bid=230486&dat=121642 _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
