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 ; 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 To: Linux Documentation Project writers 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 > > 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: > > > > 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: + "" + 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 .