Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.debian.user > #176085

Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal")

From Xen <list@xenhideout.nl>
Newsgroups linux.debian.user
Subject Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal")
Date 2016-12-30 02:40 +0100
Message-ID <sTUkO-66g-9@gated-at.bofh.it> (permalink)
References (2 earlier) <sTJz3-7AW-7@gated-at.bofh.it> <sTNjk-1y0-25@gated-at.bofh.it> <sTNMl-1J3-9@gated-at.bofh.it> <sTNMl-1J3-19@gated-at.bofh.it> <sTNW1-1Mm-7@gated-at.bofh.it>
Organization linux.* mail to news gateway

Show all headers | View raw


Catherine Gramze schreef op 29-12-2016 19:47:
> On Thu, Dec 29, 2016 at 1:36 PM, Xen <list@xenhideout.nl> wrote:
> 
>> More importantly the man system or man format does not preclude such
>> documents being written as tutorials so basically it is being done
>> all around.
>> 
>> So your assertion here does not really have a basis in reality I
>> must say: the system does not preclude this from being done. People
>> can do it all they want, and they do it.
>> 
>> It is the people that insist on not doing it, that write poor man
>> pages.
> 
> ​I did not say the man page system precluded it, nor that no man
> page was written in such a manner. I stated the original purpose and
> design of the man page as a complete reference, and only a reference,
> and the futility of wishing that all man pages would be re-written to
> conform to your personal preferences.​ What you apparently consider
> to be a "poorly written" man page I find to be highly accessible and
> useful. Give me the command and the list of options, with a sentence
> or so explaining the function of each option. Done. I can figure out
> which options I need better than somebody not in my situation.
> Examples muddy up the page and make it harder to scan the options for
> what I need without adding any clarity to the function..

That's not what you said, dear sir. What you said was: "Trying to wish 
the man pages into something they were never designed to be is likely to 
be unsuccessful.".

Basically, you imply or directly state that their stated design goals 
would interfere with becoming more introductory-text-oriented material 
(more explanative, rather than just poorly descriptive). I think it is 
clearly evident that the man page is clearly freeform as much as people 
want it to be. So it is rather evident that the design goals do not 
interfere with anything. Now again you state "the original purpose and 
design of the man page" in conjunction with "the futility of thinking 
(wishing) that all man pages would be re-written to conform to your 
"personal preferences"" (my quote).

Any "original purpose and design" of the man page would only have any 
bearing if through historical reasons the majority of man pages were 
thus poorly constructed. I say that this is not even the case. Barring 
that, those "original purposes and design goals" have no bearing 
whatsoever on saying what can, and cannot be done. Moroever, this design 
goal could very well change, or by evolution people could decide that 
this design goal IS changing.

You go on by stating your personal preferences.

So I think we can conclude at least three things:

- you *are* implying that somehow the descriptive option-oriented format 
is technically or at least principally (if, at the last instance, 
historically) being favoured by some "design goals" that people once had 
for the system. (That could also have been poor, as it is now).

- you are the one who is using personal preferences as a reason for 
stuff to remain this way, not me. I am saying (and others are) that many 
users, in fact, users or new users in general, cannot use the man system 
to full extent because of these attitudes and opinions and styles of 
writing these documents. So that is not personal preference at all but 
rather the truth of how many experience this system.

I have said nothing about what I like or don't like. So you are the one 
who is using what you like and don't like (or what works for you and 
doesn't work for you) (I have not implicated my own person at all, thus 
far) -- I have merely described how the system works and what 
descriptive is and what task-oriented is.

So actually I think you are just projecting stuff onto me that really is 
something you are doing, not me.

And

- NO where have I stated any "wish" for "all man pages" to be rewritten 
according to those what you call "personal preferences" (actually they 
are what would work for the majority of new users to any program) (and 
what does work, and what many man page authors actually naturally and 
intuitively do) -- but you call it futile. You misinterpret my intent 
here little lady. I am not asking anyone to do any work.

I am simply saying there is no reason to keep man pages poor based on 
some pre-existing notion of what they were initially intended to be.

