From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: npostavs@users.sourceforge.net Newsgroups: gmane.emacs.bugs Subject: bug#24923: 25.1; Lisp watchpoints Date: Sun, 20 Nov 2016 14:26:15 -0500 Message-ID: <87mvguj6lk.fsf@users.sourceforge.net> References: <87vavun235.fsf@users.sourceforge.net> <83eg2ie3lp.fsf@gnu.org> <87pom1mi3q.fsf@users.sourceforge.net> <83r36hcghy.fsf@gnu.org> <87fumwmc7q.fsf@users.sourceforge.net> <83fumvcs99.fsf@gnu.org> <874m32lx1e.fsf@users.sourceforge.net> <87k2bya0j6.fsf@gmx.net> <87wpfyjl1x.fsf@users.sourceforge.net> <83lgwe9lmo.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1479669971 15692 195.159.176.226 (20 Nov 2016 19:26:11 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 20 Nov 2016 19:26:11 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) Cc: 24923@debbugs.gnu.org, stephen.berman@gmx.net To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Nov 20 20:26:07 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c8Xkd-00033R-CN for geb-bug-gnu-emacs@m.gmane.org; Sun, 20 Nov 2016 20:26:07 +0100 Original-Received: from localhost ([::1]:46004 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c8Xkg-00031S-Sc for geb-bug-gnu-emacs@m.gmane.org; Sun, 20 Nov 2016 14:26:10 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:43474) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c8Xkb-00031F-4f for bug-gnu-emacs@gnu.org; Sun, 20 Nov 2016 14:26:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c8XkY-0004TO-0v for bug-gnu-emacs@gnu.org; Sun, 20 Nov 2016 14:26:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:49252) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1c8XkX-0004TI-Tz for bug-gnu-emacs@gnu.org; Sun, 20 Nov 2016 14:26:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1c8XkX-0003or-OO for bug-gnu-emacs@gnu.org; Sun, 20 Nov 2016 14:26:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: npostavs@users.sourceforge.net Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 20 Nov 2016 19:26:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24923 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 24923-submit@debbugs.gnu.org id=B24923.147966993414633 (code B ref 24923); Sun, 20 Nov 2016 19:26:01 +0000 Original-Received: (at 24923) by debbugs.gnu.org; 20 Nov 2016 19:25:34 +0000 Original-Received: from localhost ([127.0.0.1]:36418 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c8Xk6-0003nx-6Z for submit@debbugs.gnu.org; Sun, 20 Nov 2016 14:25:34 -0500 Original-Received: from mail-it0-f45.google.com ([209.85.214.45]:36929) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c8Xk1-0003nd-Io for 24923@debbugs.gnu.org; Sun, 20 Nov 2016 14:25:32 -0500 Original-Received: by mail-it0-f45.google.com with SMTP id y23so88328570itc.0 for <24923@debbugs.gnu.org>; Sun, 20 Nov 2016 11:25:29 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=TVPBpVSYEaH3Ga2jdq5qz3+E3EjUQw0KW11ekhJg66Y=; b=JHUVlNyf+90KiXBxwrsCWTmffYv51N0tHhKfU9a3tzx7qSVi2r3kHGNgl0iHHeEqwj I5PNsnaJ2B/hAeHp5kc3s5RdcdKWkGyzJKVOkT6bjw8jwXbH2U0mKkgxP7LPYtMDacVK JE3StZrA2LT32pn8dIl5AHl8px3Uq98hUpZhKu5234WciD3heyYURKlRZxvqJkS6wMte Fx0lY3e/jrfbRxNCNQ0nW6QN11M7lY8qgaYuXJ7RBEKa/co+ojtrMJX3kzoh7MjtpCYM Knwf5QLSLuQVpR7FNGFMtDCFl0InaTn6EIssuO2i5Z4s9jhDGUYvETOC9qq+zfU90qcg pAzA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:sender:from:to:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version; bh=TVPBpVSYEaH3Ga2jdq5qz3+E3EjUQw0KW11ekhJg66Y=; b=Lp4LzRKvIXpmHZ5V5mYIpFJu7vp5pwseIkZZSZSJ+JcYeCovT7CRFYClNbwthLcozD aCDSj52T+WK9RsGOMk/e1GSfnxevcVlpUgkRdxn9A06qtXnCAXmBUN6200ZvpRy6BVe6 nvFxRcP94N6Q1VhW2aGytQyxqqeRN9olhJV9Pfbb7qlyJ63RNdAlrCgcOqnWZzelUNnw DLVEWSfdeWcnbRjXo2TA6FIcLjaHllZlf9vnvNCqjeJpcl6G2bZCML2DLnj944kIrD1B 9wW8wOus6oVI0lsLDrQCXUe3hEDIX2FPVR+QIN/ZJ0+PTI3Hd1T3+i/ylAQq+hLQTJb0 XjCQ== X-Gm-Message-State: AKaTC02OW4kAohXBxK+JKVl0MiJiBXhCTHAtTzOWJHs/leC2DASLTV4KiGQ8AoxcQKfNwQ== X-Received: by 10.36.193.197 with SMTP id e188mr6136615itg.99.1479669923907; Sun, 20 Nov 2016 11:25:23 -0800 (PST) Original-Received: from zony ([45.2.7.65]) by smtp.googlemail.com with ESMTPSA id l73sm4544398ioe.37.2016.11.20.11.25.23 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sun, 20 Nov 2016 11:25:23 -0800 (PST) In-Reply-To: <83lgwe9lmo.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 20 Nov 2016 18:11:43 +0200") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:125923 Archived-At: Eli Zaretskii 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.