From owner-freebsd-doc  Mon Aug 28 21:59:19 1995
Return-Path: doc-owner
Received: (from majordom@localhost)
          by freefall.FreeBSD.org (8.6.11/8.6.6) id VAA12022
          for doc-outgoing; Mon, 28 Aug 1995 21:59:19 -0700
Received: from jolt.eng.umd.edu (jolt.eng.umd.edu [129.2.102.5])
          by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id VAA12015
          for <doc@freebsd.org>; Mon, 28 Aug 1995 21:59:17 -0700
Received: from latte.eng.umd.edu (latte.eng.umd.edu [129.2.98.15]) by jolt.eng.umd.edu (8.6.10/8.6.4) with ESMTP id AAA02258; Tue, 29 Aug 1995 00:59:15 -0400
Received: (chuckr@localhost) by latte.eng.umd.edu (8.6.10/8.6.4) id AAA13369; Tue, 29 Aug 1995 00:59:14 -0400
Date: Tue, 29 Aug 1995 00:59:14 -0400 (EDT)
From: Chuck Robey <chuckr@Glue.umd.edu>
To: John Fieber <jfieber@grendel.csc.smith.edu>
cc: doc@freebsd.org
Subject: Re: how to do this?
In-Reply-To: <199508290453.XAA11178@fieber-john.campusview.indiana.edu>
Message-ID: <Pine.SUN.3.91.950829005656.12626M@latte.eng.umd.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: doc-owner@freebsd.org
Precedence: bulk

On Mon, 28 Aug 1995, John Fieber wrote:

> 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 (_).

Ahh, I see, it's organized strangely.  At the top of that section, it 
says "The -format options for output include the following:"
so I kinda expected another heading for the -links option, not lumped in 
with the format options.  Maybe I think oddly.

> 
> 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 ============
> 

----------------------------+-----------------------------------------------
Chuck Robey                 | Interests include any kind of voice or data 
chuckr@eng.umd.edu          | communications topic, C programming, and Unix.
9120 Edmonston Ct #302      |
Greenbelt, MD 20770         | I run Journey2 and n3lxx, both FreeBSD
(301) 220-2114              | version 2.2 current -- and great FUN!
----------------------------+-----------------------------------------------