GNU bug report logs - #24923
Lisp watchpoints

Previous Next

Full log

View this message in rfc822 format

From: Eli Zaretskii <eliz <at> gnu.org>
To: npostavs <at> users.sourceforge.net
Cc: 24923 <at> debbugs.gnu.org, stephen.berman <at> gmx.net
Subject: bug#24923: 25.1; Lisp watchpoints
Date: Sun, 20 Nov 2016 21:36:40 +0200

> From: npostavs <at> users.sourceforge.net
> Cc: 24923 <at> debbugs.gnu.org,  stephen.berman <at> gmx.net
> Date: Sun, 20 Nov 2016 14:26:15 -0500
> 
> Eli Zaretskii <eliz <at> gnu.org> 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.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.