From unknown Tue Jun 17 20:26:58 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#30816 <30816@debbugs.gnu.org> To: bug#30816 <30816@debbugs.gnu.org> Subject: Status: 27.0.50; Info documentation of previous-property-change is not very clear Reply-To: bug#30816 <30816@debbugs.gnu.org> Date: Wed, 18 Jun 2025 03:26:58 +0000 retitle 30816 27.0.50; Info documentation of previous-property-change is no= t very clear reassign 30816 emacs submitter 30816 Xu Chunyang severity 30816 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Wed Mar 14 05:58:56 2018 Received: (at submit) by debbugs.gnu.org; 14 Mar 2018 09:58:57 +0000 Received: from localhost ([127.0.0.1]:60414 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ew3BQ-0002Kw-Mz for submit@debbugs.gnu.org; Wed, 14 Mar 2018 05:58:56 -0400 Received: from eggs.gnu.org ([208.118.235.92]:51280) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ew3BN-0002Kh-W1 for submit@debbugs.gnu.org; Wed, 14 Mar 2018 05:58:54 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ew3BI-0000dK-4N for submit@debbugs.gnu.org; Wed, 14 Mar 2018 05:58:48 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:41758) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ew3BI-0000dE-0H for submit@debbugs.gnu.org; Wed, 14 Mar 2018 05:58:48 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:42251) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ew3BG-00067h-To for bug-gnu-emacs@gnu.org; Wed, 14 Mar 2018 05:58:47 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ew3BG-0000cZ-7r for bug-gnu-emacs@gnu.org; Wed, 14 Mar 2018 05:58:47 -0400 Received: from forward103j.mail.yandex.net ([2a02:6b8:0:801:2::106]:55493) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ew3BF-0000bc-VV for bug-gnu-emacs@gnu.org; Wed, 14 Mar 2018 05:58:46 -0400 Received: from mxback14j.mail.yandex.net (mxback14j.mail.yandex.net [IPv6:2a02:6b8:0:1619::90]) by forward103j.mail.yandex.net (Yandex) with ESMTP id 2754034C4084 for ; Wed, 14 Mar 2018 12:58:42 +0300 (MSK) Received: from smtp3o.mail.yandex.net (smtp3o.mail.yandex.net [2a02:6b8:0:1a2d::27]) by mxback14j.mail.yandex.net (nwsmtp/Yandex) with ESMTP id P0O8Qke4rZ-wglmDtlh; Wed, 14 Mar 2018 12:58:42 +0300 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=xuchunyang.me; s=mail; t=1521021522; bh=6SqIxC1dMA1w3rGVoMyYOXr7SaeBKU8wqT041/gYJi8=; h=From:To:Subject:Date:Message-ID; b=+XGUQCsNSUPRoGNr26T81KcRy8ptznSsMOki3HZ0rni1DQehNM5ncH6uAFNAz5AE2 3/4+ernkbc95LarujO70Wv5Dl3XolpQ87mOQ9O2EjTDPOIbUD9HXTEax3Xwx4/8qc6 stx7GLCdyu+JpklXwLdCZmCOTEgf3BM1lCrgKpew= Received: by smtp3o.mail.yandex.net (nwsmtp/Yandex) with ESMTPSA id 7OhZkC3LdA-wYSG0GuL; Wed, 14 Mar 2018 12:58:35 +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=1521021521; bh=6SqIxC1dMA1w3rGVoMyYOXr7SaeBKU8wqT041/gYJi8=; h=From:To:Subject:Date:Message-ID; b=9q2PIcnBULM3L6u7u1mQ43QQop1GpdGfZv1EzE30hADqhNWWtn3LFolvWczXPvKKs KbUG8noe1aeeqGNttB7ZK9lFUFqLTAAe4qSpqQuOOhvt/WvlgbdCC3nD52+qe4fm5S I3fG9VgTy7SYnaU1nYiDHgUFLR9v3rqh8uwQQjXI= Authentication-Results: smtp3o.mail.yandex.net; dkim=pass header.i=@xuchunyang.me From: Xu Chunyang To: bug-gnu-emacs@gnu.org Subject: 27.0.50; Info documentation of previous-property-change is not very clear Date: Wed, 14 Mar 2018 17:58:32 +0800 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) (info "(elisp) Property Search") has the following: -- Function: previous-property-change pos &optional object limit This is like =E2=80=98next-property-change=E2=80=99, but scans bac= k 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 POS. ^^ I don't understand the second sentence. What "the value" stands for? If it stands for LIMIT, what "it" stands for? From debbugs-submit-bounces@debbugs.gnu.org Wed Mar 14 12:27:01 2018 Received: (at 30816) by debbugs.gnu.org; 14 Mar 2018 16:27:01 +0000 Received: from localhost ([127.0.0.1]:33507 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ew9Ez-0001qe-83 for submit@debbugs.gnu.org; Wed, 14 Mar 2018 12:27:01 -0400 Received: from eggs.gnu.org ([208.118.235.92]:56694) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ew9Ex-0001qL-4X for 30816@debbugs.gnu.org; Wed, 14 Mar 2018 12:26:59 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ew9Eo-0005TW-Ki for 30816@debbugs.gnu.org; Wed, 14 Mar 2018 12:26:53 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,T_RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:57036) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ew9Eo-0005TS-Gi; Wed, 14 Mar 2018 12:26:50 -0400 Received: from [176.228.60.248] (port=1390 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1ew9En-0000QO-W2; Wed, 14 Mar 2018 12:26:50 -0400 Date: Wed, 14 Mar 2018 18:26:46 +0200 Message-Id: <833712sjw9.fsf@gnu.org> From: Eli Zaretskii To: Xu Chunyang In-reply-to: (message from Xu Chunyang on Wed, 14 Mar 2018 17:58:32 +0800) Subject: Re: bug#30816: 27.0.50; Info documentation of previous-property-change is not very clear References: MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 30816 Cc: 30816@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > From: Xu Chunyang > Date: Wed, 14 Mar 2018 17:58:32 +0800 > > > (info "(elisp) Property Search") has the following: > > -- Function: previous-property-change pos &optional object limit > This is like ‘next-property-change’, but scans back from POS > instead of forward. If the value is non-‘nil’, it is a position > ^^^^^^^^^ > less than or equal to POS; it equals POS only if LIMIT equals POS. > ^^ > > 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. > 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. From debbugs-submit-bounces@debbugs.gnu.org Wed Mar 14 15:04:45 2018 Received: (at 30816) by debbugs.gnu.org; 14 Mar 2018 19:04:45 +0000 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 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 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) 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= 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 From: Xu Chunyang To: Eli Zaretskii Subject: Re: bug#30816: 27.0.50; Info documentation of previous-property-change is not very clear References: <833712sjw9.fsf@gnu.org> Date: Thu, 15 Mar 2018 03:04:30 +0800 In-Reply-To: <833712sjw9.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 14 Mar 2018 18:26:46 +0200") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (darwin) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 30816 Cc: 30816@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) 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. From debbugs-submit-bounces@debbugs.gnu.org Wed Mar 14 15:35:53 2018 Received: (at 30816-done) by debbugs.gnu.org; 14 Mar 2018 19:35:53 +0000 Received: from localhost ([127.0.0.1]:33640 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ewCBk-0002Xx-W6 for submit@debbugs.gnu.org; Wed, 14 Mar 2018 15:35:53 -0400 Received: from eggs.gnu.org ([208.118.235.92]:42442) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ewCBj-0002Xi-Kq for 30816-done@debbugs.gnu.org; Wed, 14 Mar 2018 15:35:52 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ewCBb-0004XE-Q9 for 30816-done@debbugs.gnu.org; Wed, 14 Mar 2018 15:35:46 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,T_RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:60278) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ewCBb-0004X7-N1; Wed, 14 Mar 2018 15:35:43 -0400 Received: from [176.228.60.248] (port=1852 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1ewCBb-0008J9-4K; Wed, 14 Mar 2018 15:35:43 -0400 Date: Wed, 14 Mar 2018 21:35:39 +0200 Message-Id: <83muzaqwl0.fsf@gnu.org> From: Eli Zaretskii To: Xu Chunyang In-reply-to: (message from Xu Chunyang on Thu, 15 Mar 2018 03:04:30 +0800) Subject: Re: bug#30816: 27.0.50; Info documentation of previous-property-change is not very clear References: <833712sjw9.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 30816-done Cc: 30816-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > From: Xu Chunyang > Cc: 30816@debbugs.gnu.org > Date: Thu, 15 Mar 2018 03:04:30 +0800 > > Thanks for your explanation. Feel free to close the issue. Done. From unknown Tue Jun 17 20:26:58 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 12 Apr 2018 11:24:04 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator