[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Automake Manuals (RANT)

From: Arthur Schwarz
Subject: Automake Manuals (RANT)
Date: Sat, 25 Apr 2015 17:25:29 -0700

Well, putting it gently you have a good product and one of (maybe, the)
worst manual on earth describing it. You can’t argue that as a volunteer
effort you depend on volunteers, because you have volunteers willing and
wanting to put their backs to the wheel to improve your manual, e.g., My
question is why don’t you use these ready hands or why don’t we see their

Lest you think that I wail at others without efforts of myself, let me say
“nay”. I am trying to help as best I can by rewriting all of Section 15
Support for test suites. But I don't know Tex/LaTex/Texinfo and my efforts
are restricted to Open Office/Adobe PDF and Open Office generated LaTex
files - and others have commented on their inadequacy, 

My forte is in ungrammatical sentences and misspellings (until I grow up and
edit the text), but a very rough draft of my own efforts is given in So even
the weakest of your readers is trying to help.
Section 15 of your document has grammatical errors, errors in logic and
errors in organization, see I have
been asked whether I will/will not include a patch to fix the items, see The quick
answer is "as best I can I will include material". Will anyone of the
Automake developers accept it or support me in providing a patch in a manner
acceptable to the Automake community? Just a question.

My fondest hope is that the comments of others, as well as myself, are taken
to heart and that you begin to solicit or perform needed document changes.


Maintenance turns design into chaos

reply via email to

[Prev in Thread] Current Thread [Next in Thread]