From owner-freebsd-doc@FreeBSD.ORG Mon Jul 15 08:43:23 2013 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 3606C6F1 for ; Mon, 15 Jul 2013 08:43:23 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id E54B9908 for ; Mon, 15 Jul 2013 08:43:22 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id D7DDD14D243A; Mon, 15 Jul 2013 10:43:21 +0200 (CEST) X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id a8sWovtalMiV; Mon, 15 Jul 2013 10:43:21 +0200 (CEST) Received: from [192.168.1.117] (catv-80-99-23-232.catv.broadband.hu [80.99.23.232]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 18EF514D2403; Mon, 15 Jul 2013 10:43:21 +0200 (CEST) Message-ID: <51E3B626.1030904@FreeBSD.org> Date: Mon, 15 Jul 2013 10:43:18 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:24.0) Gecko/20100101 Thunderbird/24.0a2 MIME-Version: 1.0 To: Warren Block Subject: Re: Title formatting (was Re: RFC: Upgrading to DocBook 5.0) References: <519FA4FE.4030305@FreeBSD.org> <51E25FCE.9020405@t-hosting.hu> <51E2A6C9.1070301@FreeBSD.org> <51E2EA74.9070008@FreeBSD.org> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 15 Jul 2013 08:43:23 -0000 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