Subject: bug#24923: 25.1; Lisp watchpoints

From: Eli Zaretskii <[email-masked]>
Date: Sun, 20 Nov 2016 21:36:40 +0200

> From: [email-masked]
> Cc: [email-masked],  [email-masked]
> Date: Sun, 20 Nov 2016 14:26:15 -0500
> 
> Eli Zaretskii <[email-masked]> writes:
> 
> >> +changes to the objects referenced by variables are not detected.  For
> >> +details, see @xref{Watching Variables}.
> >                 ^^^^^
> > @xref already generates "See", capitalized, so you want @ref here.
> >
> >> +Each variable has a list of watch functions stored in its
> >> +@code{watchers} symbol property, @xref{Symbol Properties}.
> >                                     ^^^^^
> > Either "see @ref" or "@pxref", because @xref generates a capitalized
> > "See", and so is only appropriate at the beginning of a sentence.
> 
> @xref seems to be generating lowercase "see" for me, perhaps because I'm
> using makeinfo 4.13?

Unlikely.  Are you looking at the file in Info, or as plain text?  The
former has its own ideas about how to display cross-references; I
meant what is actually in the file.

>     @defun add-variable-watcher symbol watch-function
>     This function arranges for @var{watch-function} to be called whenever
>     @var{symbol} is modified.  Modifications through aliases
>     (@pxref{Variable Aliases}) will have the same effect.

Fine with me, thanks.