205 lines
8.4 KiB
HTML
205 lines
8.4 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: Authorship -->
|
|
<!--X-From-R13: [nex Ybznevafxv <znexxNptvcp.pbz> -->
|
|
<!--X-Date: Fri, 2 Jun 2000 21:23:40 -0400 (EDT) -->
|
|
<!--X-Message-Id: 39386048.F1B4E223@cgipc.com -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: A5F46F4ED18FD211ABEE00105AC6CF070109372B@email.cu-portland.edu -->
|
|
<!--X-Reference: 00060200564802.15478@localhost.localdomain -->
|
|
<!--X-Reference: 39377587.8849BE67@club-internet.fr -->
|
|
<!--X-Reference: 3937B020.FAC301D8@cgipc.com -->
|
|
<!--X-Reference: 393801D2.D1376188@inreach.com -->
|
|
<!--X-Reference: 39385700.9F06B945@swelltech.com -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Re: Authorship</title>
|
|
<link rev="made" href="mailto:markk@cgipc.com">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg02632.html">Date Prev</a>][<a href="msg02634.html">Date Next</a>][<a href="msg02632.html">Thread Prev</a>][<a href="msg02636.html">Thread Next</a>][<a href="maillist.html#02633">Date Index</a>][<a href="threads.html#02633">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Re: Authorship</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: Joe Cooper <<A HREF="mailto:joe@swelltech.com">joe@swelltech.com</A>></li>
|
|
<li><em>Subject</em>: Re: Authorship</li>
|
|
<li><em>From</em>: Mark Komarinski <<A HREF="mailto:markk@cgipc.com">markk@cgipc.com</A>></li>
|
|
<li><em>Date</em>: Fri, 02 Jun 2000 21:32:56 -0400</li>
|
|
<li><em>Cc</em>: LDP <<A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A>></li>
|
|
<li><em>References</em>: <<a href="msg02608.html">A5F46F4ED18FD211ABEE00105AC6CF070109372B@email.cu-portland.edu</a>> <<a href="msg02619.html">00060200564802.15478@localhost.localdomain</a>> <<a href="msg02622.html">39377587.8849BE67@club-internet.fr</a>> <<a href="msg02627.html">3937B020.FAC301D8@cgipc.com</a>> <<a href="msg02631.html">393801D2.D1376188@inreach.com</a>> <<a href="msg02632.html">39385700.9F06B945@swelltech.com</a>></li>
|
|
<li><em>Reply-to</em>: <A HREF="mailto:markk@cgipc.com">markk@cgipc.com</A></li>
|
|
<li><em>Resent-date</em>: Fri, 2 Jun 2000 21:23:40 -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>: <oJeYtD.A.xXC.Z4FO5@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>
|
|
Joe Cooper wrote:
|
|
>
|
|
> Gary Preckshot wrote:
|
|
> >
|
|
> > Mark Komarinski wrote:
|
|
> >
|
|
|
|
Uhm..I didn't write any of this. Wrong attribution lines?
|
|
|
|
> > Mark, you're getting some good feedback from new authors. David Merrill, Joe
|
|
> > Cooper, and Arnault Claden just told you that they're having real problems
|
|
> > getting the tools working. These are not old hands, but new authors whose
|
|
> > feedback is invaluable in determining how useful your howto is to the intended
|
|
> > audience. I'm just the most vocal of the set.
|
|
>
|
|
> Careful, Gary, not to speak too boldly in the name of other folks.
|
|
>
|
|
> I agree that the DocBook tools need better documentation. But I'm not
|
|
> of the opinion that we need better authoring tools. vi looks great to
|
|
> me with the lovely syntax highlighting. Fast, familiar, and easy.
|
|
>
|
|
> All I want from the HOWTO-HOWTO is this:
|
|
>
|
|
> 1. Get the DocBook stuff here.
|
|
> 2. Install it this way.
|
|
|
|
Some of this depends on what distro you're using, and what tools you want to
|
|
use. So far I've documented sgmltools on Red Hat and Debian, and Cygnus tools
|
|
on RedHat, and the do-it-yourself method which should work on any distro, or
|
|
probably any *IX.
|
|
|
|
> 3. Put this DTD here and do this to make it available.
|
|
|
|
My latest rev is documenting this.
|
|
|
|
> 4. Here's an example of DocBook SGML. Here's a template, too.
|
|
|
|
This is being worked on outside what I'm doing. There are SGML templates that
|
|
I'll probably link to.
|
|
|
|
> 5. Type this command to convert your SGML file into these formats.
|
|
|
|
Also being worked on. But also depends on what tools you use.
|
|
|
|
> 6. Send the SGML file here so it can be included in the LDP.
|
|
|
|
Already done.
|
|
|
|
> 7. Thank you for helping the LDP.
|
|
|
|
Ooh. Didn't think of that.
|
|
|
|
>
|
|
> I think Mark has very nearly covered that just fine in only one of the
|
|
> chapters. It's still a little rough...but getting better. The
|
|
> reference to Godoy's DocBook HOWTO maybe a problem...since that HOWTO is
|
|
> confusing, to me anyway.
|
|
|
|
I'm one for practical examples, and I'm starting to include some tips
|
|
and tricks based off what I've run into (using mediaobject instead of
|
|
graphic, for example). Hopefully, the H-H will be a good SGML example.
|
|
|
|
> > 2) It defuses the responsibility for a coherent policy to several squabbling
|
|
> > authors.
|
|
>
|
|
> The LDP _is_ a bunch of squabbling authors. No need for it to stop
|
|
> being that. But the basics ought to be made clear, and respected by
|
|
> all. The basics, in my mind, being:
|
|
>
|
|
> - DocBook SGML == Good || LinuxDoc SGML == Ok, but not forever
|
|
> - Use your favorite text editor, here's a template that we think
|
|
> represents the right style for LDP docs
|
|
> - Don't invent your own system of grammar
|
|
> - Don't try to push your own political/social/computer/business ends via
|
|
> the LDP
|
|
> - Be sure to listen to comments from readers and take them to heart the
|
|
> next time you are revising your document
|
|
|
|
Hee. Good ideas.
|
|
|
|
> The notion of catering to Windows users or converting Windows users to
|
|
> Linux doesn't really seem a worthy goal. Yes, I consulted the HOWTO's
|
|
> like a bible when I was switching to Linux 2 years ago. But I don't
|
|
> believe the job of the LDP is to convert people, or to make it easy for
|
|
> Windows users to clutter up the LDP with irrelevent or ill-informed
|
|
> HOWTO's.
|
|
|
|
I think listing tools that work and are affordable is a good thing, no matter
|
|
the OS. I've corrected my WordPerfect comments because a reader has
|
|
reported success with it. Who am I as a Linux advocate and HOWTO author
|
|
to tell an author they must use Linux-only tools? I think it's fair to say
|
|
that we have a strong preference towards Linux tools, but if they work
|
|
and can be documented, why not list it?
|
|
|
|
-Mark
|
|
|
|
|
|
--
|
|
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>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<ul><li><strong>References</strong>:
|
|
<ul>
|
|
<li><strong><a name="02608" href="msg02608.html">RE: Authorship</a></strong>
|
|
<ul><li><em>From:</em> Gregory Leblanc <GLeblanc@cu-portland.edu></li></ul></li>
|
|
<li><strong><a name="02619" href="msg02619.html">RE: Authorship</a></strong>
|
|
<ul><li><em>From:</em> David Merrill <dcmerrill@mindspring.com></li></ul></li>
|
|
<li><strong><a name="02622" href="msg02622.html">Re: Authorship</a></strong>
|
|
<ul><li><em>From:</em> Arnault Claden <tiamat@club-internet.fr></li></ul></li>
|
|
<li><strong><a name="02627" href="msg02627.html">Re: Authorship</a></strong>
|
|
<ul><li><em>From:</em> Mark Komarinski <markk@cgipc.com></li></ul></li>
|
|
<li><strong><a name="02631" href="msg02631.html">Re: Authorship</a></strong>
|
|
<ul><li><em>From:</em> Gary Preckshot <garrell@inreach.com></li></ul></li>
|
|
<li><strong><a name="02632" href="msg02632.html">Re: Authorship</a></strong>
|
|
<ul><li><em>From:</em> Joe Cooper <joe@swelltech.com></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg02632.html">Re: Authorship</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg02634.html">Re: Authorship</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg02632.html">Re: Authorship</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg02636.html">Re: Authorship</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#02633"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#02633"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|