Date: Wed, 11 Dec 2002 15:22:21 -0500 From: Adam Turoff <ziggy@panix.com> To: "Bruce A. Mah" <bmah@FreeBSD.ORG> Cc: Dan Langille <dan@langille.org>, doc@FreeBSD.ORG Subject: Re: duplicate pages Message-ID: <20021211202221.GA7744@panix.com> In-Reply-To: <20021211193350.GC12310@panix.com> References: <3DF5A7CE.10210.1F97770D@localhost> <3DF73795.26681.25B135DB@localhost> <200212111815.gBBIFjxx042278@intruder.bmah.org> <20021211193350.GC12310@panix.com>
next in thread | previous in thread | raw e-mail | index | archive | help
[-- Attachment #1 --]
On Wed, Dec 11, 2002 at 02:33:50PM -0500, Adam Turoff wrote:
> On Wed, Dec 11, 2002 at 10:15:44AM -0800, Bruce A. Mah wrote:
> > It'd be nice if the internal links for our documentation pages didn't
> > change, but that would require some (large, I suspect) changes to the
> > DocBook toolchain.
>
> Not really. It'll require adding IDs to each of the individual
> sections.
Step 1: find the problematic sections of a document:
[ziggy@chimay handbook]$ egrep -n '<(part|sect1|chapter|colophon)>' \
*.sgml */*.sgml
book.sgml:108: <part>
book.sgml:153: <part>
book.sgml:190: <part>
colophon.sgml:7:<colophon>
...
Step 2: add ids to those elements
Step 3: clean & rebuild. No more [xzp][0-9]+.html filenames. :-)
Step 4: doublecheck to see that none of the IDs are duplicates
[ziggy@chimay handbook2]$ egrep '<(part|chapter|sect1|colophon) id=' \
*.sgml */*.sgml \
| cut -f 2 -d '"' | sort | uniq -d
backups-floppybackups
backups-tapebackups
[ziggy@chimay handbook] $
NB: These are found in backup/chapter.sgml (unused) and
disks/chapter.sgml (used). This is not a problem.
---
Patch for the Handbook attached. ;-)
Z.
[-- Attachment #2 --]
*** /usr/doc/en_US.ISO8859-1/books/handbook/book.sgml Mon Oct 28 14:52:11 2002
--- book.sgml Wed Dec 11 14:45:38 2002
***************
*** 105,111 ****
&chap.preface;
! <part>
<title>Getting Started</title>
<partintro>
--- 105,111 ----
&chap.preface;
! <part id="getting-started">
<title>Getting Started</title>
<partintro>
***************
*** 150,156 ****
<![ %chap.x11; [ &chap.x11; ]]>
</part>
! <part>
<title>System Administration</title>
<partintro>
--- 150,156 ----
<![ %chap.x11; [ &chap.x11; ]]>
</part>
! <part id="system-administration">
<title>System Administration</title>
<partintro>
***************
*** 187,193 ****
<![ %chap.linuxemu; [ &chap.linuxemu; ]]>
</part>
! <part>
<title>Appendices</title>
<![ %chap.mirrors; [ &chap.mirrors; ]]>
--- 187,193 ----
<![ %chap.linuxemu; [ &chap.linuxemu; ]]>
</part>
! <part id="appendicies">
<title>Appendices</title>
<![ %chap.mirrors; [ &chap.mirrors; ]]>
*** /usr/doc/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml Mon Dec 9 16:31:36 2002
--- advanced-networking/chapter.sgml Wed Dec 11 14:46:02 2002
***************
*** 7,13 ****
<chapter id="advanced-networking">
<title>Advanced Networking</title>
! <sect1>
<title>Synopsis</title>
<para>This chapter will cover some of the more frequently used network
--- 7,13 ----
<chapter id="advanced-networking">
<title>Advanced Networking</title>
! <sect1 id="advanced-networking-synopsis">
<title>Synopsis</title>
<para>This chapter will cover some of the more frequently used network
*** /usr/doc/en_US.ISO8859-1/books/handbook/backups/chapter.sgml Mon Apr 29 08:14:05 2002
--- backups/chapter.sgml Wed Dec 11 14:46:13 2002
***************
*** 7,13 ****
<chapter id="backups">
<title>Backups</title>
! <sect1>
<title>Synopsis</title>
<para>The following chapter will cover methods of backing up data, and
--- 7,13 ----
<chapter id="backups">
<title>Backups</title>
! <sect1 id="backups-synopsis">
<title>Synopsis</title>
<para>The following chapter will cover methods of backing up data, and
*** /usr/doc/en_US.ISO8859-1/books/handbook/basics/chapter.sgml Tue Nov 5 23:03:12 2002
--- basics/chapter.sgml Wed Dec 11 14:47:27 2002
***************
*** 18,24 ****
<title>Unix Basics</title>
! <sect1>
<title>Synopsis</title>
<indexterm><primary>basics</primary></indexterm>
--- 18,24 ----
<title>Unix Basics</title>
! <sect1 id="basics-synopsis">
<title>Synopsis</title>
<indexterm><primary>basics</primary></indexterm>
***************
*** 856,862 ****
this can be changed with the <option>s</option> option.</para>
</sect1>
! <sect1>
<title>Daemons, Signals, and Killing Processes</title>
<para>When you run an editor it is easy to control the editor, tell it to
--- 856,862 ----
this can be changed with the <option>s</option> option.</para>
</sect1>
! <sect1 id="basics-daemons">
<title>Daemons, Signals, and Killing Processes</title>
<para>When you run an editor it is easy to control the editor, tell it to
***************
*** 1291,1297 ****
will save you much more time in the long run.</para>
</sect1>
! <sect1>
<title>Devices and Device Nodes</title>
<para>A device is a term used mostly for hardware-related
--- 1291,1297 ----
will save you much more time in the long run.</para>
</sect1>
! <sect1 id="basics-devices">
<title>Devices and Device Nodes</title>
<para>A device is a term used mostly for hardware-related
***************
*** 1560,1566 ****
</sect2>
</sect1>
! <sect1>
<title>For More Information</title>
<sect2 id="basics-man">
--- 1560,1566 ----
</sect2>
</sect1>
! <sect1 id="basics-more-information">
<title>For More Information</title>
<sect2 id="basics-man">
*** /usr/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml Sun Dec 8 12:21:29 2002
--- config/chapter.sgml Wed Dec 11 14:48:17 2002
***************
*** 31,37 ****
<title>Configuration and Tuning</title>
! <sect1>
<title>Synopsis</title>
<indexterm><primary>system configuration/optimization</primary></indexterm>
--- 31,37 ----
<title>Configuration and Tuning</title>
! <sect1 id="config-synopsis">
<title>Synopsis</title>
<indexterm><primary>system configuration/optimization</primary></indexterm>
***************
*** 413,419 ****
system boot.</para>
</sect1>
! <sect1>
<sect1info>
<authorgroup>
<author>
--- 413,419 ----
system boot.</para>
</sect1>
! <sect1 id="config-network-setup">
<sect1info>
<authorgroup>
<author>
*** /usr/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml Sun Dec 8 12:21:29 2002
--- cutting-edge/chapter.sgml Wed Dec 11 14:48:32 2002
***************
*** 38,44 ****
<title>The Cutting Edge</title>
! <sect1>
<title>Synopsis</title>
<para>&os; is under constant development between releases. For
--- 38,44 ----
<title>The Cutting Edge</title>
! <sect1 id="cutting-edge-synopsis">
<title>Synopsis</title>
<para>&os; is under constant development between releases. For
*** /usr/doc/en_US.ISO8859-1/books/handbook/install/chapter.sgml Mon Dec 9 16:31:36 2002
--- install/chapter.sgml Wed Dec 11 14:56:25 2002
***************
*** 28,34 ****
<title>Installing FreeBSD</title>
! <sect1>
<title>Synopsis</title>
<indexterm><primary>installation</primary></indexterm>
--- 28,34 ----
<title>Installing FreeBSD</title>
! <sect1 id="install-synopsis">
<title>Synopsis</title>
<indexterm><primary>installation</primary></indexterm>
***************
*** 2602,2608 ****
</sect2>
</sect1>
! <sect1>
<title>Choosing What To Install</title>
<sect2 id="distset">
--- 2602,2608 ----
</sect2>
</sect1>
! <sect1 id="install-choosing">
<title>Choosing What To Install</title>
<sect2 id="distset">
***************
*** 4890,4896 ****
</sect2>
</sect1>
! <sect1>
<title>Supported Hardware</title>
<indexterm><primary>hardware</primary></indexterm>
--- 4890,4896 ----
</sect2>
</sect1>
! <sect1 id="install-supported-hardware">
<title>Supported Hardware</title>
<indexterm><primary>hardware</primary></indexterm>
*** /usr/doc/en_US.ISO8859-1/books/handbook/introduction/chapter.sgml Mon Dec 9 16:31:36 2002
--- introduction/chapter.sgml Wed Dec 11 14:56:39 2002
***************
*** 18,24 ****
<title>Introduction</title>
! <sect1>
<title>Synopsis</title>
<para>Thank you for your interest in FreeBSD! The following chapter
--- 18,24 ----
<title>Introduction</title>
! <sect1 id="introduction-synopsis">
<title>Synopsis</title>
<para>Thank you for your interest in FreeBSD! The following chapter
*** /usr/doc/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml Sun Dec 8 12:21:31 2002
--- kernelconfig/chapter.sgml Wed Dec 11 14:57:25 2002
***************
*** 26,32 ****
<title>Configuring the FreeBSD Kernel</title>
! <sect1>
<title>Synopsis</title>
<indexterm>
--- 26,32 ----
<title>Configuring the FreeBSD Kernel</title>
! <sect1 id="kernelconfig-synopsis">
<title>Synopsis</title>
<indexterm>
***************
*** 72,78 ****
</itemizedlist>
</sect1>
! <sect1>
<title>Why Build a Custom Kernel?</title>
<para>Traditionally, FreeBSD has had what is called a
--- 72,78 ----
</itemizedlist>
</sect1>
! <sect1 id="kernelconfig-custom-kernel">
<title>Why Build a Custom Kernel?</title>
<para>Traditionally, FreeBSD has had what is called a
*** /usr/doc/en_US.ISO8859-1/books/handbook/l10n/chapter.sgml Mon Oct 14 09:50:17 2002
--- l10n/chapter.sgml Wed Dec 11 14:58:08 2002
***************
*** 25,31 ****
<title>Localization - I18N/L10N Usage and Setup</title>
! <sect1>
<title>Synopsis</title>
<para>FreeBSD is a very distributed project with users and
--- 25,31 ----
<title>Localization - I18N/L10N Usage and Setup</title>
! <sect1 id="l10n-synopsis">
<title>Synopsis</title>
<para>FreeBSD is a very distributed project with users and
***************
*** 58,64 ****
</itemizedlist>
</sect1>
! <sect1>
<title>The Basics</title>
<sect2>
--- 58,64 ----
</itemizedlist>
</sect1>
! <sect1 id="l10n-basics">
<title>The Basics</title>
<sect2>
***************
*** 658,664 ****
</sect2>
</sect1>
! <sect1>
<title>Compiling I18N Programs</title>
<para>Many FreeBSD Ports have been ported with I18N support. Some
--- 658,664 ----
</sect2>
</sect1>
! <sect1 id="l10n-compiling">
<title>Compiling I18N Programs</title>
<para>Many FreeBSD Ports have been ported with I18N support. Some
*** /usr/doc/en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml Tue Dec 3 13:53:16 2002
--- linuxemu/chapter.sgml Wed Dec 11 14:59:13 2002
***************
*** 29,35 ****
<title>Linux Binary Compatibility</title>
! <sect1>
<title>Synopsis</title>
<indexterm><primary>Linux binary compatibility</primary></indexterm>
<indexterm>
--- 29,35 ----
<title>Linux Binary Compatibility</title>
! <sect1 id="linuxemu-synopsis">
<title>Synopsis</title>
<indexterm><primary>Linux binary compatibility</primary></indexterm>
<indexterm>
***************
*** 2950,2956 ****
</sect2>
</sect1>
! <sect1>
<title>Advanced Topics</title>
<para>If you are curious as to how the Linux binary compatibility
--- 2950,2956 ----
</sect2>
</sect1>
! <sect1 id="linuxemu-advanced">
<title>Advanced Topics</title>
<para>If you are curious as to how the Linux binary compatibility
*** /usr/doc/en_US.ISO8859-1/books/handbook/mail/chapter.sgml Wed Dec 11 00:35:13 2002
--- mail/chapter.sgml Wed Dec 11 14:59:24 2002
***************
*** 25,31 ****
<title>Electronic Mail</title>
! <sect1>
<title>Synopsis</title>
<indexterm><primary>email</primary></indexterm>
<indexterm><primary>electronic mail</primary></indexterm>
--- 25,31 ----
<title>Electronic Mail</title>
! <sect1 id="mail-synopsis">
<title>Synopsis</title>
<indexterm><primary>email</primary></indexterm>
<indexterm><primary>electronic mail</primary></indexterm>
*** /usr/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml Wed Dec 11 14:42:00 2002
--- mirrors/chapter.sgml Wed Dec 11 14:59:41 2002
***************
*** 7,13 ****
<appendix id="mirrors">
<title>Obtaining FreeBSD</title>
! <sect1>
<title>CDROM Publishers</title>
<sect2>
--- 7,13 ----
<appendix id="mirrors">
<title>Obtaining FreeBSD</title>
! <sect1 id="mirrors-cdrom">
<title>CDROM Publishers</title>
<sect2>
*** /usr/doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml Thu Oct 3 22:42:28 2002
--- ports/chapter.sgml Wed Dec 11 15:01:04 2002
***************
*** 7,13 ****
<chapter id="ports">
<title>Installing Applications: Packages and Ports</title>
! <sect1>
<title>Synopsis</title>
<indexterm><primary>ports</primary></indexterm>
--- 7,13 ----
<chapter id="ports">
<title>Installing Applications: Packages and Ports</title>
! <sect1 id="ports-synopsis">
<title>Synopsis</title>
<indexterm><primary>ports</primary></indexterm>
***************
*** 38,44 ****
</itemizedlist>
</sect1>
! <sect1>
<title>Overview of Software Installation</title>
<para>If you have used a Unix system before you will know that the typical
--- 38,44 ----
</itemizedlist>
</sect1>
! <sect1 id="ports-overview">
<title>Overview of Software Installation</title>
<para>If you have used a Unix system before you will know that the typical
***************
*** 206,212 ****
ports to install and manage third party software on FreeBSD.</para>
</sect1>
! <sect1>
<title>Finding Your Application</title>
<para>Before you can install any applications you need to know what you
--- 206,212 ----
ports to install and manage third party software on FreeBSD.</para>
</sect1>
! <sect1 id="ports-finding-applications">
<title>Finding Your Application</title>
<para>Before you can install any applications you need to know what you
*** /usr/doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml Sun Dec 8 12:21:32 2002
--- ppp-and-slip/chapter.sgml Wed Dec 11 15:01:15 2002
***************
*** 18,24 ****
<title>PPP and SLIP</title>
! <sect1>
<title>Synopsis</title>
<indexterm id="ppp-ppp">
<primary>PPP</primary>
--- 18,24 ----
<title>PPP and SLIP</title>
! <sect1 id="ppp-and-slip-synopsis">
<title>Synopsis</title>
<indexterm id="ppp-ppp">
<primary>PPP</primary>
*** /usr/doc/en_US.ISO8859-1/books/handbook/printing/chapter.sgml Tue Dec 3 13:53:17 2002
--- printing/chapter.sgml Wed Dec 11 15:01:32 2002
***************
*** 26,32 ****
<title>Printing</title>
! <sect1>
<title>Synopsis</title>
<indexterm><primary>LPD spooling system</primary></indexterm>
<indexterm><primary>printing</primary></indexterm>
--- 26,32 ----
<title>Printing</title>
! <sect1 id="printing-synopsis">
<title>Synopsis</title>
<indexterm><primary>LPD spooling system</primary></indexterm>
<indexterm><primary>printing</primary></indexterm>
*** /usr/doc/en_US.ISO8859-1/books/handbook/security/chapter.sgml Wed Dec 11 00:35:13 2002
--- security/chapter.sgml Wed Dec 11 15:01:42 2002
***************
*** 19,25 ****
<title>Security</title>
<indexterm><primary>security</primary></indexterm>
! <sect1>
<title>Synopsis</title>
<para>This chapter will provide a basic introduction to system security
--- 19,25 ----
<title>Security</title>
<indexterm><primary>security</primary></indexterm>
! <sect1 id="security-synopsis">
<title>Synopsis</title>
<para>This chapter will provide a basic introduction to system security
*** /usr/doc/en_US.ISO8859-1/books/handbook/vinum/chapter.sgml Thu Oct 24 10:36:16 2002
--- vinum/chapter.sgml Wed Dec 11 15:02:22 2002
***************
*** 61,67 ****
creating an abstract device which stores its data on a number of disks.</para>
</sect1>
! <sect1>
<title>Access bottlenecks</title>
<para>Modern systems frequently need to access data in a highly
concurrent manner. For example, large FTP or HTTP servers can maintain
--- 61,67 ----
creating an abstract device which stores its data on a number of disks.</para>
</sect1>
! <sect1 id="vinum-access-bottlenecks">
<title>Access bottlenecks</title>
<para>Modern systems frequently need to access data in a highly
concurrent manner. For example, large FTP or HTTP servers can maintain
***************
*** 181,187 ****
</para>
</sect1>
! <sect1>
<title>Data integrity</title>
<para>The final problem with current disks is that they are unreliable.
Although disk drive reliability has increased tremendously over the last
--- 181,187 ----
</para>
</sect1>
! <sect1 id="vinum-data-integrity">
<title>Data integrity</title>
<para>The final problem with current disks is that they are unreliable.
Although disk drive reliability has increased tremendously over the last
***************
*** 673,679 ****
</sect2>
</sect1>
! <sect1>
<title>Object naming</title>
<para>As described above, Vinum assigns default names to plexes and
subdisks, although they may be overridden. Overriding the default names
--- 673,679 ----
</sect2>
</sect1>
! <sect1 id="vinum-object-naming">
<title>Object naming</title>
<para>As described above, Vinum assigns default names to plexes and
subdisks, although they may be overridden. Overriding the default names
*** /usr/doc/en_US.ISO8859-1/books/handbook/x11/chapter.sgml Tue Dec 3 13:53:18 2002
--- x11/chapter.sgml Wed Dec 11 15:02:31 2002
***************
*** 7,13 ****
<chapter id="x11">
<title>The X Window System</title>
! <sect1>
<title>Synopsis</title>
<para>FreeBSD uses <application>XFree86</application> to provide users with
--- 7,13 ----
<chapter id="x11">
<title>The X Window System</title>
! <sect1 id="x11-synopsis">
<title>Synopsis</title>
<para>FreeBSD uses <application>XFree86</application> to provide users with
*** /usr/doc/en_US.ISO8859-1/books/handbook/colophon.sgml Wed Dec 11 14:41:58 2002
--- colophon.sgml Wed Dec 11 15:06:53 2002
***************
*** 4,10 ****
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/colophon.sgml,v 1.5 2002/12/11 17:43:51 lioux Exp $
-->
! <colophon>
<para>This book is the combined work of hundreds of contributors to
<quote>The FreeBSD Documentation Project</quote>. The text is authored in SGML
according to the DocBook DTD and is formatted from SGML into many
--- 4,10 ----
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/colophon.sgml,v 1.5 2002/12/11 17:43:51 lioux Exp $
-->
! <colophon id='colophon'>
<para>This book is the combined work of hundreds of contributors to
<quote>The FreeBSD Documentation Project</quote>. The text is authored in SGML
according to the DocBook DTD and is formatted from SGML into many
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20021211202221.GA7744>