142 lines
5.4 KiB
HTML
142 lines
5.4 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
||
<!--X-Subject: Re: specifications -->
|
||
<!--X-From-R13: wqq <wqnavryqNqbqva.arg> -->
|
||
<!--X-Date: Thu, 11 May 2000 16:52:19 -0400 (EDT) -->
|
||
<!--X-Message-Id: 00051121533201.00562@charles -->
|
||
<!--X-Content-Type: text/plain -->
|
||
<!--X-Reference: 20000511234822.A13059@Frege.Corinda48 -->
|
||
<!--X-Head-End-->
|
||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
||
<html>
|
||
<head>
|
||
<title>Re: specifications</title>
|
||
<link rev="made" href="mailto:jdanield@dodin.net">
|
||
</head>
|
||
<body>
|
||
<!--X-Body-Begin-->
|
||
<!--X-User-Header-->
|
||
<!--X-User-Header-End-->
|
||
<!--X-TopPNI-->
|
||
<hr>
|
||
[<a href="msg02386.html">Date Prev</a>][<a href="msg02388.html">Date Next</a>][<a href="msg02385.html">Thread Prev</a>][<a href="msg02408.html">Thread Next</a>][<a href="maillist.html#02387">Date Index</a>][<a href="threads.html#02387">Thread Index</a>]
|
||
<!--X-TopPNI-End-->
|
||
<!--X-MsgBody-->
|
||
<!--X-Subject-Header-Begin-->
|
||
<h1>Re: specifications</h1>
|
||
<hr>
|
||
<!--X-Subject-Header-End-->
|
||
<!--X-Head-of-Message-->
|
||
<ul>
|
||
<li><em>To</em>: "Greg O'Keefe" <<A HREF="mailto:gcokeefe@postoffice.utas.edu.au">gcokeefe@postoffice.utas.edu.au</A>>, LDP Discuss <<A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A>></li>
|
||
<li><em>Subject</em>: Re: specifications</li>
|
||
<li><em>From</em>: jdd <<A HREF="mailto:jdanield@dodin.net">jdanield@dodin.net</A>></li>
|
||
<li><em>Date</em>: Thu, 11 May 2000 21:43:23 +0200</li>
|
||
<li><em>In-reply-to</em>: <<a href="msg02385.html">20000511234822.A13059@Frege.Corinda48</a>></li>
|
||
<li><em>References</em>: <<a href="msg02385.html">20000511234822.A13059@Frege.Corinda48</a>></li>
|
||
<li><em>Resent-date</em>: Thu, 11 May 2000 16:52:19 -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>: <p0L29.A.fXF.e1xG5@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>
|
||
On jeu, 11 mai 2000, Greg O'Keefe <20> <20>crit
|
||
|
||
>If specifications were available in a clever format, perhaps some
|
||
>for of sgml (uml?) some documentation could be generated from it.
|
||
>As could tests. Specifications could be made for existing software,
|
||
>by reverse engineering, or they could originate from the ldp.
|
||
|
||
problem is that free software is often a vacation time effort and so
|
||
documentation is out of scope.
|
||
|
||
I have tried to work so as a documentation provider a couple of times. I
|
||
found that
|
||
*it's nearly impossible to make documentation from specifications, most
|
||
actors can't simply cope with the initials specifications: too hard, too
|
||
difficult or the right library not available, not enough time... and so
|
||
the final product is an other product than previously seen.
|
||
*most of the time the sp<73>cification don't go out of the programmers'mind.
|
||
Here the programmer is his own client, so no real spec necessity. To make
|
||
the project leader write down its mind, or simply speak about it 'for me
|
||
to write) is impossible. Usually I found myself workless, the programmer
|
||
making himself his doc.
|
||
|
||
But an idea calls an other... what we could propose should be:
|
||
|
||
"the Man page compagnon"
|
||
|
||
may be a man (ldp) as is an man (1) or a man (8).
|
||
|
||
everybody must have seen that man page are usually awfull, just a reminder
|
||
for somebody who kows already the facts.
|
||
|
||
couldn't we propose an additive to the man page with beginners survey and
|
||
learning example. This could be done with the original program author, but
|
||
not necessary and should be much more man page related than the actual
|
||
HOWTO.
|
||
|
||
|
||
|
||
--
|
||
<<A HREF="http://www.dodin.net">http://www.dodin.net</A>> <<A HREF="mailto:jdanield@dodin.net">mailto:jdanield@dodin.net</A>>
|
||
QUI EST CET HOMME ? Aidez-moi <20> le retrouver
|
||
WHO'S THAT GUY ? Help me find him.
|
||
<A HREF="http://www.dodin.net/serge/index.html">http://www.dodin.net/serge/index.html</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>
|
||
<ul><li><strong>Follow-Ups</strong>:
|
||
<ul>
|
||
<li><strong><a name="02408" href="msg02408.html">Re: specifications</a></strong>
|
||
<ul><li><em>From:</em> "Greg O'Keefe" <gcokeefe@postoffice.utas.edu.au></li></ul></li>
|
||
</ul></li></ul>
|
||
<!--X-Follow-Ups-End-->
|
||
<!--X-References-->
|
||
<ul><li><strong>References</strong>:
|
||
<ul>
|
||
<li><strong><a name="02385" href="msg02385.html">specifications</a></strong>
|
||
<ul><li><em>From:</em> "Greg O'Keefe" <gcokeefe@postoffice.utas.edu.au></li></ul></li>
|
||
</ul></li></ul>
|
||
<!--X-References-End-->
|
||
<!--X-BotPNI-->
|
||
<ul>
|
||
<li>Prev by Date:
|
||
<strong><a href="msg02386.html">RE: To Do Task #21</a></strong>
|
||
</li>
|
||
<li>Next by Date:
|
||
<strong><a href="msg02388.html">Returned mail: Local configuration error</a></strong>
|
||
</li>
|
||
<li>Previous by thread:
|
||
<strong><a href="msg02385.html">specifications</a></strong>
|
||
</li>
|
||
<li>Next by thread:
|
||
<strong><a href="msg02408.html">Re: specifications</a></strong>
|
||
</li>
|
||
<li>Index(es):
|
||
<ul>
|
||
<li><a href="maillist.html#02387"><strong>Date</strong></a></li>
|
||
<li><a href="threads.html#02387"><strong>Thread</strong></a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
|
||
<!--X-BotPNI-End-->
|
||
<!--X-User-Footer-->
|
||
<!--X-User-Footer-End-->
|
||
</body>
|
||
</html>
|