160 lines
5.7 KiB
HTML
160 lines
5.7 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: Requiring use of DocBook; LinuxDoc -->
|
|
<!--X-From-R13: Xrss Inhtu <wqhoNncuvq.arg> -->
|
|
<!--X-Date: Sun, 25 Jun 2000 03:59:38 -0400 (EDT) -->
|
|
<!--X-Message-Id: 20000625175950.B9275@aphid.net -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: 3955B73F.B0387DF9@inreach.com -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Re: Requiring use of DocBook; LinuxDoc</title>
|
|
<link rev="made" href="mailto:jdub@aphid.net">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg03004.html">Date Prev</a>][<a href="msg03006.html">Date Next</a>][<a href="msg03004.html">Thread Prev</a>][<a href="msg03008.html">Thread Next</a>][<a href="maillist.html#03005">Date Index</a>][<a href="threads.html#03005">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Re: Requiring use of DocBook; LinuxDoc</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: LDP <<A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A>></li>
|
|
<li><em>Subject</em>: Re: Requiring use of DocBook; LinuxDoc</li>
|
|
<li><em>From</em>: Jeff Waugh <<A HREF="mailto:jdub@aphid.net">jdub@aphid.net</A>></li>
|
|
<li><em>Date</em>: Sun, 25 Jun 2000 17:59:50 +1000</li>
|
|
<li><em>In-reply-to</em>: <<a href="msg03004.html">3955B73F.B0387DF9@inreach.com</a>>; from garrell@inreach.com on Sun, Jun 25, 2000 at 12:39:43AM -0700</li>
|
|
<li><em>Mail-followup-to</em>: Jeff Waugh <jdub@aphid.net>,LDP <ldp-discuss@lists.linuxdoc.org></li>
|
|
<li><em>References</em>: <<a href="msg03004.html">3955B73F.B0387DF9@inreach.com</a>></li>
|
|
<li><em>Resent-date</em>: Sun, 25 Jun 2000 03:59:38 -0400 (EDT)</li>
|
|
<li><em>Resent-from</em>: <A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A></li>
|
|
<li><em>Resent-message-id</em>: <yw0JkB.A.LuD.7vbV5@murphy></li>
|
|
<li><em>Resent-sender</em>: <A HREF="mailto:ldp-discuss-request@lists.debian.org">ldp-discuss-request@lists.debian.org</A></li>
|
|
<li><em>User-agent</em>: Mutt/1.2i</li>
|
|
</ul>
|
|
<!--X-Head-of-Message-End-->
|
|
<!--X-Head-Body-Sep-Begin-->
|
|
<hr>
|
|
<!--X-Head-Body-Sep-End-->
|
|
<!--X-Body-of-Message-->
|
|
<pre>
|
|
> > 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
|
|
constructs.
|
|
|
|
|
|
> 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
|
|
> key?
|
|
|
|
|
|
* 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.
|
|
|
|
|
|
- Jeff
|
|
|
|
|
|
-- jdub@aphid.net ------------------------------------- jdub@linux.org.au --
|
|
|
|
w: <A HREF="http://www.slug.org.au/">http://www.slug.org.au/</A>
|
|
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 ldp-discuss-request@lists.debian.org
|
|
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
|
|
|
|
</pre>
|
|
|
|
<!--X-Body-of-Message-End-->
|
|
<!--X-MsgBody-End-->
|
|
<!--X-Follow-Ups-->
|
|
<hr>
|
|
<ul><li><strong>Follow-Ups</strong>:
|
|
<ul>
|
|
<li><strong><a name="03008" href="msg03008.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
<ul><li><em>From:</em> Gary Preckshot <garrell@inreach.com></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<ul><li><strong>References</strong>:
|
|
<ul>
|
|
<li><strong><a name="03004" href="msg03004.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
<ul><li><em>From:</em> Gary Preckshot <garrell@inreach.com></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg03004.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg03006.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg03004.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg03008.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#03005"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#03005"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|