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 <stefano.lattar...@gmail.com>
> > 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 <stefano.lattar...@gmail.com>
> > 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
