From owner-freebsd-doc@FreeBSD.ORG Thu Mar 3 11:45:02 2005 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C51E016A4CE; Thu, 3 Mar 2005 11:45:02 +0000 (GMT) Received: from rosebud.otenet.gr (rosebud.otenet.gr [195.170.0.26]) by mx1.FreeBSD.org (Postfix) with ESMTP id 52E8443D5D; Thu, 3 Mar 2005 11:45:00 +0000 (GMT) (envelope-from keramida@ceid.upatras.gr) Received: from orion.daedalusnetworks.priv (aris.bedc.ondsl.gr [62.103.39.226])j23BiiIu032098; Thu, 3 Mar 2005 13:44:45 +0200 Received: from orion.daedalusnetworks.priv (orion [127.0.0.1]) j23Biwp8001996; Thu, 3 Mar 2005 13:44:58 +0200 (EET) (envelope-from keramida@ceid.upatras.gr) Received: (from keramida@localhost)j23BiwTK001995; Thu, 3 Mar 2005 13:44:58 +0200 (EET) (envelope-from keramida@ceid.upatras.gr) Date: Thu, 3 Mar 2005 13:44:58 +0200 From: Giorgos Keramidas To: Tom Rhodes Message-ID: <20050303114458.GA1885@orion.daedalusnetworks.priv> References: <200503011340.j21DeKHe048812@freefall.freebsd.org> <20050301182651.2b8ce710@mobile.pittgoth.com> <20050301234702.GC50779@abigail.blackend.org> <20050301185553.36c14c16@mobile.pittgoth.com> <20050302002124.GD50779@abigail.blackend.org> <20050302222722.GA99638@abigail.blackend.org> <20050303012312.75c8a02d@mobile.pittgoth.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20050303012312.75c8a02d@mobile.pittgoth.com> cc: freebsd-doc@freebsd.org Subject: Re: docs/78240: Replace with around a # X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 03 Mar 2005 11:45:02 -0000 Tom Rhodes wrote: >Marc Fonvieille wrote: >>Marc Fonvieille wrote: >>>> Yep. I mean, we use literal everywhere else. There shouldn't >>>> really be a reason to quote the specific character. >>>> >>>> In all honesty, I guess it depends on how you look at it. >>> >>> In fact I was wondering about a typographic rule, I was wondering if >>> people used to put quotes cause they could not "emphasize" the >>> character via any rendering. I just looked at a (french) >>> typographic book, it seems (nothing is stated) they use quotes for a >>> single character, on another typographic book no quotes... I will >>> reread them on tomorrow morning. >> >> Ok, here's the usage I found in the French "Imprimerie Nationale" >> rules ("Lexique des r?gles typographiques" ISBN 2-7433-0482-0): >> >> - most of time use of italic for a character >> - sometimes use of quotes (in fact for more than 1 character) >> >> I looked for American typography usage but on Internet it's not easy >> to find reliable information. If someone owns the book "The Elements >> of Typographic Style" by Robert Bringhurst (ISBN: 0881791326)... >> >> In fact it's often obvious that on a printed version using a specific >> rendering (italic, tt, etc.) is better for the reader, on an online >> version this may be different. I wanted to see what do O'Reilly, so >> I looked at at "DNS and BIND" (4th Ed.) expecting to find an answer, >> but I was disappointed they were not really consistent. Most of time >> they use italic (for a word or a term it's always italic). For a >> single character they use both italic and quotes, in fact it seems >> they use quotes when the italic version of the character does not >> exist or is "ugly"? For example they used ``@'' and >> & (but also *). >> >> Well to sum up, I did not find a good answer. Good summary, Marc. Thanks for taking the time to do this :-) > Let's just wrap it in and have done with it? I like my bikesheds painted black, please :P Seriously, folks... Please, let's not make a hasty decision that will impact the style of current and future FreeBSD documentation in a negative manner, by compromising for something less than "professional". The summary Marc wrote is very good. Since this is an issue of how text should be presented, I think we should keep the element only, and work on the way this is presented to the reader through style/dsssl changes. This way we can keep marking up text in a way that makes the structure of the document apparent _and_ present the output to the reader in any way we see fit. For instance, in PS/PDF output we may use simple fixed-width text for literal stuff. Many books that I've read (even online books) use the following typographic conventions: Typeface or Symbol Meaning ------------------ ------------------------------ Fixed-width The names of commands, files, and directories; screen output and program listings. Bold/Semi-bold What a user types on his terminal. fixed-width Italics Replaceable elements, titles of cross referenced sections, mild emphasis, titles of books or other bibliographic stuff. Bold Emphasized text, section titles, new words, misc. important terms. For other formats, we may have to use a different style: - ASCII text output cannot use italics or bold, so we may have to employ some form of quoting (automatically inserted by the stylesheets). - HTML output that depends on italic/bold/underline looks ok in GUI browsers, but may look awfuly in elinks, links, lynx or w3m. I think, after having said all this I may have to learn DSSSL and put my patches where my mouth is, but I couldn't resist posting :P Giorgos