Re: A Closer Look at GNU AutoTools

[Zé]

On 09/04/2014 11:40 PM, John Calcote wrote:
> If you're looking for a tutorial that walks you through the small set of
> tasks that you personally need to perform, you're unlikely to find one
> unless you write it.

As I see it, this is a clear indicator that the manual is sub-par and 
doesn't fulfill its purpose.


> This is just common sense.

And this is why this is still a problem.

>  While there are many task-specific tutorials out there, the fact is, 
the Autotools are a general set of build tools designed to handle a 
million permutations of build requirements. The manuals are necessarily 
complete and generic.

I agree, but that doesn't justify why it fails to cover those 
task-specific topics that everyone is looking and has to either write it 
themselves or go look elsewhere.

In fact, I don't understand how you can at the same time acknowledge 
that people are forced to look elsewhere for information that should be 
available in the doc, and still don't understand that's a major problem 
with the manual.


--
Zé