Basically, you can judge formats on their own merit also considering, or 
perhaps, predominantly also considering the position the man pages today 
have in the system, in which the "alternatives" are unusable, so "that's 
what /usr/share/doc is for" does not count. It doesn't work. No one goes 
there.

It's too much trouble. The man system is automated and organized. The 
/usr/share/doc system is manual labour. As far as I know at least?

I have certainly not ever seen any reference to this thing being 
automated, other than the dysfunctional "info" system.

There are no other good reference materials other than the man system.

Certainly not for users wanting to have a quick hands on introduction or 
guide into how to use the thing.

So saying "there are alternatives that do that thing" is just lies and 
fallacy. It's not true. It doesn't work. That is wishful thinking 
indeed.

It will never work the way it is, and it has never worked the way it is. 
Only the man system works.

You must accept first that the man system is pretty much the only viable 
"info" system we have in Linux in the console world.

And you will know that they are indeed used by all users as introductory 
texts. Here is Grep:

"grep  searches the named input FILEs (or standard input if no files are
named, or if a single hyphen-minus (-) is given as file name) for lines
containing  a  match to the given PATTERN.  By default, grep prints the
matching lines."

Well, that is pretty introductory isn't it? It tells you exactly how to 
use it. This is exactly what I mean, and exactly what is good writing.

What comes next is rather confusing, because it is so immaterial or 
irrelevant as to the main program at that point:

"In  addition,  three  variant  programs  egrep,  fgrep  and  rgrep  are
available.   egrep  is  the  same  as  grep -E.   fgrep  is the same as
grep -F.  rgrep is the same as grep -r.  Direct  invocation  as  either
egrep  or  fgrep  is  deprecated,  but  is provided to allow historical
applications that rely on them to run unmodified."

Not something that makes all that much sense, especially given that no 
one actually uses that (and it is deprecated, probably, because of it).

But still, that can be forgiven, the beginning is excellent.

The option descriptions are also just fine and the length of the 
document is just about right, not too long, not too short.

No issue with this man page except for that paragraph.

Now aufs:

"Aufs is a stackable unification filesystem such as Unionfs, which  uni‐
fies  several  directories  and provides a merged single directory.  In
the early  days,  aufs  was  entirely  re-designed  and  re-implemented
Unionfs  Version  1.x series. After many original ideas, approaches and
improvements, it becomes totally different from Unionfs  while  keeping
the  basic features.  See Unionfs Version 1.x series for the basic fea‐
tures.  Recently, Unionfs Version 2.x series begin taking some of  same
approaches to aufs's."

That's not a very concise intro. More historical than functional.

"At mount-time, the order of interpreting options is,

  ·   simple flags, except xino/noxino and udba=notify
  ·   branches
  ·   xino/noxino
  ·   udba=notify"

That's just incomprehensible. It doesn't start with the most common 
options, when it should. That's no quick introductory text, that is a 
complete manual written in a weird way. OpenSUSE does the same with some 
of their man-pages, which are like books. (Try "man zipper"). There is 
no point in starting out with ORDER of things if you haven't even 
explained what those things ARE.

Then the syntax is just incomprehensible to begin with, and the 
description of it also. That's just completely unusable until you see 
some examples. So you skip down to the end of this very long page. And 
then it is still hard to comprehend to see what it does and how it is 
used, because the example aren't explained. So you go on the web and 
find your answers instead. Dirt-poor man page. Much too long but that is 
not the worst part. Poorly organized, doesn't explain that the system 
functions around "branches" (directories) and that you can create mount 
points based on 2 or more branches, but that you can also add and delete 
those branches from a running system (running mount).

If it explained that _first_ then all of the other options would make 
*more sense*.

So it's just poor writing from my perspective. Doesn't give examples 
soon enough, and when it does give them they are too complicated. When 
most users just want to do this:

mount -t aufs -o br:upper-dir=rw:lower-dir=ro none target-dir

Aufs has only two ordinary use cases:

- upper dir and lower dir

- both dirs are writeable and will see writes going to their respective 
directories (on each "upper" directory)

If it would just explain those two use cases, people would get a clue. 
Now they have to hunt the internet for that same information.

