[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Requiring use of DocBook; LinuxDoc
- To: LDP <>
- Subject: Re: Requiring use of DocBook; LinuxDoc
- From: Jeff Waugh <>
- Date: Sun, 25 Jun 2000 17:59:50 +1000
In-Reply-To: <3955B73F.B0387DF9@inreach.com>; from firstname.lastname@example.org on Sun, Jun 25, 2000 at 12:39:43AM -0700
- Mail-Followup-To: Jeff Waugh <email@example.com>,LDP <firstname.lastname@example.org>
- Resent-Date: Sun, 25 Jun 2000 03:59:38 -0400 (EDT)
- Resent-Message-ID: <yw0JkB.A.LuD.7vbV5@murphy>
- User-Agent: Mutt/1.2i
> > Ok, let's remove those unlikely to be useful in an HOWTO para ...
> That's likely to be a bit difficult, since the content model is set by the
> DTD. Removing the unuseful ones would require rewriting DocBook, a task I
> regard as very time intensive.
* Not removing from DocBook, removing from example. Read into it a little
harder, please, without issuing a flame.
> I've got better things to do with my time than pore over a very obscure
> content model.
* DocBook is not 'obscure', it's quite straightforward. Some constructs are
harder to understand than others, but that's because they're complicated
> BTW, DB:TDG looks like it's automatically generated from the DTD. It isn't
> really anything but the content model embedded in hypertext. Norman Walsh
> is no fool, nor is he spending much time writing books about DocBook.
* No, he isn't a fool, and neither are the *many* people generating
documentation from "non human-readbale" formats. Alan Cox is doing the
same thing with the kernel, and Java programmers have a similar utility.
Doing it any other way would be senseless.
* Do you think DB:TDG is bad resource?
> Why expend the effort when you can produce documentation at the touch of a
* Couldn't have said it better myself.
> I don't know. DSSSL controls the output formatting, and anyone using
> DocBook has the interaction of two definitions to concern themselves with.
> First, what does the DocBook tag really mean, and second, what does DSSSL
> think it means?
* As a documentation writer, you need only care about your DocBook. DSSSL is
left for others to worry about, and for good reason.
-- email@example.com ------------------------------------- firstname.lastname@example.org --
i: 16341281 (jdub!)
q: "In addition to these ample facilities, there exists a powerful
configuration tool called gcc." - Elliot Hughes, author of lwm
To UNSUBSCRIBE, email to email@example.com
with a subject of "unsubscribe". Trouble? Contact firstname.lastname@example.org