Date: Sat, 14 Jul 2001 15:21:39 -0700 From: Murray Stokely <murray@osd.bsdi.com> To: freebsd-doc@FreeBSD.org Subject: "2.1. Synopsis" vs "2.1 Synopsis" Message-ID: <20010714152139.B47232@meow.osd.bsdi.com>
index | next in thread | raw e-mail
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") " ")
))
<!-- Tell the stylesheet about our local customisations -->
--
- Murray
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010714152139.B47232>