Return-Path: owner-LDP-L@cornell.edu
Received: from listproc.mail.cornell.edu (LISTPROC.MAIL.CORNELL.EDU [132.236.56.14]) by keos.Helsinki.FI (8.6.9/H46) with SMTP id JAA06860 for <LARS.WIRZENIUS@CS.HELSINKI.FI>; Fri, 18 Nov 1994 09:45:28 +0200
Received: from host ([127.0.0.1]) by listproc.mail.cornell.edu with SMTP id <93785-8>; Fri, 18 Nov 1994 02:39:35 -0500
Received: from cornell.edu ([132.236.56.6]) by listproc.mail.cornell.edu with SMTP id <93521-1>; Fri, 18 Nov 1994 01:14:31 -0500
Received: from cornell.edu (PHQUERY) by cornell.edu with cornell-phquery id <372752-4>; Fri, 18 Nov 1994 01:14:24 -0500
Received: from rasty.anu.edu.au ([150.203.15.214]) by cornell.edu with SMTP id <372803-2>; Fri, 18 Nov 1994 01:14:01 -0500
Received: by rasty.anu.edu.au id AA01006
  (5.67b/IDA-1.4.4 for LDP-L@cornell.edu); Fri, 18 Nov 1994 17:10:44 +1100
Message-Id: <199411180610.AA01006@rasty.anu.edu.au>
Date: 	Fri, 18 Nov 1994 02:10:44 -0500
Reply-To: LDP-L@cornell.edu
Sender: owner-LDP-L@cornell.edu
From: Paul Gortmaker <paul@RASTY.ANU.EDU.AU>
To: Linux Documentation Project writers <LDP-L@cornell.edu>
Subject: Re: Some comments
In-Reply-To: <199411180518.QAA02924@extro.ucc.su.OZ.AU> from "Terry Dawson" at Nov 18, 94 00:18:49 am
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
X-PH: V4.1@cornell.edu (Cornell Modified) 
X-Mailer: ELM [version 2.4 PL17]
X-Listprocessor-Version: 7.1 -- ListProcessor by CREN
Content-Length: 2046
Status: RO
X-Status: 

> 
> 
> > One thing that I noted that needs doing is the nroff/ascii version
> > doesn't get a table of contents. Seeing as it is still probably the
> > most used/avail format for the end user, this is probably significant.
> 
> I've actually had readers complain of just this.

Yay! I'm not alone.

> 
> > 	grep '^  [0-9]' Ethernet-HOWTO > index
> 
> <nod> It doesn't work terribly reliably in the NET-2-HOWTO because certain
> IP addresses end up formatted into places that look like section headings,
> but this is pretty close to being reliable.

That is why I said you have to edit out the bogus entries caused by lines
that begin with numbers.   :-)

> It gets my vote as worth addressing.
> 
> I would dearly like to be able to have SGML cope with pictures.
> I imagine something like it handling images as per usual fashion for
> HTML or Tex, and for nroff/text it just including a:
> 
> (refer diagram fname.gif)
> 
> where fname.gif is the name of the graphic to be included.
> 
> I envisage something like:
> 
> <pic title="diagram 1", name="fname.gif", options="centred">
> 
> I profess to not have any idea how practical this would be, but it would be
> really nice to be able to incorporate graphics

I have never used it (yet), but I note that the LaTeX and html mappings
have an entry like:

<eps>           +       "<EPS FILE=\"[FILE]\">"  +
</eps>

I have tried to avoid stuff like this, as it will only annoy the poor
ascii-nroff reader, which we *must not* lose sight of. In my case, if
you are reading an html version of the Ethernet-Howto, then you must
already be running ethernet, and hence not need the howto to begin
with! (Unless using another unix OS that supports www...) Get it?

Paul.
---------------------------------------------------------------------------
Paul Gortmaker - Department of Electronics Materials Engineering,
c/o The Research School of Physical Sciences and Engineering,
The Australian National University, Canberra ACT, 0020.
Ph (06) 249 0374  Fax: (06) 249 0511  E-mail: paul@rasty.anu.edu.au


