From owner-freebsd-doc  Wed Dec 11 12:22:45 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id C984837B401; Wed, 11 Dec 2002 12:22:28 -0800 (PST)
Received: from mail1.panix.com (mail1.panix.com [166.84.1.72])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 97AE543EB2; Wed, 11 Dec 2002 12:22:27 -0800 (PST)
	(envelope-from ziggy@panix.com)
Received: from panix2.panix.com (panix2.panix.com [166.84.1.2])
	by mail1.panix.com (Postfix) with ESMTP
	id EB88D488CF; Wed, 11 Dec 2002 15:22:21 -0500 (EST)
Received: (from ziggy@localhost)
	by panix2.panix.com (8.11.6/8.8.8/PanixN1.0) id gBBKMLI14896;
	Wed, 11 Dec 2002 15:22:21 -0500 (EST)
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>
References: <3DF5A7CE.10210.1F97770D@localhost> <3DF73795.26681.25B135DB@localhost> <200212111815.gBBIFjxx042278@intruder.bmah.org> <20021211193350.GC12310@panix.com>
Mime-Version: 1.0
Content-Type: multipart/mixed; boundary="W/nzBZO5zC0uMSeA"
Content-Disposition: inline
In-Reply-To: <20021211193350.GC12310@panix.com>
User-Agent: Mutt/1.4i
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


--W/nzBZO5zC0uMSeA
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

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.


--W/nzBZO5zC0uMSeA
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="handbook-id.patch"

*** /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

--W/nzBZO5zC0uMSeA--

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message