Re: [PATCHES] Docs on automatic dependency tracking (was: Testing a new compiler with Automake "simple tests")

[Ralf Wildenhues]

[ dropped automake@ ]

* Stefano Lattarini wrote on Tue, Aug 17, 2010 at 10:29:51PM CEST:
> From ef90f67c33297b361ac9630fd5fa8be5d2e463d5 Mon Sep 17 00:00:00 2001
> From: Stefano Lattarini <address@hidden>
> Date: Tue, 17 Aug 2010 19:23:47 +0200
> Subject: [PATCH 1/2] Fix typo in manual (`Makefile.in' instead of 
> `Makefile.am').
> 
> * doc/automake.texi (Automatic dependency tracking): Ditto.

OK for maint, thanks.  The "Ditto" is confusing though, making it seem
like there are two things that are fixed.  "Fix typo", or just use one
line of commit entry is fine in that case.

> From e701a503993423ec559eb7b90135fe7dce724eef Mon Sep 17 00:00:00 2001
> From: Stefano Lattarini <address@hidden>
> Date: Tue, 17 Aug 2010 22:19:08 +0200
> Subject: [PATCH 2/2] Docs: clarify how to avoid automatic dependencies 
> tracking.
> 
> * doc/automake.texi (Automatic dependency tracking): Tell that
> automatic dependencies tracking is on by default, but that the
> package developer can disable it altogether.  Add a referencw
> to the proper section for a more in-depth explanation.

s/Tell/Mention/  s/ on / enabled /  s/referencw/reference/

> --- a/doc/automake.texi
> +++ b/doc/automake.texi
> @@ -1246,6 +1246,11 @@ source being compiled).  Later, any time 
> @command{make} is run and a
>  dependency appears to have changed, the dependent files will be
>  rebuilt.
>  
> +By default, Automake generates code for such an automatic dependency
> +tracking. Note, however, that the developer can override this, and
> +avoid automatic dependency tracking altogether; see @ref{Dependencies}
> +for more information.

Sounds a bit awkward.  How about this slight rewording:

Automake generates code for automatic dependency tracking by default,
unless the developer chooses to override it; for more information,
@pxref{Dependencies}.

OK for maint if you agree.

Thanks,
Ralf