Date: Thu, 15 Aug 2002 21:35:14 -0400 From: Hiten Pandya <hiten@angelica.unixdaemons.com> To: freebsd-doc@FreeBSD.org Subject: Re: [REVIEW] Adding labels to chapters for xref Message-ID: <20020815213514.A26740@angelica.unixdaemons.com> In-Reply-To: <20020815213125.A26602@angelica.unixdaemons.com>; from hiten@angelica.unixdaemons.com on Thu, Aug 15, 2002 at 09:31:25PM -0400 References: <20020815213125.A26602@angelica.unixdaemons.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--5mCyUwZo2JvN/JJP Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Thu, Aug 15, 2002 at 09:31:25PM -0400, Hiten Pandya wrote the words in effect of: > Date: Thu, 15 Aug 2002 21:31:25 -0400 > To: freebsd-doc@FreeBSD.org > Subject: [REVIEW] Adding labels to chapters for xref > We can refer to the chapters, much more sensibly this way IMHO. The > delta for the developers-handbook is attached with this mail, and it is > also available at: http://www.unixdaemons.com/~hiten/work/xreflabels.patch Oops. Diff attached with this mail. -- Hiten Pandya http://www.unixdaemons.com/~hiten hiten@unixdaemons.com, hiten@uk.FreeBSD.org, hiten@xMach.org PGP: http://pgp.mit.edu:11371/pks/lookup?search=Hiten+Pandya&op=index --5mCyUwZo2JvN/JJP Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="xreflabels.patch" Index: en_US.ISO8859-1/books/developers-handbook/boot/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/boot/chapter.sgml,v retrieving revision 1.1 diff -u -r1.1 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/boot/chapter.sgml 2002/07/29 06:18:01 1.1 +++ en_US.ISO8859-1/books/developers-handbook/boot/chapter.sgml 2002/08/16 01:29:59 @@ -6,7 +6,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/boot/chapter.sgml,v 1.1 2002/07/29 06:18:01 murray Exp $ --> -<chapter id="boot"> +<chapter id="boot" xreflabel="Bootstrapping and Kernel initialisation"> <chapterinfo> <authorgroup> <author> Index: en_US.ISO8859-1/books/developers-handbook/dma/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/dma/chapter.sgml,v retrieving revision 1.4 diff -u -r1.4 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/dma/chapter.sgml 2002/02/14 13:20:33 1.4 +++ en_US.ISO8859-1/books/developers-handbook/dma/chapter.sgml 2002/08/16 01:30:00 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/dma/chapter.sgml,v 1.4 2002/02/14 13:20:33 keramida Exp $ --> -<chapter id="dma"> +<chapter id="dma" xreflabel="DMA: What it is and How it Works"> <title>DMA</title> <sect1 id="dma-basics"> Index: en_US.ISO8859-1/books/developers-handbook/driverbasics/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/driverbasics/chapter.sgml,v retrieving revision 1.19 diff -u -r1.19 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/driverbasics/chapter.sgml 2002/07/11 19:08:04 1.19 +++ en_US.ISO8859-1/books/developers-handbook/driverbasics/chapter.sgml 2002/08/16 01:30:00 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/driverbasics/chapter.sgml,v 1.19 2002/07/11 19:08:04 trhodes Exp $ --> -<chapter id="driverbasics"> +<chapter id="driverbasics" xreflabel="Writing FreeBSD Device Drivers"> <title>Writing FreeBSD Device Drivers</title> <para>This chapter was written by &a.murray; with selections from a Index: en_US.ISO8859-1/books/developers-handbook/introduction/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/introduction/chapter.sgml,v retrieving revision 1.6 diff -u -r1.6 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/introduction/chapter.sgml 2002/02/13 09:47:10 1.6 +++ en_US.ISO8859-1/books/developers-handbook/introduction/chapter.sgml 2002/08/16 01:30:00 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/introduction/chapter.sgml,v 1.6 2002/02/13 09:47:10 murray Exp $ --> -<chapter id="introduction"> +<chapter id="introduction" xreflabel="introduction"> <chapterinfo> <authorgroup> <author> Index: en_US.ISO8859-1/books/developers-handbook/ipv6/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/ipv6/chapter.sgml,v retrieving revision 1.11 diff -u -r1.11 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/ipv6/chapter.sgml 2002/07/11 19:08:07 1.11 +++ en_US.ISO8859-1/books/developers-handbook/ipv6/chapter.sgml 2002/08/16 01:30:02 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/ipv6/chapter.sgml,v 1.11 2002/07/11 19:08:07 trhodes Exp $ --> -<chapter id="ipv6"> +<chapter id="ipv6" xreflabel="IPv6 Internals"> <title>IPv6 Internals</title> <sect1 id="ipv6-implementation"> Index: en_US.ISO8859-1/books/developers-handbook/isa/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/isa/chapter.sgml,v retrieving revision 1.10 diff -u -r1.10 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/isa/chapter.sgml 2002/02/16 23:35:35 1.10 +++ en_US.ISO8859-1/books/developers-handbook/isa/chapter.sgml 2002/08/16 01:30:05 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/isa/chapter.sgml,v 1.10 2002/02/16 23:35:35 keramida Exp $ --> -<chapter id="isa-driver"> +<chapter id="isa-driver" xreflabel="ISA device drivers"> <title>ISA device drivers</title> <para> Index: en_US.ISO8859-1/books/developers-handbook/jail/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/jail/chapter.sgml,v retrieving revision 1.6 diff -u -r1.6 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/jail/chapter.sgml 2002/06/27 19:32:34 1.6 +++ en_US.ISO8859-1/books/developers-handbook/jail/chapter.sgml 2002/08/16 01:30:05 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/jail/chapter.sgml,v 1.6 2002/06/27 19:32:34 tom Exp $ --> -<chapter id="jail"> +<chapter id="jail" xreflabel="The Jail Subsystem"> <chapterinfo> <author><firstname>Evan Sarmiento</firstname> <affiliation><address><email>evms@cs.bu.edu</email></address> Index: en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml,v retrieving revision 1.43 diff -u -r1.43 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml 2002/07/19 14:47:04 1.43 +++ en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml 2002/08/16 01:30:06 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml,v 1.43 2002/07/19 14:47:04 ceri Exp $ --> -<chapter id="kerneldebug"> +<chapter id="kerneldebug" xreflabel="Kernel Debugging"> <title>Kernel Debugging</title> <para><emphasis>Contributed by &a.paul; and &a.joerg;</emphasis></para> Index: en_US.ISO8859-1/books/developers-handbook/kobj/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/kobj/chapter.sgml,v retrieving revision 1.2 diff -u -r1.2 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/kobj/chapter.sgml 2001/12/08 10:48:56 1.2 +++ en_US.ISO8859-1/books/developers-handbook/kobj/chapter.sgml 2002/08/16 01:30:06 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/kobj/chapter.sgml,v 1.2 2001/12/08 10:48:56 keramida Exp $ --> -<chapter id="kernel-objects"> +<chapter id="kernel-objects" xreflabel="Kernel Objects"> <title>Kernel Objects</title> <para>Kernel Objects, or <firstterm>Kobj</firstterm> provides an Index: en_US.ISO8859-1/books/developers-handbook/l10n/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/l10n/chapter.sgml,v retrieving revision 1.6 diff -u -r1.6 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/l10n/chapter.sgml 2002/03/15 07:57:11 1.6 +++ en_US.ISO8859-1/books/developers-handbook/l10n/chapter.sgml 2002/08/16 01:30:07 @@ -4,7 +4,8 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/l10n/chapter.sgml,v 1.6 2002/03/15 07:57:11 roam Exp $ --> - <chapter id="l10n"> + <chapter id="l10n" + xreflabel="Localization and Internationalization - L10n and I18N"> <title>Localization and Internationalization - L10N and I18N</title> <sect1> Index: en_US.ISO8859-1/books/developers-handbook/locking/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/locking/chapter.sgml,v retrieving revision 1.3 diff -u -r1.3 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/locking/chapter.sgml 2002/03/15 07:46:15 1.3 +++ en_US.ISO8859-1/books/developers-handbook/locking/chapter.sgml 2002/08/16 01:30:07 @@ -5,7 +5,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/locking/chapter.sgml,v 1.3 2002/03/15 07:46:15 roam Exp $ --> -<chapter id="locking"> +<chapter id="locking" xreflabel="Locking notes"> <title>Locking Notes</title> <para><emphasis>This chapter is maintained by the FreeBSD SMP Next Index: en_US.ISO8859-1/books/developers-handbook/pci/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/pci/chapter.sgml,v retrieving revision 1.8 diff -u -r1.8 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/pci/chapter.sgml 2002/02/14 13:59:44 1.8 +++ en_US.ISO8859-1/books/developers-handbook/pci/chapter.sgml 2002/08/16 01:30:07 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/pci/chapter.sgml,v 1.8 2002/02/14 13:59:44 keramida Exp $ --> -<chapter id="pci"> +<chapter id="pci" xreflabel="PCI Devices"> <title>PCI Devices</title> <para>This chapter will talk about the FreeBSD mechanisms for Index: en_US.ISO8859-1/books/developers-handbook/policies/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/policies/chapter.sgml,v retrieving revision 1.28 diff -u -r1.28 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/policies/chapter.sgml 2002/05/22 08:36:37 1.28 +++ en_US.ISO8859-1/books/developers-handbook/policies/chapter.sgml 2002/08/16 01:30:07 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/policies/chapter.sgml,v 1.28 2002/05/22 08:36:37 ceri Exp $ --> -<chapter id="policies"> +<chapter id="policies" xreflabel="Source Tree Guidelines and Policies"> <title>Source Tree Guidelines and Policies</title> <para><emphasis>Contributed by &a.phk;.</emphasis></para> Index: en_US.ISO8859-1/books/developers-handbook/scsi/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/scsi/chapter.sgml,v retrieving revision 1.8 diff -u -r1.8 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/scsi/chapter.sgml 2002/02/19 14:34:11 1.8 +++ en_US.ISO8859-1/books/developers-handbook/scsi/chapter.sgml 2002/08/16 01:30:09 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/scsi/chapter.sgml,v 1.8 2002/02/19 14:34:11 murray Exp $ --> -<chapter id="scsi"> +<chapter id="scsi" xreflabel="Common Access Method SCSI Controllers"> <title>Common Access Method SCSI Controllers</title> <para><emphasis>This chapter was written by &a.babkin; Index: en_US.ISO8859-1/books/developers-handbook/secure/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/secure/chapter.sgml,v retrieving revision 1.15 diff -u -r1.15 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/secure/chapter.sgml 2002/05/16 01:42:11 1.15 +++ en_US.ISO8859-1/books/developers-handbook/secure/chapter.sgml 2002/08/16 01:30:09 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/secure/chapter.sgml,v 1.15 2002/05/16 01:42:11 trhodes Exp $ --> - <chapter id="secure"> + <chapter id="secure" xreflabel="Secure Programming"> <title>Secure Programming</title> <para>This chapter was written by &a.murray;.</para> Index: en_US.ISO8859-1/books/developers-handbook/sound/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/sound/chapter.sgml,v retrieving revision 1.2 diff -u -r1.2 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/sound/chapter.sgml 2002/03/15 07:46:15 1.2 +++ en_US.ISO8859-1/books/developers-handbook/sound/chapter.sgml 2002/08/16 01:30:09 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/sound/chapter.sgml,v 1.2 2002/03/15 07:46:15 roam Exp $ --> -<chapter id="oss"> +<chapter id="oss" xreflabel="Sound subsystem"> <chapterinfo> <authorgroup> <author> Index: en_US.ISO8859-1/books/developers-handbook/sysinit/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/sysinit/chapter.sgml,v retrieving revision 1.3 diff -u -r1.3 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/sysinit/chapter.sgml 2002/01/03 14:26:23 1.3 +++ en_US.ISO8859-1/books/developers-handbook/sysinit/chapter.sgml 2002/08/16 01:30:09 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/sysinit/chapter.sgml,v 1.3 2002/01/03 14:26:23 murray Exp $ --> -<chapter id="sysinit"> +<chapter id="sysinit" xreflabel="The Sysinit Framework"> <title>The Sysinit Framework</title> <para>Sysinit is the framework for a generic call sort and dispatch Index: en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml,v retrieving revision 1.22 diff -u -r1.22 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml 2002/07/11 19:08:10 1.22 +++ en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml 2002/08/16 01:30:12 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml,v 1.22 2002/07/11 19:08:10 trhodes Exp $ --> -<chapter id="tools"> +<chapter id="tools" xreflabel="Programming Tools"> <chapterinfo> <authorgroup> <author> @@ -287,7 +287,7 @@ available in the ports tree and many use <application>Emacs</application> for this purpose. Using <application>Emacs</application> as an IDE is discussed in - <xref linkend="emacs">.</para> + the <xref linkend="emacs"> chapter.</para> </sect2> @@ -849,7 +849,8 @@ <answer> <para>Use <command>gdb</command> to analyse the core (see - <xref linkend="debugging">).</para> + the <xref linkend="debugging"> chapter for more information). + </para> </answer> </qandaentry> Index: en_US.ISO8859-1/books/developers-handbook/usb/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/usb/chapter.sgml,v retrieving revision 1.3 diff -u -r1.3 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/usb/chapter.sgml 2001/12/08 10:45:19 1.3 +++ en_US.ISO8859-1/books/developers-handbook/usb/chapter.sgml 2002/08/16 01:30:12 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/usb/chapter.sgml,v 1.3 2001/12/08 10:45:19 keramida Exp $ --> -<chapter id="usb"> +<chapter id="usb" xreflabel="USB Devices"> <title>USB Devices</title> <para><emphasis>This chapter was written by &a.nhibma;. Modifications made for Index: en_US.ISO8859-1/books/developers-handbook/vm/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/vm/chapter.sgml,v retrieving revision 1.3 diff -u -r1.3 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/vm/chapter.sgml 2002/03/05 15:35:44 1.3 +++ en_US.ISO8859-1/books/developers-handbook/vm/chapter.sgml 2002/08/16 01:30:13 @@ -4,7 +4,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/vm/chapter.sgml,v 1.3 2002/03/05 15:35:44 murray Exp $ --> -<chapter id="vm"> +<chapter id="vm" xreflabel="Virtual Memory System"> <title>Virtual Memory System</title> <sect1 id="internals-vm"> Index: en_US.ISO8859-1/books/developers-handbook/x86/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/x86/chapter.sgml,v retrieving revision 1.10 diff -u -r1.10 chapter.sgml --- en_US.ISO8859-1/books/developers-handbook/x86/chapter.sgml 2002/07/11 19:08:11 1.10 +++ en_US.ISO8859-1/books/developers-handbook/x86/chapter.sgml 2002/08/16 01:30:24 @@ -18,7 +18,7 @@ $FreeBSD: doc/en_US.ISO8859-1/books/developers-handbook/x86/chapter.sgml,v 1.10 2002/07/11 19:08:11 trhodes Exp $ --> -<chapter id="x86"> +<chapter id="x86" xreflabel="x86 Assembly Language Programming"> <title>x86 Assembly Language Programming</title> <para> --5mCyUwZo2JvN/JJP-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020815213514.A26740>