148 lines
6.5 KiB
HTML
148 lines
6.5 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: SGML tools aren't so great -->
|
|
<!--X-From-R13: Xbr Qbbcre <wbrNfjryygrpu.pbz> -->
|
|
<!--X-Date: Thu, 4 May 2000 23:51:00 -0400 (EDT) -->
|
|
<!--X-Message-Id: 391245D4.CF836BCD@swelltech.com -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: 391070BC.ECBE2128@inreach.com -->
|
|
<!--X-Reference: 14608.63840.669601.14098@sucia.home -->
|
|
<!--X-Reference: 391102C6.3D29BE4@inreach.com -->
|
|
<!--X-Reference: 391209ED.DEB9A53C@tiac.net -->
|
|
<!--X-Reference: 3912319A.7BA42D9C@inreach.com -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Re: SGML tools aren't so great</title>
|
|
<link rev="made" href="mailto:joe@swelltech.com">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg02271.html">Date Prev</a>][<a href="msg02273.html">Date Next</a>][<a href="msg02268.html">Thread Prev</a>][<a href="msg02464.html">Thread Next</a>][<a href="maillist.html#02272">Date Index</a>][<a href="threads.html#02272">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Re: SGML tools aren't so great</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: "<A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A>" <<A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A>></li>
|
|
<li><em>Subject</em>: Re: SGML tools aren't so great</li>
|
|
<li><em>From</em>: Joe Cooper <<A HREF="mailto:joe@swelltech.com">joe@swelltech.com</A>></li>
|
|
<li><em>Date</em>: Thu, 04 May 2000 22:53:56 -0500</li>
|
|
<li><em>References</em>: <<a href="msg02232.html">391070BC.ECBE2128@inreach.com</a>> <<a href="msg02251.html">14608.63840.669601.14098@sucia.home</a>> <<a href="msg02253.html">391102C6.3D29BE4@inreach.com</a>> <391209ED.DEB9A53C@tiac.net> <<a href="msg02268.html">3912319A.7BA42D9C@inreach.com</a>></li>
|
|
<li><em>Resent-date</em>: Thu, 4 May 2000 23:51:00 -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>: <D1jrW.A.DtH.dUkE5@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>Sender</em>: <A HREF="mailto:joebuck@mail.swelltech.com">joebuck@mail.swelltech.com</A></li>
|
|
</ul>
|
|
<!--X-Head-of-Message-End-->
|
|
<!--X-Head-Body-Sep-Begin-->
|
|
<hr>
|
|
<!--X-Head-Body-Sep-End-->
|
|
<!--X-Body-of-Message-->
|
|
<pre>
|
|
Gary Preckshot wrote:
|
|
>
|
|
> It's certainly the most obvious defect of the emacs help system. I want to quit. What
|
|
> I want to know is how to quit. If I knew how to quit, I wouldn't be asking the "help"
|
|
> system how to quit. Emacs help could use reorientation - deal with the basics of
|
|
> editing and make them findable by terms ordinary human beings use to describe them,
|
|
> like quit, find, save, delete, cursor, move, insert, you know, simple terms.
|
|
>
|
|
> The HOWTO HOWTO should maybe address this issue. HOWTO authors would be more helpful
|
|
> if they addressed how to first and why in later chapters. Instead, they follow the
|
|
> usual nerd practice (there's that word again) of explaining everything adnauseum and
|
|
> finally getting to the point. Maybe there should be a style manual.
|
|
|
|
I totally agree with this assessment of the Emacs documentation. Maybe
|
|
you should forward this email to the GNU info writers! ;-) I HATE the
|
|
GNU 'info' pages (man pages stripped of useful content and with an
|
|
atrocious user interface is more like it). One would think from reading
|
|
the info pages that examples are a sin. There must be some provision of
|
|
the GNU bylaws that disallows examples. "Any GNU member found providing
|
|
a useful example shall be drawn, quartered, and forced to single task
|
|
for all eternity under MSDOS V2.0."
|
|
|
|
I agree that perhaps HOWTOs should nearly always focus on how to do
|
|
something first in plain terms and then move on to theory and a complete
|
|
explanation of what the examples provided earlier are doing and how.
|
|
Sort of:
|
|
|
|
1. Build frog. Include good diagrams and directions.
|
|
2. Make it hop.
|
|
3. Chop it up and talk about its guts.
|
|
4. Put it back together and hopefully make frog hop higher and faster.
|
|
|
|
Optional step 5. Sweep excess frog parts under carpet and walk away
|
|
whistling trying to avoid looking guilty.
|
|
|
|
I think there are quite a few good HOWTO's out there that do just that,
|
|
while others beat the bush and all surrounding terrain to a bloody pulp
|
|
before finally getting to the roots.
|
|
|
|
Just call me Mr. States The Obvious.
|
|
--
|
|
Joe Cooper <joe@swelltech.com>
|
|
Affordable Web Caching Proxy Appliances
|
|
<A HREF="http://www.swelltech.com">http://www.swelltech.com</A>
|
|
|
|
|
|
--
|
|
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="02232" href="msg02232.html">SGML tools aren't so great</a></strong>
|
|
<ul><li><em>From:</em> Gary Preckshot <garrell@inreach.com></li></ul></li>
|
|
<li><strong><a name="02251" href="msg02251.html">SGML tools aren't so great</a></strong>
|
|
<ul><li><em>From:</em> Tom Fawcett <fawcett@mindspring.com></li></ul></li>
|
|
<li><strong><a name="02253" href="msg02253.html">Re: SGML tools aren't so great</a></strong>
|
|
<ul><li><em>From:</em> Gary Preckshot <garrell@inreach.com></li></ul></li>
|
|
<li><strong><a name="02268" href="msg02268.html">Re: SGML tools aren't so great</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="msg02271.html">Re: if SGML is so great...</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg02273.html">Re: [blt] how do you tar a set of files for a package</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg02268.html">Re: SGML tools aren't so great</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg02464.html">Re: SGML tools aren't so great</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#02272"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#02272"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|