Re: [PATCHES] Docs on automatic dependency tracking

[Stefano Lattarini]

At Tuesday 17 August 2010, Ralf Wildenhues wrote:
> 
> * 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.
So is:
  * doc/automake.texi (Automatic dependency tracking): Fix typo.
acceptable?
 
> > 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/
Done.

> > --- 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}.
Definitely better.

> OK for maint if you agree.
I agree, and I think I should add your name to the ChangeLog entry.
OK?

Thanks,
  Stefano