Rene Rivera <[EMAIL PROTECTED]> writes: > David Abrahams wrote: >> Rene Rivera <[EMAIL PROTECTED]> writes: >>> 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. > > OK I'll change that... Italics is the browser default. But I should > know by now that browser defaults are often unconventional.
Well, italics are actually conventional for this purpose in many circles. That doesn't make the convention right. And, BTW, the effect I mention may not apply as strongly on a web page as on a printed one. >> 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. > > That's the current, as in the now 1 year old Boost style. It's meant > to refer to C++. But like you say it's not a common bullet > style. Bullet styles are far ranging, I've seen hundreds. Perhaps one > of the square bullet styles would work better :-) Maybe. -- 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
