From owner-freebsd-doc Sat Jul 14 15:21:51 2001 Delivered-To: freebsd-doc@freebsd.org Received: from meow.osd.bsdi.com (meow.osd.bsdi.com [204.216.28.88]) by hub.freebsd.org (Postfix) with ESMTP id C30B237B40C for ; Sat, 14 Jul 2001 15:21:47 -0700 (PDT) (envelope-from murray@meow.osd.bsdi.com) Received: (from murray@localhost) by meow.osd.bsdi.com (8.11.4/8.11.2) id f6EMLdS47519 for freebsd-doc@FreeBSD.org; Sat, 14 Jul 2001 15:21:39 -0700 (PDT) (envelope-from murray) Date: Sat, 14 Jul 2001 15:21:39 -0700 From: Murray Stokely To: freebsd-doc@FreeBSD.org Subject: "2.1. Synopsis" vs "2.1 Synopsis" Message-ID: <20010714152139.B47232@meow.osd.bsdi.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org I know this is a minor nit, but the presence of a trailing period after the section number but before the section name was one of the things that first caught my eye about the 1st edition handbook. I have not been able to find a single technical publication that uses this standard except for the KDE User's Guide which also uses Norm's stylsheets. I would like to add the following change to the stylsheets so that our sections look like : Chapter 7 Users and Basic Account Management 7.1 Synopsis instead of Chapter 7. Users and Basic Account Management 7.1. Synopsis I'm not as worried about the "chapter" labels, since I'm working on another change that will make it look like : Chapter 7 Users and Basic Account Management (in different size fonts) However, I think the section labels look much better without the extra period. I'm perfectly happy keeping these changes in our local tree, but I want to push back as much as possible to the doc project. Thoughts? - Murray p.s. You will need a reasonably up to date version of the the dsssl stylesheets for this change to take effect. I'm not sure when the change was made but a year old dsssl-docbook-modular port won't work. Index: freebsd.dsl =================================================================== RCS file: /home/ncvs/doc/share/sgml/freebsd.dsl,v retrieving revision 1.35 diff -u -r1.35 freebsd.dsl --- freebsd.dsl 2001/07/12 01:40:31 1.35 +++ freebsd.dsl 2001/07/14 22:06:48 @@ -392,6 +392,12 @@ (list (list (normalize "warning") ": ") (list (normalize "caution") ": ") + (list (normalize "chapter") " ") + (list (normalize "sect1") " ") + (list (normalize "sect2") " ") + (list (normalize "sect3") " ") + (list (normalize "sect4") " ") + (list (normalize "sect5") " ") )) -- - Murray To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message