From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Xu Chunyang Newsgroups: gmane.emacs.bugs Subject: bug#30816: 27.0.50; Info documentation of previous-property-change is not very clear Date: Thu, 15 Mar 2018 03:04:30 +0800 Message-ID: References: <833712sjw9.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1521054195 25053 195.159.176.226 (14 Mar 2018 19:03:15 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 14 Mar 2018 19:03:15 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (darwin) Cc: 30816@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Mar 14 20:03:11 2018 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 1ewBg3-0006Lk-Jh for geb-bug-gnu-emacs@m.gmane.org; Wed, 14 Mar 2018 20:03:07 +0100 Original-Received: from localhost ([::1]:47854 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ewBi6-00077o-L6 for geb-bug-gnu-emacs@m.gmane.org; Wed, 14 Mar 2018 15:05:14 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54712) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ewBi0-00076D-AK for bug-gnu-emacs@gnu.org; Wed, 14 Mar 2018 15:05:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ewBhv-0005oP-5x for bug-gnu-emacs@gnu.org; Wed, 14 Mar 2018 15:05:07 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:53962) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ewBhv-0005oH-2A for bug-gnu-emacs@gnu.org; Wed, 14 Mar 2018 15:05:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ewBhu-0001jQ-0t for bug-gnu-emacs@gnu.org; Wed, 14 Mar 2018 15:05:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Xu Chunyang Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 14 Mar 2018 19:05:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 30816 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 30816-submit@debbugs.gnu.org id=B30816.15210542856614 (code B ref 30816); Wed, 14 Mar 2018 19:05:01 +0000 Original-Received: (at 30816) by debbugs.gnu.org; 14 Mar 2018 19:04:45 +0000 Original-Received: from localhost ([127.0.0.1]:33626 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ewBhc-0001ia-Q4 for submit@debbugs.gnu.org; Wed, 14 Mar 2018 15:04:45 -0400 Original-Received: from forward101o.mail.yandex.net ([37.140.190.181]:42276) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ewBhb-0001iK-13 for 30816@debbugs.gnu.org; Wed, 14 Mar 2018 15:04:43 -0400 Original-Received: from mxback15g.mail.yandex.net (mxback15g.mail.yandex.net [IPv6:2a02:6b8:0:1472:2741:0:8b7:94]) by forward101o.mail.yandex.net (Yandex) with ESMTP id 09D4513452DC; Wed, 14 Mar 2018 22:04:36 +0300 (MSK) Original-Received: from smtp1o.mail.yandex.net (smtp1o.mail.yandex.net [2a02:6b8:0:1a2d::25]) by mxback15g.mail.yandex.net (nwsmtp/Yandex) with ESMTP id 1jxqZPmxVP-4ZDucBA4; Wed, 14 Mar 2018 22:04:35 +0300 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=xuchunyang.me; s=mail; t=1521054275; bh=eQTM+gnq0GvCIwLOweKr4vgvi1Bi8s6XM+xTJyM104o=; h=From:To:Cc:Subject:References:Date:In-Reply-To:Message-ID; b=98XGH0tXZhYVg8jMw6aNmj+ezjTkEUzJ2fMZYPph9Bul2b545oIxscp9/M2ZUQv9N WZNGsQuUmjpzx4JULOUhU6/jWs4E4V+lsfBImIIuQ0bAz6FFpS5f5T1+e/IovKbYJe puYqdvfDFFPbgcV2y35glE8czQaOW9bTPTaqkME0= Original-Received: by smtp1o.mail.yandex.net (nwsmtp/Yandex) with ESMTPSA id LkDv2pFtmb-4Xue3nU6; Wed, 14 Mar 2018 22:04:34 +0300 (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client certificate not present) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=xuchunyang.me; s=mail; t=1521054274; bh=eQTM+gnq0GvCIwLOweKr4vgvi1Bi8s6XM+xTJyM104o=; h=From:To:Cc:Subject:References:Date:In-Reply-To:Message-ID; b=XtfHE/B/OagbxYCXsA/C2fa8bhxY14BFi3rkr2A4fWfA5/Tk79jKRV5fjoKvv2gBJ WgwLct0/XC3Dge6pJgPNZmYhX/0foRGnv5K2FH6jfJ+OgqC3ejrouVaz9cSZ7OHnbi 5G/uQJ42M0PYgq5kX8Wr5J0wgHOchEDutFVZzSfg= Authentication-Results: smtp1o.mail.yandex.net; dkim=pass header.i=@xuchunyang.me In-Reply-To: <833712sjw9.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 14 Mar 2018 18:26:46 +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:144278 Archived-At: Eli Zaretskii writes: >> From: Xu Chunyang >> Date: Wed, 14 Mar 2018 17:58:32 +0800 >>=20 >>=20 >> (info "(elisp) Property Search") has the following: >>=20 >> -- Function: previous-property-change pos &optional object limit >> This is like =E2=80=98next-property-change=E2=80=99, but scans = back from POS >> instead of forward. If the value is non-=E2=80=98nil=E2=80=99,= it is a position >> ^^^^^^^^^ >> less than or equal to POS; it equals POS only if LIMIT equals P= OS. >> ^^ >>=20 >> I don't understand the second sentence. What "the value" stands for? > > When we say "value" in the context of describing a function, we mean > the value the function returns. In this case, the value returned by > previous-property-change. I see. I notice the term "the return value" is also used in some place in the manual. >> If it stands for LIMIT, what "it" stands for? > > "It" stands for the value returned by the function. the text says > that the function returns the position of the previous change of the > property, and that position could only be the same as the starting > position POS if LIMIT is equal to POS, i.e. if LIMIT forces the > function to stop at its starting position. > > I hope this clarifies the issue. Thanks for your explanation. Feel free to close the issue.