From owner-freebsd-commit  Mon Apr 10 14:47:50 1995
Return-Path: commit-owner
Received: (from majordom@localhost)
          by freefall.cdrom.com (8.6.10/8.6.6) id OAA08615
          for commit-outgoing; Mon, 10 Apr 1995 14:47:50 -0700
Received: (from majordom@localhost)
          by freefall.cdrom.com (8.6.10/8.6.6) id OAA08409
          for cvs-share-outgoing; Mon, 10 Apr 1995 14:46:17 -0700
Received: from grendel.csc.smith.edu (grendel.csc.smith.edu [131.229.222.23])
          by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id OAA08338
          ; Mon, 10 Apr 1995 14:45:46 -0700
Received: from localhost (jfieber@localhost) by grendel.csc.smith.edu (8.6.5/8.6.5) id RAA13809; Mon, 10 Apr 1995 17:46:33 -0400
From: jfieber@cs.smith.edu (John Fieber)
Message-Id: <199504102146.RAA13809@grendel.csc.smith.edu>
Subject: Re: cvs commit: src/share/FAQ/SGML adminman.sgml infosources.sgml
To: paul@isl.cf.ac.uk (Paul Richards)
Date: Mon, 10 Apr 1995 17:46:32 -0400 (EDT)
Cc: phk@ref.tfs.com, jfieber@cs.smith.edu, jfieber@freefall.cdrom.com,
        CVS-commiters@freefall.cdrom.com, cvs-share@freefall.cdrom.com
In-Reply-To: <199504102019.VAA26767@isl.cf.ac.uk> from "Paul Richards" at Apr 10, 95 09:19:29 pm
Content-Type: text
Content-Length: 1386      
Sender: commit-owner@FreeBSD.org
Precedence: bulk

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