all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: crashedandburnt1@hotmail.com (Crashedandburnt)
Subject: Re: Program structure of Pstricks, what is its basic structure?
Date: 24 Feb 2004 00:51:13 -0800	[thread overview]
Message-ID: <42414174.0402240051.5e144b5e@posting.google.com> (raw)
In-Reply-To: x5ekslnovi.fsf@lola.goethe.zz

David Kastrup <dak@gnu.org> wrote in message news:<x5ekslnovi.fsf@lola.goethe.zz>...
> crashedandburnt1@hotmail.com (Crashedandburnt) writes:
> 
> >     effort. I help anonymously. We all know that there are numerous
> >     unsung heros of free software movement. Certainly, it is
> >     impossible to refer to them individually and it is easiest to
> >     give credit to them collectively by naming Stallman. But to ask
> >     me to write the doc by figuring it out is plain mischief.
> 
> Even Stallman himself would call this nonsense you write preposterous.
                                   ^^^^
what nonsense? If you quote rather than using pronouns, you would be
better understood.

> He is not out for recognition of himself, but for the GNU project.
> And not for some general goodness or whatever, but for recognition
> where it actually employed, namely in GNU/Linux systems.

What did I say that is in contradiction to your above para beginning,
"He is ...." Don't put words in my mouth, please.

> And how do you think documentation comes into being?  By writing
> itself magically?

The easiest way is for the author or those who understand it well to 
document it at the peak of their understanding.

> > I recall, you said in the conversation that you spent "just too much
> > time" on it.
>
> If any such communication has happened (which I consider quite
> unlikely), this is and remains a valid reply.  You are entitled to
> what you bargained for, and for nothing else.
> 
> > But the point is that when one spends so much time on writing a
> > package, refining it and then writing about 76 page pairs of user
> > manual, it is not much effort to document the workings of the
> > package for others to learn and benefit from, since it was put in
> > the public domain.
> 
> Good, then write a pstricks replacement, 76 page pairs of user manual
> and document the workings of the package for others to learn and
> benefit from.  Blessings, honour and power be unto you.
> 
> Until then, shut up.

Mr. Kastrup:
I am a free man and cannot give up my right to speak. I do not tell
you to shut up. You are free to present your case, and I mine.

Answer this: How many visitors, or posters on ctt or clp do you think
will understand the code when they ask such basic questions daily that
you have to explain, even though they are all explained in Knuth's
book or code?

I think, I have a valid point. The documentation needs to be improved.

It is incomprehensible to the majority. And since you are one of those
who
explains tex, most posters will not come out to dispute with you, but
they secretly agree with me that documentation is not good enough.
That is why I argue that if the regular stream of posting consists of
simple questions, it is impossible that they would understand this
code in a reasonable time.

I might give an analogy. It is a class in which few students
understand
the prof. The rest are afraid of criticising. Most don't know if it
is their fault, or that of prof.

In the coming days, the ability of people to explain the subject
of this thread will itself testify how well it is documented.

In the coming days, the ability of people to explain the subject
of this thread will itself testify how well it is documented.

  reply	other threads:[~2004-02-24  8:51 UTC|newest]

Thread overview: 20+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <m3n07dv5xj.fsf@pdrechsler.fqdn.th-h.de>
     [not found] ` <QY8DY60K38039.536875@Gilgamesh-Frog.org>
     [not found]   ` <c1a78u$6bm$01$1@news.t-online.com>
2004-02-23  3:53     ` Program structure of Pstricks, what is its basic structure? Crashedandburnt
2004-02-23 10:52       ` Giuseppe Bilotta
2004-02-24  0:36         ` Crashedandburnt
2004-02-23 14:18       ` Tim McNamara
2004-02-23 14:52       ` Timothy Van Zandt
2004-02-24  0:04         ` Crashedandburnt
2004-02-24  3:10           ` Tim McNamara
2004-02-24  7:49             ` Brooks Moses
2004-02-24  8:15             ` Crashedandburnt
2004-02-24  8:39               ` David Kastrup
2004-02-24 16:28                 ` R. H. Allen
2004-02-24  3:21           ` David Kastrup
2004-02-24  8:51             ` Crashedandburnt [this message]
2004-02-24  9:20               ` David Kastrup
2004-02-24 19:18               ` Tim McNamara
2004-02-24 15:08           ` Paul Thompson
2004-02-23 15:49       ` Timothy Van Zandt
2004-02-23 17:34         ` Donald Arseneau
2004-02-23 17:54       ` R. H. Allen
2004-02-24 15:23       ` Cameron Laird

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=42414174.0402240051.5e144b5e@posting.google.com \
    --to=crashedandburnt1@hotmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.