Title formatting (was Re: RFC: Upgrading to DocBook 5.0)
Warren Block
wblock at wonkity.com
Sun Jul 14 18:57:48 UTC 2013
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.
More information about the freebsd-doc
mailing list