210 lines
8.0 KiB
HTML
210 lines
8.0 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: Requiring use of DocBook; LinuxDoc -->
|
|
<!--X-From-R13: Rnivq Znjlre <qnirNynsa.bet> -->
|
|
<!--X-Date: Sat, 24 Jun 2000 03:52:50 -0400 (EDT) -->
|
|
<!--X-Message-Id: 20000623144053.A291@localhost -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: 20000622173003.A559@localhost -->
|
|
<!--X-Reference: Pine.LNX.4.21.0006230601470.15451-100000@crazypenguins.commandprompt.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:dave@lafn.org">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg02990.html">Date Prev</a>][<a href="msg02992.html">Date Next</a>][<a href="msg02993.html">Thread Prev</a>][<a href="msg03010.html">Thread Next</a>][<a href="maillist.html#02991">Date Index</a>][<a href="threads.html#02991">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>: Poet/Joshua Drake <<A HREF="mailto:poet@linuxports.com">poet@linuxports.com</A>></li>
|
|
<li><em>Subject</em>: Re: Requiring use of DocBook; LinuxDoc</li>
|
|
<li><em>From</em>: David Lawyer <<A HREF="mailto:dave@lafn.org">dave@lafn.org</A>></li>
|
|
<li><em>Date</em>: Fri, 23 Jun 2000 14:40:54 -0700</li>
|
|
<li><em>Cc</em>: David Lawyer <<A HREF="mailto:dave@lafn.org">dave@lafn.org</A>>, Mark Komarinski <<A HREF="mailto:markk@cgipc.com">markk@cgipc.com</A>>, Guylhem Aznar <<A HREF="mailto:guylhem@metalab.unc.edu">guylhem@metalab.unc.edu</A>>, Greg Ferguson <<A HREF="mailto:gferg@hoop.timonium.sgi.com">gferg@hoop.timonium.sgi.com</A>>, Gregory Leblanc <<A HREF="mailto:GLeblanc@cu-portland.edu">GLeblanc@cu-portland.edu</A>>, Taketoshi Sano <<A HREF="mailto:kgh12351@nifty.ne.jp">kgh12351@nifty.ne.jp</A>>, Stein Gjoen <<A HREF="mailto:sgjoen@mail.nyx.net">sgjoen@mail.nyx.net</A>></li>
|
|
<li><em>In-reply-to</em>: <<a href="msg02993.html">Pine.LNX.4.21.0006230601470.15451-100000@crazypenguins.commandprompt.com</a>></li>
|
|
<li><em>References</em>: <<a href="msg02990.html">20000622173003.A559@localhost</a>> <<a href="msg02993.html">Pine.LNX.4.21.0006230601470.15451-100000@crazypenguins.commandprompt.com</a>></li>
|
|
<li><em>Resent-date</em>: Sat, 24 Jun 2000 00:23:19 -0700</li>
|
|
<li><em>Resent-from</em>: <A HREF="mailto:dave@lafn.org">dave@lafn.org</A></li>
|
|
<li><em>Resent-message-id</em>: <E135kHf-00004L-00@davespc></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>Resent-to</em>: <A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A></li>
|
|
<li><em>User-agent</em>: Mutt/1.0pre3i</li>
|
|
</ul>
|
|
<!--X-Head-of-Message-End-->
|
|
<!--X-Head-Body-Sep-Begin-->
|
|
<hr>
|
|
<!--X-Head-Body-Sep-End-->
|
|
<!--X-Body-of-Message-->
|
|
<pre>
|
|
[ Regarding David Lawyer's proposal to continue to allow use of LinuxDoc
|
|
for new authors]
|
|
On Fri, Jun 23, 2000 at 06:06:33AM -0700, Poet/Joshua Drake wrote:
|
|
>
|
|
> I disagree completely, we should not change the LinuxDoc rule.
|
|
|
|
I never saw any "rule" posted that we would no longer accept LinuxDoc
|
|
from new authors.
|
|
|
|
> DocBook is not difficult in any way if you use it like LinuxDoc.
|
|
> What I mean is, yes DocBook can be a total bear if you try and do a
|
|
> much of nifty crap with it but if you keep it simple it is no more
|
|
> difficult than LinuxDoc.
|
|
|
|
Not so. See my examples at the end of this message.
|
|
|
|
> In fact it is no harder than HTML.
|
|
|
|
Possilbly true but HTML is significantly more difficult than LinuxDoc.
|
|
|
|
> [snip] but I believe it is imperative that we continue pushing
|
|
> DocBook, aggressively. All the other major Documentation (outside of
|
|
> Debian) have switched to DocBook.
|
|
|
|
We have special needs in that we recruit rank amateurs who want the
|
|
writing format to be as simple as possible. Anyway, I'm not objecting
|
|
to people using DocBook that want to do so (including "rank
|
|
amateurs"). Thus while we too have already accepted DocBook I think
|
|
we should continue to accept LinuxDoc from anyone.
|
|
|
|
David Lawyer
|
|
#########################################################################
|
|
|
|
Comparison of DocBook to LinuxDoc (short).
|
|
by David Lawyer, June 23, 2000
|
|
|
|
Using DocBook instead of LinuxDoc requires many more tags and the tags
|
|
tend to be longer. The tag clutter makes DocBook harder to read.
|
|
Thus DocBook is not nearly as easy to do by hand (with an editor that
|
|
doesn't support it) as LinuxDoc.
|
|
|
|
LinuxDoc is quoted with LD; DocBook with DB.
|
|
-------------2---3--------- => DocBook has: 2 times as many tags;
|
|
3 times as many tag characters.
|
|
|
|
|
|
Example 1-------------------1.5---2------------------------------------
|
|
|
|
DB <sect>
|
|
DB <title>Introduction</title>
|
|
|
|
LD <sect>Introduction
|
|
LD <p>
|
|
|
|
Example 2--------------------2---3------------------------------------
|
|
|
|
DB <indexterm>
|
|
DB <primary>disk!introduction</primary>
|
|
DB </indexterm>
|
|
|
|
LD <nidx>disk!introduction</nidx>
|
|
|
|
Example 3--------------------infinite-------------------------------------
|
|
|
|
DB <para>
|
|
DB This is the text of a paragraph. LinuxDoc needs no tags for it.
|
|
DB </para>
|
|
|
|
LD This is the text of a paragraph. LinuxDoc needs no tags for it.
|
|
|
|
Example 4-------------1+--4-----In docB "release" must be typed twice------
|
|
|
|
DB <emphasis>release</emphasis> release.
|
|
|
|
LD <em>release</em>.
|
|
|
|
Example 5--------------3---3----You can't easily read the docB list---------
|
|
|
|
DB <ItemizedList>
|
|
DB <ListItem>
|
|
DB
|
|
DB <Para>
|
|
DB Use the "isapnp" program
|
|
DB </Para>
|
|
DB </ListItem>
|
|
DB <ListItem>
|
|
DB
|
|
DB <Para>
|
|
DB Have a PnP BIOS do the configuring
|
|
DB </Para>
|
|
DB </ListItem>
|
|
DB <ListItem>
|
|
DB
|
|
DB <Para>
|
|
DB Patch the kernel to create a PnP Linux (not currently available)
|
|
DB </Para>
|
|
DB </ListItem>
|
|
DB
|
|
DB </ItemizedList>
|
|
|
|
LD <itemize>
|
|
LD <item> Use the "isapnp" program
|
|
LD <item> Have a PnP BIOS do the configuring
|
|
LD <item> Patch the kernel to create a PnP Linux (not currently available)
|
|
LD </itemize>
|
|
|
|
|
|
--
|
|
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="03010" href="msg03010.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
<ul><li><em>From:</em> "Anthony E. Greene" <agreene@pobox.com></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<ul><li><strong>References</strong>:
|
|
<ul>
|
|
<li><strong><a name="02990" href="msg02990.html">Requiring use of DocBook; LinuxDoc</a></strong>
|
|
<ul><li><em>From:</em> David Lawyer <dave@lafn.org></li></ul></li>
|
|
<li><strong><a name="02993" href="msg02993.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
<ul><li><em>From:</em> Poet/Joshua Drake <poet@linuxports.com></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg02990.html">Requiring use of DocBook; LinuxDoc</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg02992.html">RE: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg02993.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg03010.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#02991"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#02991"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|