old-www/pub/Linux/docs/ldp-archived/mail_archives/ldp-discuss/msg03056.html

130 lines
5.1 KiB
HTML

<!-- MHonArc v2.5.0b2 -->
<!--X-Subject: Re: First pass for LDP&#45;Author&#45;Guide -->
<!--X-From-R13: Unel Znjerapr [hecul <tnelzNpnanqn.pbz> -->
<!--X-Date: Tue, 27 Jun 2000 10:59:24 &#45;0400 (EDT) -->
<!--X-Message-Id: m3u2ef2mro.fsf@maya.linux.ca -->
<!--X-Content-Type: text/plain -->
<!--X-Reference: 3958ABD8.4F171F49@cgipc.com -->
<!--X-Head-End-->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<html>
<head>
<title>Re: First pass for LDP-Author-Guide</title>
<link rev="made" href="mailto:garym@canada.com">
</head>
<body>
<!--X-Body-Begin-->
<!--X-User-Header-->
<!--X-User-Header-End-->
<!--X-TopPNI-->
<hr>
[<a href="msg03055.html">Date Prev</a>][<a href="msg03057.html">Date Next</a>][<a href="msg03054.html">Thread Prev</a>][<a href="msg03058.html">Thread Next</a>][<a href="maillist.html#03056">Date Index</a>][<a href="threads.html#03056">Thread Index</a>]
<!--X-TopPNI-End-->
<!--X-MsgBody-->
<!--X-Subject-Header-Begin-->
<h1>Re: First pass for LDP-Author-Guide</h1>
<hr>
<!--X-Subject-Header-End-->
<!--X-Head-of-Message-->
<ul>
<li><em>To</em>: <A HREF="mailto:markk@cgipc.com">markk@cgipc.com</A></li>
<li><em>Subject</em>: Re: First pass for LDP-Author-Guide</li>
<li><em>From</em>: Gary Lawrence Murphy &lt;<A HREF="mailto:garym@canada.com">garym@canada.com</A>&gt;</li>
<li><em>Date</em>: 27 Jun 2000 10:59:07 -0400</li>
<li><em>Cc</em>: <A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A></li>
<li><em>Organization</em>: T(c)Inc Business Innovation through Open Source Computing</li>
<li><em>References</em>: &lt;<a href="msg03054.html">3958ABD8.4F171F49@cgipc.com</a>&gt;</li>
<li><em>Reply-to</em>: Gary Lawrence Murphy &lt;<A HREF="mailto:garym@canada.com">garym@canada.com</A>&gt;</li>
<li><em>Resent-date</em>: Tue, 27 Jun 2000 10:59:24 -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>: &lt;jheaID.A.czG.eFMW5@murphy&gt;</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>Sender</em>: <A HREF="mailto:garym@maya.linux.ca">garym@maya.linux.ca</A></li>
</ul>
<!--X-Head-of-Message-End-->
<!--X-Head-Body-Sep-Begin-->
<hr>
<!--X-Head-Body-Sep-End-->
<!--X-Body-of-Message-->
<pre>
Bravo! Author! Author!
Just to make the book a little more clear and the TOC less daunting, I
would collect sections 2 and 4 to 7 into a subsection called &quot;Using
DocBook&quot; itself a subsection of Tools. Chapter 8 should also be moved
into the Tools section. This would make the book more to the purpose
of its title and less of a &quot;DocBook for LDP Authors&quot;, even though that
is really the bulk of the purpose of the book, which opens up future
expansion into subjects unrelated to the DocBook tools (such as &quot;How to
decide on a topic&quot; or &quot;Is this a HOWTO, a Guide or what?&quot;)
And don't forget our section on writing style (with instructions on how
to write technical Haiku!)
Also, we had a flurry of emails yesterday as we prep'ed Eric Raymond's
CML2 guide for DocBook; in the process I discovered the beauty of
using wdiff for collaborative docbook work: When piped into less,
wdiff shows his changes underlined, mine in bold, and it was trivial
to cut and paste the updates into the master document. What I'd
really like to know now is how to get those same effects using wdiff
within Emacs.
GUI editing tools should include TkSGML (best I've found so far next
to Emacs) and ConchB (has it been updated). You might also mention
just in passing the commercial softwares such as FrameMaker, Arbortext
and XMetal and the various DocBook mailing lists.
--
Gary Lawrence Murphy &lt;garym@linux.ca&gt;: office voice/fax: 01 519 4222723
TCI - Business Innovations through Open Source : <A HREF="http://www.teledyn.com">http://www.teledyn.com</A>
Love Linux? We need authors/reviewers - <A HREF="http://www.teledyn.com/authors">http://www.teledyn.com/authors</A>
--
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of &quot;unsubscribe&quot;. Trouble? Contact listmaster@lists.debian.org
</pre>
<!--X-Body-of-Message-End-->
<!--X-MsgBody-End-->
<!--X-Follow-Ups-->
<hr>
<!--X-Follow-Ups-End-->
<!--X-References-->
<ul><li><strong>References</strong>:
<ul>
<li><strong><a name="03054" href="msg03054.html">First pass for LDP-Author-Guide</a></strong>
<ul><li><em>From:</em> Mark Komarinski &lt;markk@cgipc.com&gt;</li></ul></li>
</ul></li></ul>
<!--X-References-End-->
<!--X-BotPNI-->
<ul>
<li>Prev by Date:
<strong><a href="msg03055.html">Who's in charge</a></strong>
</li>
<li>Next by Date:
<strong><a href="msg03057.html">Re: Requiring use of DocBook; LinuxDoc</a></strong>
</li>
<li>Previous by thread:
<strong><a href="msg03054.html">First pass for LDP-Author-Guide</a></strong>
</li>
<li>Next by thread:
<strong><a href="msg03058.html">Re: First pass for LDP-Author-Guide</a></strong>
</li>
<li>Index(es):
<ul>
<li><a href="maillist.html#03056"><strong>Date</strong></a></li>
<li><a href="threads.html#03056"><strong>Thread</strong></a></li>
</ul>
</li>
</ul>
<!--X-BotPNI-End-->
<!--X-User-Footer-->
<!--X-User-Footer-End-->
</body>
</html>