From owner-freebsd-doc@FreeBSD.ORG  Sun Jul 14 18:57:48 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by hub.freebsd.org (Postfix) with ESMTP id F353B27B;
 Sun, 14 Jul 2013 18:57:47 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 by mx1.freebsd.org (Postfix) with ESMTP id B5FD0DF5;
 Sun, 14 Jul 2013 18:57:47 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.7/8.14.7) with ESMTP id r6EIvk9K062614;
 Sun, 14 Jul 2013 12:57:46 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r6EIvk9m062611;
 Sun, 14 Jul 2013 12:57:46 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Sun, 14 Jul 2013 12:57:46 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Gabor Kovesdan <gabor@FreeBSD.org>
Subject: Title formatting (was Re: RFC: Upgrading to DocBook 5.0)
In-Reply-To: <51E2EA74.9070008@FreeBSD.org>
Message-ID: <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>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Sun, 14 Jul 2013 12:57:46 -0600 (MDT)
Cc: doc@freebsd.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 14 Jul 2013 18:57:48 -0000

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.