[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#24923: 25.1; Lisp watchpoints
From: |
npostavs |
Subject: |
bug#24923: 25.1; Lisp watchpoints |
Date: |
Sun, 20 Nov 2016 14:26:15 -0500 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) |
Eli Zaretskii <eliz@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? I'll change to @ref anyway.
>
>> +@defun add-variable-watcher symbol watch-function
>> +This function arranges for @var{watch-function} to be called whenever
>> +@var{symbol} (or any of its aliases @pxref{Variable Aliases}) are
> ^
>> +modified.
>
> A comma is missing here. Also, I believe "is modified" reads better
> here. Or maybe replace the parentheses with commas, then plural
> should be okay, I think.
Hmm, maybe rephrasing like this:
@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.
- bug#24923: 25.1; Lisp watchpoints, npostavs, 2016/11/10
- bug#24923: 25.1; Lisp watchpoints, Eli Zaretskii, 2016/11/11
- bug#24923: 25.1; Lisp watchpoints, npostavs, 2016/11/11
- bug#24923: 25.1; Lisp watchpoints, Eli Zaretskii, 2016/11/12
- bug#24923: 25.1; Lisp watchpoints, npostavs, 2016/11/12
- bug#24923: 25.1; Lisp watchpoints, Eli Zaretskii, 2016/11/13
- bug#24923: 25.1; Lisp watchpoints, npostavs, 2016/11/19
- bug#24923: 25.1; Lisp watchpoints, Stephen Berman, 2016/11/20
- bug#24923: 25.1; Lisp watchpoints, npostavs, 2016/11/20
- bug#24923: 25.1; Lisp watchpoints, Eli Zaretskii, 2016/11/20
- bug#24923: 25.1; Lisp watchpoints,
npostavs <=
- bug#24923: 25.1; Lisp watchpoints, Eli Zaretskii, 2016/11/20
- bug#24923: 25.1; Lisp watchpoints, npostavs, 2016/11/20
- bug#24923: 25.1; Lisp watchpoints, Eli Zaretskii, 2016/11/21
- bug#24923: 25.1; Lisp watchpoints, Eli Zaretskii, 2016/11/20
- bug#24923: 25.1; Lisp watchpoints, npostavs, 2016/11/20
- bug#24923: 25.1; Lisp watchpoints, Eli Zaretskii, 2016/11/20