Because there is no lead-in explanatory text, users are now basically 
forced to read the entirety of the man page before they start getting a 
clue, or hunt around bits of information. So the speed of reading this 
man page is now gone.



So miss Catherine you say you don't want examples and that you want a 
man page to be a clean and concise list of options. The aufs man page is 
clearly the opposite of that and it still fails to tutor people.

It lists all of the options, but it is a complex program and needs more 
explanation. However it does this in reverse order, first starting with 
something you cannot comprehend until you have read the remaining parts, 
and all of the options are basically incomprehensible until you get the 
full picture, which would not take more than 5 lines to address.

So precisely because it fails to answer a user's questions when they 
arise, this is a poorly written man page.

For simple programs, like Grep, fine, that format is excellent. There is 
no need to explain much and it is such a basic tool that the "quick and 
easy list of options" format is enough.

But aufs or something like autofs needs much more explanation. And it 
needs to do this in a "chronological" order starting with the stuff the 
user first needs to understand, and then going on with the next.

If you display options for a program that hasn't been explained, it 
doesn't work. You'll first have to say what the program does you know. 
Even the Grep example does that.

Back to linux.debian.user | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread


Thread

Why? -- "A Modest Proposal" Richard Owlett <rowlett@cloud85.net> - 2016-11-16 15:20 +0100
  Re: Why? -- "A Modest Proposal" Lisi Reisz <lisi.reisz@gmail.com> - 2016-11-16 16:00 +0100
    Re: Why? -- "A Modest Proposal" Jonathan Dowland <jmtd@debian.org> - 2016-11-16 16:20 +0100
      Re: Why? -- "A Modest Proposal" Lisi Reisz <lisi.reisz@gmail.com> - 2016-11-16 19:40 +0100
        Re: Why? -- "A Modest Proposal" Jonathan Dowland <jmtd@debian.org> - 2016-11-17 13:20 +0100
          Re: Why? -- "A Modest Proposal" Lisi Reisz <lisi.reisz@gmail.com> - 2016-11-17 15:30 +0100
            Re: Why? -- "A Modest Proposal" Jonathan Dowland <jmtd@debian.org> - 2016-11-17 15:50 +0100
    Re: Why? -- "A Modest Proposal" Richard Owlett <rowlett@cloud85.net> - 2016-11-17 15:50 +0100
      Re: Why? -- "A Modest Proposal" Lisi Reisz <lisi.reisz@gmail.com> - 2016-11-17 17:40 +0100
      Re: Why? -- "A Modest Proposal" Curt <curty@free.fr> - 2016-11-17 18:10 +0100
      Re: Why? -- "A Modest Proposal" kamaraju kusumanchi <raju.mailinglists@gmail.com> - 2016-11-22 06:40 +0100
  Re: Why? -- "A Modest Proposal" <tomas@tuxteam.de> - 2016-11-16 16:40 +0100
    Re: Why? -- "A Modest Proposal" Richard Owlett <rowlett@cloud85.net> - 2016-11-17 16:00 +0100
      Re: Why? -- "A Modest Proposal" "John L. Ries" <jries@salford-systems.com> - 2016-11-17 19:00 +0100
        Re: Why? -- "A Modest Proposal" Greg Wooledge <wooledg@eeg.ccf.org> - 2016-11-17 22:40 +0100
        Re: Why? -- "A Modest Proposal" <tomas@tuxteam.de> - 2016-11-17 22:40 +0100
        Re: Why? -- "A Modest Proposal" rhkramer@gmail.com - 2016-11-18 00:10 +0100
      Re: Why? -- "A Modest Proposal" <tomas@tuxteam.de> - 2016-11-17 22:30 +0100
        Re: Why? -- "A Modest Proposal" Greg Wooledge <wooledg@eeg.ccf.org> - 2016-11-17 22:40 +0100
          Re: Why? -- "A Modest Proposal" <tomas@tuxteam.de> - 2016-11-17 22:40 +0100
            Re: Why? -- "A Modest Proposal" Greg Wooledge <wooledg@eeg.ccf.org> - 2016-11-17 23:00 +0100
              Re: Why? -- "A Modest Proposal" Reco <recoverym4n@gmail.com> - 2016-11-18 09:20 +0100
          Re: Why? -- "A Modest Proposal" rhkramer@gmail.com - 2016-11-18 00:10 +0100
  Re: Why? -- "A Modest Proposal" emetib <chadbrabec@gmail.com> - 2016-11-18 09:50 +0100
    Re: Why? -- "A Modest Proposal" <tomas@tuxteam.de> - 2016-11-18 10:40 +0100
    Re: Why? -- "A Modest Proposal" "Thomas Schmitt" <scdbackup@gmx.net> - 2016-11-18 11:10 +0100
      Re: Why? -- "A Modest Proposal" emetib <chadbrabec@gmail.com> - 2016-11-18 20:30 +0100
      Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") cbannister@slingshot.co.nz - 2016-12-29 15:10 +0100
        Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-29 19:10 +0100
        Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-29 19:10 +0100
          Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Catherine Gramze <rhiamom@gmail.com> - 2016-12-29 19:40 +0100
            Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-29 19:40 +0100
            Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-29 19:40 +0100
              Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Catherine Gramze <rhiamom@gmail.com> - 2016-12-29 19:50 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-30 02:40 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") rhkramer@gmail.com - 2016-12-30 03:30 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-30 03:40 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Greg Wooledge <wooledg@eeg.ccf.org> - 2016-12-30 15:40 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? --  "A Modest Proposal") Dan Purgert <dan@djph.net> - 2016-12-30 18:00 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? --  "A Modest Proposal") Dan Purgert <dan@djph.net> - 2016-12-30 15:40 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") rhkramer@gmail.com - 2016-12-30 15:50 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") rhkramer@gmail.com - 2016-12-30 15:50 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-30 16:00 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") John Hasler <jhasler@newsguy.com> - 2016-12-30 17:20 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-31 08:30 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-31 09:50 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-31 10:40 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Catherine Gramze <rhiamom@gmail.com> - 2016-12-31 17:20 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2017-01-01 13:00 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2017-01-01 13:20 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2017-01-01 14:00 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Nemeth Gyorgy <friczy@freemail.hu> - 2016-12-31 10:40 +0100
                Re: Do have programs have poor documentation? "Thomas Schmitt" <scdbackup@gmx.net> - 2016-12-31 12:00 +0100
                Re: Do have programs have poor documentation? Xen <list@xenhideout.nl> - 2017-01-01 12:40 +0100
                Re: Do have programs have poor documentation? "Thomas Schmitt" <scdbackup@gmx.net> - 2017-01-01 14:10 +0100
                Re: Do have programs have poor documentation? Xen <list@xenhideout.nl> - 2017-01-01 19:10 +0100
                Re: Do have programs have poor documentation? "Thomas Schmitt" <scdbackup@gmx.net> - 2017-01-01 20:50 +0100
                Re: Do have programs have poor documentation? Gene Heskett <gheskett@shentel.net> - 2017-01-01 15:10 +0100
                Re: Do have programs have poor documentation? "Thomas Schmitt" <scdbackup@gmx.net> - 2017-01-01 20:50 +0100
                Re: Do have programs have poor documentation? Gene Heskett <gheskett@shentel.net> - 2017-01-02 02:10 +0100
                Re: Do have programs have poor documentation? Lisi Reisz <lisi.reisz@gmail.com> - 2017-01-02 02:30 +0100
                Re: Do have programs have poor documentation? David Wright <deblis@lionunicorn.co.uk> - 2017-01-02 16:00 +0100
                Re: Do have programs have poor documentation? rhkramer@gmail.com - 2017-01-02 17:30 +0100
                Re: Do have programs have poor documentation? David Wright <deblis@lionunicorn.co.uk> - 2017-01-02 18:20 +0100
                Re: Do have programs have poor documentation? rhkramer@gmail.com - 2017-01-02 18:50 +0100
                Re: Do have programs have poor documentation? Eike Lantzsch <zp6cge@gmx.net> - 2017-01-01 18:00 +0100
                Re: Do have programs have poor documentation? Xen <list@xenhideout.nl> - 2017-01-01 19:30 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") rhkramer@gmail.com - 2016-12-31 15:20 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2017-01-01 12:40 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? --  "A Modest Proposal") David Wright <deblis@lionunicorn.co.uk> - 2017-01-02 15:50 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") rhkramer@gmail.com - 2017-01-02 17:20 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? --  "A Modest Proposal") David Wright <deblis@lionunicorn.co.uk> - 2017-01-02 18:10 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") rhkramer@gmail.com - 2017-01-02 18:50 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Jörg-Volker Peetz <jvpeetz@web.de> - 2017-01-02 19:10 +0100
        Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-30 02:40 +0100
          Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-30 03:30 +0100
            Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2016-12-30 18:30 +0100
              Re: Do have programs have poor documentation? (was ... Re: Why? --  "A Modest Proposal") Dan Purgert <dan@djph.net> - 2017-01-01 12:40 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? --  "A Modest Proposal") Nicolas George <george@nsup.org> - 2017-01-01 12:50 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2017-01-01 14:10 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? --  "A Modest Proposal") Nicolas George <george@nsup.org> - 2017-01-01 15:10 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2017-01-01 16:40 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? --  "A Modest Proposal") Nicolas George <george@nsup.org> - 2017-01-01 17:20 +0100
                [OT] on education [was]: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2017-01-01 20:40 +0100
                Re: [OT] on education [was]: Do have programs have poor  documentation? (was ... Re: Why? -- "A Modest Proposal") Nicolas George <george@nsup.org> - 2017-01-01 23:50 +0100
                Re: [OT] on education [was]: Do have programs have poor  documentation? (was ... Re: Why? -- "A Modest Proposal") Joel Rees <joel.rees@gmail.com> - 2017-01-02 01:30 +0100
              Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Rob van der Putten <rob@sput.nl> - 2017-03-12 17:50 +0100
            Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-31 08:30 +0100
              Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-31 10:30 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2017-01-01 13:00 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2017-01-01 13:00 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2017-01-01 13:30 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2017-01-01 14:20 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2017-01-01 18:00 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <xen@dds.nl> - 2017-01-01 20:10 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? --  "A Modest Proposal") Bob Holtzman <holtzm@cox.net> - 2017-01-02 20:40 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? --  "A Modest Proposal") cbannister@slingshot.co.nz - 2017-03-11 10:00 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Martin Read <zen75502@zen.co.uk> - 2017-03-11 12:50 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2017-03-11 14:30 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Doug <dmcgarrett@optonline.net> - 2017-03-11 19:30 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? --  "A  Modest Proposal") Dan Purgert <dan@djph.net> - 2017-03-13 13:10 +0100
          Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Catherine Gramze <rhiamom@gmail.com> - 2016-12-30 04:40 +0100
            Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-31 08:40 +0100
          Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-30 12:40 +0100
            Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Richard Owlett <rowlett@cloud85.net> - 2016-12-30 13:30 +0100
              Re: Do have programs have poor documentation? (was ... Re: Why? --  "A  Modest Proposal") Dan Purgert <dan@djph.net> - 2016-12-30 15:50 +0100
            Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") rhkramer@gmail.com - 2016-12-30 15:50 +0100
              Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2016-12-30 20:50 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-31 00:20 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2016-12-31 01:10 +0100
                Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-31 01:50 +0100
                [OT] Antikythera mechanism [was Re: Do have programs have poor  documentation?] Miles Fidelman <mfidelman@meetinghouse.net> - 2016-12-31 03:20 +0100
                Re: [OT] Antikythera mechanism [was Re: Do have programs have poor documentation?] deloptes <deloptes@gmail.com> - 2016-12-31 10:20 +0100
        Re: Do have programs have poor documentation? (was ... Re: Why? -- "A  Modest Proposal") Rob van der Putten <rob@sput.nl> - 2017-03-11 22:50 +0100
  Re: Why? -- "A Modest Proposal" kamaraju kusumanchi <raju.mailinglists@gmail.com> - 2016-11-22 07:10 +0100
    Re: Why? -- "A Modest Proposal" Darac Marjal <mailinglist@darac.org.uk> - 2016-11-22 13:00 +0100
    Re: Why? -- "A Modest Proposal" Richard Owlett <rowlett@cloud85.net> - 2016-11-22 13:30 +0100

csiph-web