From owner-freebsd-doc  Mon Aug 28 21:53:29 1995
Return-Path: doc-owner
Received: (from majordom@localhost)
          by freefall.FreeBSD.org (8.6.11/8.6.6) id VAA11848
          for doc-outgoing; Mon, 28 Aug 1995 21:53:29 -0700
Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34])
          by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id VAA11842
          for <doc@freebsd.org>; Mon, 28 Aug 1995 21:53:27 -0700
Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.11/8.6.9) id XAA11178; Mon, 28 Aug 1995 23:53:03 -0500
From: John Fieber <jfieber@grendel.csc.smith.edu>
Message-Id: <199508290453.XAA11178@fieber-john.campusview.indiana.edu>
Subject: Re: how to do this?
To: chuckr@Glue.umd.edu (Chuck Robey)
Date: Mon, 28 Aug 1995 23:53:02 -0500 (EST)
Cc: doc@freebsd.org
In-Reply-To: <Pine.SUN.3.91.950829004155.12626K-100000@latte.eng.umd.edu> from "Chuck Robey" at Aug 29, 95 00:45:12 am
X-Mailer: ELM [version 2.4 PL24]
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Content-Length: 1330      
Sender: doc-owner@freebsd.org
Precedence: bulk

Chuck Robey writes:
> The sgmlfmt page says the sgmlfmt command takes two sets of flags, 
> -format and -links, but doesn't explain what the -links are..  Could you 
> either explain, or tell me I don't need them?

Huh?  It should say something.  The -link option didn't exist in
the version that came with 2.0.5.  Anyway...

     -links  When used with the -html option, for each <label id="foo"> in the
             document source sgmlfmt generates a symbolic link foo.html point-
             ing to the numbered .html file containing the reference.  Since
             the number of the file containing a particular section can change
             when a document is modified, this provides a convenient hook by
             which separate documents can provide links into another document
             without the links becoming invalid when the target document is
             modified.  When creating a symbolic link, any occurence of a
             slash (/) in label is replaced with percent (%), while any oc-
             curence of a space is replaced with an underscore (_).

Its very useful if you want to put these documents in a WWW
server and have links between them.  

-john

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