From owner-freebsd-doc  Mon Nov 20 18:22:49 1995
Return-Path: owner-doc
Received: (from root@localhost)
          by freefall.freebsd.org (8.6.12/8.6.6) id SAA09374
          for doc-outgoing; Mon, 20 Nov 1995 18:22:49 -0800
Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34])
          by freefall.freebsd.org (8.6.12/8.6.6) with ESMTP id SAA09361
          for <doc@freebsd.org>; Mon, 20 Nov 1995 18:22:46 -0800
Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.12/8.6.12) id VAA12299; Mon, 20 Nov 1995 21:22:23 -0500
Date: Mon, 20 Nov 1995 21:22:23 -0500 (EST)
From: John Fieber <jfieber@indiana.edu>
X-Sender: jfieber@fieber-john.campusview.indiana.edu
To: Ollivier Robert <roberto@keltia.freenix.fr>
cc: FreeBSD documentation list <doc@freebsd.org>
Subject: Re: sgmlfmt naming scheme
In-Reply-To: <199511202223.XAA03434@keltia.freenix.fr>
Message-ID: <Pine.BSF.3.91.951120211740.12290A-100000@fieber-john.campusview.indiana.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: owner-doc@freebsd.org
Precedence: bulk

On Mon, 20 Nov 1995, Ollivier Robert wrote:

> John, I have  a problem with sgmlfmt's  output file naming scheme. I've put
> link in the FAQ to several section in the handbook but as the filenames are
> automatically generated by sgmlfmt, there is no garantee that the link will
> be always pointing at the right thing... Or have I missing something ?

Yup.  With the -links option to sgmlfmt, if a <label id="foo"> occurs, 
and it corresponds with mydocument-98.html, a symbolic link will be 
generated  foo.html -> mydocument-98.html.  The numbering of the latter 
will change, but foo.html will always point to the right one.  

The hitch I ran into is that install can't install a symbolic link.   I'm 
going to have to re-think how it is done, but for the WWW server it 
works.  In the handbook directory, do a make FORMATS=html 
SGMLOPTS="-links" and see what links are there.  Alternately, grep for 
<label> tags.

-john

== jfieber@indiana.edu ===========================================
== http://fieber-john.campusview.indiana.edu/~jfieber ============