Date: Mon, 15 Jul 2013 10:43:18 +0200 From: Gabor Kovesdan <gabor@FreeBSD.org> To: Warren Block <wblock@wonkity.com> Cc: doc@freebsd.org Subject: Re: Title formatting (was Re: RFC: Upgrading to DocBook 5.0) Message-ID: <51E3B626.1030904@FreeBSD.org> In-Reply-To: <alpine.BSF.2.00.1307141224570.61543@wonkity.com> References: <519FA4FE.4030305@FreeBSD.org> <51E25FCE.9020405@t-hosting.hu> <alpine.BSF.2.00.1307140636010.60846@wonkity.com> <51E2A6C9.1070301@FreeBSD.org> <alpine.BSF.2.00.1307140923450.61543@wonkity.com> <51E2EA74.9070008@FreeBSD.org> <alpine.BSF.2.00.1307141224570.61543@wonkity.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On 2013.07.14. 20:57, Warren Block wrote: > On Sun, 14 Jul 2013, Gabor Kovesdan wrote: > >>> I find different fonts for filenames and commands to be useful, even >>> in titles. The O'Reilly style guide doesn't mention anything about >>> title styles, and in a quick search I did not find anything else. >> Ok, it doesn't specify it explicitly but can you show me a technical >> book that has such titles? A real, published book, please, not online >> docs. > > Mastering Regular Expressions (1998), by Jeffrey E. F. Friedl, shows > acronyms in titles in a smaller all-caps size. There is a Perl > chapter with titles including "Modification with \Q and Friends: True > Lies", "The /e Modifier", and "Using /g with a Regex That can Match > Nothingness". The "\Q", "/e", and "/g" in those titles are in a > monospace typewriter font. This is an O'Reilly book, but most of the > other O'Reilly books I checked use the same font for all of the title. > > C Programming, A Modern Approach (2008), by K. N. King, has a Loops > chapter with section titles like "The while Loop" and "The do > Statement", where "while" and "do" are in a monospace typewriter font. > > Advanced Programming in the UNIX Environment (2001), by W. Richard > Stevens, has section titles like "stat, fstat, and lstat Functions", > "Streams and FILE Objects", and "pty_fork Function". The keywords are > in a monospace typewriter font. > > UNIX System Administration Handbook (2001), by Evi Nemeth, shows > keywords in the same font, but bold. In "The /etc/ttys and > /etc/ttytab files", the filenames are bold. Ok, thank you for investigating this. If it is accepted then I don't object that much. But please let's keep these at a reasonable extent, e.g. monspace or italic but no colors. Gabor
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?51E3B626.1030904>