Date: Mon, 10 Apr 1995 17:46:32 -0400 (EDT) From: jfieber@cs.smith.edu (John Fieber) To: paul@isl.cf.ac.uk (Paul Richards) Cc: phk@ref.tfs.com, jfieber@cs.smith.edu, jfieber@freefall.cdrom.com, CVS-commiters@freefall.cdrom.com, cvs-share@freefall.cdrom.com Subject: Re: cvs commit: src/share/FAQ/SGML adminman.sgml infosources.sgml Message-ID: <199504102146.RAA13809@grendel.csc.smith.edu> In-Reply-To: <199504102019.VAA26767@isl.cf.ac.uk> from "Paul Richards" at Apr 10, 95 09:19:29 pm
next in thread | previous in thread | raw e-mail | index | archive | help
Paul Richards writes: > > Just now I think many of us are in favour of any kind of doc, no matter > > what bloat it adds to the tree, as compared to having no doc at all. > > But this is a silly argument. I'm all in favour of getting the docs but > there's little extra work involved in writing it in SGML rather than > HTML. It doesn't solve the underlying problem at all, we can't provide > LaTeX versions of these docs or anything else. Sorry, I don't quite follow this last paragraph. The docs are marked up according to the linuxdoc DTD. The point of using the SGML was to get a multitude of different output formats *including* LaTeX which can be generated quite easily. Outside of three very small html files in the root of the FAQ directory, nobody has written anything in HTML. > I'd rather see them written in SGML and at some point before release one > of use will have to sit down and port the conversion tools. Doing it > this way means no-one will ever have the incentive to fix the underlying > problem and we'll end up being stuck with it this way. Or the HTML directory is zapped and we include the tools to generate HTML, ascii, LaTeX or whatever during a make world. BTW, what was the underlying problem? -john === jfieber@cs.smith.edu ================================================ =================================== Come up and be a kite! --K. Bush ===
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199504102146.RAA13809>