189 lines
7.6 KiB
HTML
189 lines
7.6 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: Requiring use of DocBook; LinuxDoc -->
|
|
<!--X-From-R13: Unel Berpxfubg <tneeryyNvaernpu.pbz> -->
|
|
<!--X-Date: Sun, 25 Jun 2000 23:46:38 -0400 (EDT) -->
|
|
<!--X-Message-Id: 3956CFA8.D3982264@inreach.com -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: 3955B73F.B0387DF9@inreach.com -->
|
|
<!--X-Reference: 20000625175950.B9275@aphid.net -->
|
|
<!--X-Reference: 3955BE7D.46A3CE94@inreach.com -->
|
|
<!--X-Reference: 39565FBE.B779EADC@cgipc.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:garrell@inreach.com">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg03025.html">Date Prev</a>][<a href="msg03027.html">Date Next</a>][<a href="msg03014.html">Thread Prev</a>][<a href="msg03030.html">Thread Next</a>][<a href="maillist.html#03026">Date Index</a>][<a href="threads.html#03026">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>: Gary Preckshot <<A HREF="mailto:garrell@inreach.com">garrell@inreach.com</A>></li>
|
|
<li><em>Date</em>: Sun, 25 Jun 2000 20:36:08 -0700</li>
|
|
<li><em>References</em>: <<a href="msg03004.html">3955B73F.B0387DF9@inreach.com</a>> <<a href="msg03005.html">20000625175950.B9275@aphid.net</a>> <<a href="msg03008.html">3955BE7D.46A3CE94@inreach.com</a>> <<a href="msg03014.html">39565FBE.B779EADC@cgipc.com</a>></li>
|
|
<li><em>Resent-date</em>: Sun, 25 Jun 2000 23:46: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>: <4pG_JC.A.7U.wItV5@murphy></li>
|
|
<li><em>Resent-sender</em>: <A HREF="mailto:ldp-discuss-request@lists.debian.org">ldp-discuss-request@lists.debian.org</A></li>
|
|
</ul>
|
|
<!--X-Head-of-Message-End-->
|
|
<!--X-Head-Body-Sep-Begin-->
|
|
<hr>
|
|
<!--X-Head-Body-Sep-End-->
|
|
<!--X-Body-of-Message-->
|
|
<pre>
|
|
Mark Komarinski wrote:
|
|
>
|
|
> Gary Preckshot wrote:
|
|
> >
|
|
> > Jeff Waugh wrote:
|
|
> >
|
|
> > > * Not removing from DocBook, removing from example. Read into it a little
|
|
> > > harder, please, without issuing a flame.
|
|
> >
|
|
> > I think you have a low ignition temperature.
|
|
>
|
|
> Tossing gasoline followed by a lit match doesn't help either.
|
|
>
|
|
> >
|
|
> > There seem to be a lot of people who'd rather use LinuxDoc.
|
|
> > Their posts seem to describe DocBook as anything but
|
|
> > "straightforward." Certainly, there's a subset of folks that
|
|
> > think DocBook is too big for their computers.
|
|
>
|
|
> So far I count one person. Two if you include yourself. That's not "a lot".
|
|
|
|
Strangely enough, Norman Walsh thought there were enough
|
|
people confused by DocBook that he produced a "simplified
|
|
DocBook." My comment implied that he was probably the only
|
|
one who could do it. If you think that's a flame, here's a
|
|
real flame: you think a lot of yourself don't you? See the
|
|
difference?
|
|
|
|
See <A HREF="http://www.nwalsh.com/docbook/simple/index.html">http://www.nwalsh.com/docbook/simple/index.html</A> for
|
|
Norman Walsh's simplified DocBook. It's probably relevant to
|
|
this discussion and to your tutorial.
|
|
|
|
>
|
|
> > >
|
|
> > > * Do you think DB:TDG is bad resource?
|
|
> >
|
|
> > No, I think it's a reference, hardly a tutorial.
|
|
>
|
|
> The LAG/H-H is the tutorial, and references DB:TDG.
|
|
|
|
Tell me something I don't know.
|
|
|
|
>
|
|
> > >
|
|
> > > * As a documentation writer, you need only care about your DocBook. DSSSL is
|
|
> >
|
|
> > I need feedback. The ultimate objective is putting out
|
|
> > documentation that people can read, is it not? If I don't
|
|
> > know what effect the tags will have on the final product,
|
|
> > I'm running open-loop.
|
|
>
|
|
> You shouldn't care what the output look like, as long as it's legible. That's
|
|
> part of the glory of SGML over .doc or .rtf. There was a usability
|
|
> study a few years ago between TeX authors and MSWord writers. The MSWord
|
|
> people took much longer (maybe twice as long) because they spent that extra
|
|
> time arranging items on the page, while the TeX folk didn't have to worry
|
|
> about it.
|
|
|
|
That's a lot different than knowing what it will look like.
|
|
I still need to know something about the effect. If DocBook
|
|
is more efficient at achieving the effect that I want, I'm
|
|
all for it. However, I still need to know that what I'm
|
|
putting down will be some reasonable relation to what else I
|
|
write. With DocBook, the formatting software fulfills the
|
|
function of a very efficient secretary. I've always wanted
|
|
to see what was going out before approving final release.
|
|
|
|
SGML has another danger that has dogged authors since time
|
|
immemorial. That is, being quoted out of context. With the
|
|
markup, interested parties can pull anything they want out
|
|
of your work, and you may have no recourse.
|
|
|
|
>
|
|
> When I send a document to the LDP, I don't know exactly what it will look like
|
|
> when it's done, but I have a good idea. And that's good enough for me.
|
|
>
|
|
|
|
Fine. I'm still wrestling with getting that understanding.
|
|
|
|
Gary
|
|
|
|
|
|
--
|
|
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="03030" href="msg03030.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
<ul><li><em>From:</em> Jorge Godoy <godoy@conectiva.com></li></ul></li>
|
|
<li><strong><a name="03034" href="msg03034.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
<ul><li><em>From:</em> Mark Komarinski <markk@cgipc.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>
|
|
<li><strong><a name="03005" href="msg03005.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
<ul><li><em>From:</em> Jeff Waugh <jdub@aphid.net></li></ul></li>
|
|
<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>
|
|
<li><strong><a name="03014" href="msg03014.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
<ul><li><em>From:</em> Mark Komarinski <markk@cgipc.com></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg03025.html">SGML and Docbook documentation</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg03027.html">Re: SGML and Docbook documentation</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg03014.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg03030.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#03026"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#03026"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|