From debbugs-submit-bounces@debbugs.gnu.org Tue Oct 18 16:40:46 2016 Received: (at submit) by debbugs.gnu.org; 18 Oct 2016 20:40:46 +0000 Received: from localhost ([127.0.0.1]:38432 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bwbBl-0005jJ-QT for submit@debbugs.gnu.org; Tue, 18 Oct 2016 16:40:45 -0400 Received: from eggs.gnu.org ([208.118.235.92]:34771) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bwbBk-0005j6-BZ for submit@debbugs.gnu.org; Tue, 18 Oct 2016 16:40:44 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bwbBe-0007NS-GS for submit@debbugs.gnu.org; Tue, 18 Oct 2016 16:40:39 -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,NO_DNS_FOR_FROM autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:52387) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1bwbBe-0007NB-6r for submit@debbugs.gnu.org; Tue, 18 Oct 2016 16:40:38 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:53969) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bwbBd-00061V-9a for bug-gnu-emacs@gnu.org; Tue, 18 Oct 2016 16:40:37 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bwbBZ-0007L7-D9 for bug-gnu-emacs@gnu.org; Tue, 18 Oct 2016 16:40:37 -0400 Received: from cpe-104-32-170-214.socal.res.rr.com ([104.32.170.214]:33710 helo=hong-MacBook) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1bwbBZ-0007KZ-6F for bug-gnu-emacs@gnu.org; Tue, 18 Oct 2016 16:40:33 -0400 Received: from hong by hong-MacBook with local (Exim 4.84_2) (envelope-from ) id 1bwaol-0004t7-Uz; Tue, 18 Oct 2016 13:16:59 -0700 From: Hong Xu To: bug-gnu-emacs@gnu.org Subject: [PATCH] Minor improvement of the doc of lisp/paren.el. Date: Tue, 18 Oct 2016 13:16:58 -0700 Message-Id: <1476821818-18751-1-git-send-email-hong@topbug.net> X-Mailer: git-send-email 2.1.4 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.6 (----) X-Debbugs-Envelope-To: submit Cc: Hong Xu 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.6 (----) --- These are my suggested imporvements of the docs in lisp/paren.el, after I looked into the code for the first time. --- lisp/paren.el | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/lisp/paren.el b/lisp/paren.el index 53eb50077f25..f0df1ff2ea4d 100644 --- a/lisp/paren.el +++ b/lisp/paren.el @@ -181,6 +181,7 @@ show-paren-data-function Where HERE-BEG..HERE-END is expected to be near point.") (defun show-paren--default () + "The default value of `show-paren-data-function'." (let* ((temp (show-paren--locate-near-paren)) (dir (car temp)) (outside (cdr temp)) @@ -233,9 +234,8 @@ show-paren--default (if (= dir 1) pos (1+ pos)) mismatch))))))) -;; Find the place to show, if there is one, -;; and show it until input arrives. (defun show-paren-function () + "Highlight the parentheses until the next input arrives." (let ((data (and show-paren-mode (funcall show-paren-data-function)))) (if (not data) (progn -- 2.1.4 From debbugs-submit-bounces@debbugs.gnu.org Thu Oct 20 07:41:11 2016 Received: (at 24734) by debbugs.gnu.org; 20 Oct 2016 11:41:11 +0000 Received: from localhost ([127.0.0.1]:40397 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bxBig-00007E-UW for submit@debbugs.gnu.org; Thu, 20 Oct 2016 07:41:11 -0400 Received: from mail.agora-net.com ([67.59.132.6]:44697) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bxBif-000076-2I for 24734@debbugs.gnu.org; Thu, 20 Oct 2016 07:41:09 -0400 Received: from ttn by mail.agora-net.com with local (Exim 4.82) (envelope-from ) id 1bxBic-00064H-8k; Thu, 20 Oct 2016 07:41:06 -0400 Received: from ttn by zigzag.favinet with local (Exim 4.80) (envelope-from ) id 1bwltE-00010C-KW; Wed, 19 Oct 2016 10:06:20 +0200 From: Thien-Thi Nguyen To: Hong Xu Subject: Re: bug#24734: [PATCH] Minor improvement of the doc of lisp/paren.el. References: <1476821818-18751-1-git-send-email-hong@topbug.net> Date: Wed, 19 Oct 2016 10:06:10 +0200 In-Reply-To: <1476821818-18751-1-git-send-email-hong@topbug.net> (Hong Xu's message of "Tue, 18 Oct 2016 13:16:58 -0700") Message-ID: <87mvi0wyod.fsf@zigzag.favinet> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" X-SA-Exim-Connect-IP: X-SA-Exim-Mail-From: ttn@gnuvola.org X-SA-Exim-Scanned: No (on mail.agora-net.com); SAEximRunCond expanded to false X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 24734 Cc: 24734@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.0 (/) --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable () Hong Xu () Tue, 18 Oct 2016 13:16:58 -0700 (defun show-paren--default () + "The default value of `show-paren-data-function'." It's better to describe what the function does, first. Where and how it is used is secondary. (It's no problem to refer to =E2=80=98show-paren-data-function=E2=80=99, if it follows the description.) =2D-=20 Thien-Thi Nguyen ----------------------------------------------- (defun responsep (type via) (case type (technical (eq 'mailing-list via)) ...)) 748E A0E8 1CB8 A748 9BFA =2D-------------------------------------- 6CE4 6703 2224 4C80 7502 --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (GNU/Linux) iEYEARECAAYFAlgHKXUACgkQZwMiJEyAdQIUIACfb7EoLafJNS7zxqK5bFGcddY5 IsYAnjJCX/4PnMbPy2zHbMnMRX4UaTkl =lMEm -----END PGP SIGNATURE----- --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Tue Oct 25 16:39:48 2016 Received: (at 24734) by debbugs.gnu.org; 25 Oct 2016 20:39:48 +0000 Received: from localhost ([127.0.0.1]:56767 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bz8Vg-0000wk-17 for submit@debbugs.gnu.org; Tue, 25 Oct 2016 16:39:48 -0400 Received: from sender163-mail.zoho.com ([74.201.84.163]:21439) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bz8Vf-0000wc-5e for 24734@debbugs.gnu.org; Tue, 25 Oct 2016 16:39:47 -0400 Received: from localhost (cpe-104-32-170-214.socal.res.rr.com [104.32.170.214]) by mx.zohomail.com with SMTPS id 147742798276631.219520173884007; Tue, 25 Oct 2016 13:39:42 -0700 (PDT) User-agent: mu4e 0.9.17; emacs 25.1.50.5 From: Hong Xu To: 24734@debbugs.gnu.org Subject: Minor improvement of the doc of lisp/paren.el Date: Tue, 25 Oct 2016 13:39:34 -0700 Message-ID: <8737jkmad5.fsf@topbug.net> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" X-Zoho-Virus-Status: 1 X-Spam-Score: 0.7 (/) X-Debbugs-Envelope-To: 24734 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 (/) --=-=-= Content-Type: text/plain Can we push this minor fix? This is a really easy fix. --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iQIcBAEBAgAGBQJYD8MGAAoJECZsfTOCL4R4AdoQALlIY6l5FiW0lcCCC9nhOYKw G0XgBmnJ8/Q5yv+TjQlwA7kgAWJH7w9HpV78Yd8R6rQqSedBid07IIJN4lxFiq0o NeBm/gUEDmyvNyM8Xtg5ABD9T3FON452+7IBOqI0dxsABvui8hR3c4oEuZxurzE4 945BVzC6MvlI/dWao06lX7Mx0qwyfUj3+GNQgB6YWuIA/XjW4K9VDs2tigsKpsZA svOSxq7M3oF1IDeLLY6pnhwe2hDF54QqRAcx0FnsmVcnYNgUBwBxikXY5ubTJM8m i/FAp1YFcF6njO8lNEWVpK1TO0o4f99DZ86gLd51u/gmdXvdwaGG6XbOPh16BKYX v9fhe7TKYuzjwqmOtKb1UetZm2Icrg7wZnke3/+X7ttXSSuDKBkJ2xdA1bOdzcVl KS64G19/csSjTbcyDFaDCtWSNAXs1znkbVNGLZjPhybSBvEwBDu5OkIChAbyfmKz ALnCTF12sVogdHmWAUaQ60EXIz1B/3DdkKs9KTlRaJbXyO0WISZOSdq764cYPUED SzZqiEIg0wzvUfuJicHVtgKgIbRuHxKccSM3UIfwJtwqdoOtQJ9f74vRAc2JK7Y2 dN64b0iZivmsKyyfz3/wwUueT3ngwDYnYhAJdcyF0654EKOc1yqNv8SVuxUMo9qM 0n9VwRSoSTIaRKXNsW8O =8pVe -----END PGP SIGNATURE----- --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Wed Nov 02 15:06:27 2016 Received: (at 24734) by debbugs.gnu.org; 2 Nov 2016 19:06:27 +0000 Received: from localhost ([127.0.0.1]:40881 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c20ri-0006QK-Sg for submit@debbugs.gnu.org; Wed, 02 Nov 2016 15:06:27 -0400 Received: from sender163-mail.zoho.com ([74.201.84.163]:21428) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c20ri-0006QD-5t for 24734@debbugs.gnu.org; Wed, 02 Nov 2016 15:06:26 -0400 Received: from localhost (cpe-104-32-170-214.socal.res.rr.com [104.32.170.214]) by mx.zohomail.com with SMTPS id 1478113583231756.6951474241652; Wed, 2 Nov 2016 12:06:23 -0700 (PDT) References: <8737jkmad5.fsf@topbug.net> User-agent: mu4e 0.9.17; emacs 25.1.50.2 From: Hong Xu To: 24734@debbugs.gnu.org Subject: Re: Minor improvement of the doc of lisp/paren.el In-reply-to: <8737jkmad5.fsf@topbug.net> Date: Wed, 02 Nov 2016 12:06:12 -0700 Message-ID: <87pomdn1ln.fsf@topbug.net> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="==-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" X-Zoho-Virus-Status: 1 X-Spam-Score: 0.6 (/) X-Debbugs-Envelope-To: 24734 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.6 (/) --==-=-= Content-Type: multipart/mixed; boundary="=-=-=" --=-=-= Content-Type: text/plain OK, actually I never received the response email, don't know why. The attachment is an updated version. --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=paren.patch Content-Transfer-Encoding: quoted-printable diff --git a/lisp/paren.el b/lisp/paren.el index 53eb50077f25..100cc58f0cbe 100644 =2D-- a/lisp/paren.el +++ b/lisp/paren.el @@ -181,6 +181,9 @@ show-paren-data-function Where HERE-BEG..HERE-END is expected to be near point.") =20 (defun show-paren--default () + "Finds the opener/closer near point and its match. + +It is the default value of `show-paren-data-function'." (let* ((temp (show-paren--locate-near-paren)) (dir (car temp)) (outside (cdr temp)) @@ -233,9 +236,8 @@ show-paren--default (if (=3D dir 1) pos (1+ pos)) mismatch))))))) =20 =2D;; Find the place to show, if there is one, =2D;; and show it until input arrives. (defun show-paren-function () + "Highlight the parentheses until the next input arrives." (let ((data (and show-paren-mode (funcall show-paren-data-function)))) (if (not data) (progn --=-=-=-- --==-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iQIcBAEBAgAGBQJYGjkkAAoJECZsfTOCL4R4WXsP/RHvQ58hyTkOXzauweyDDq5N +i2drt9jojl4BXIS1O6kANQdEZimQ3y8cPh9bS1YQerkOGTryIQZ8NR4VplCD8YN BO+u68hhQ52xLt4+ctjFewSOFUsy0tqSVUGSYHy5//UL3+T5n8t7xP0L8vhUA8OX FPNp0kI655N9izPJWHhDvXJBt8/X9ZetrMtFt+ySXtdMylxqSDYuW6ZAHZt8GG8c 7CmW/8HqgKad918ZQ+VYu+oHmDQ6TTuiP952EX6yPIGqTBN4QDhPHK6ZrGhP4nNo N8H7f8E1xeaW9BoyUqUh3eHWeay7nHjConHENhZebxTt0bKHNgq56X7p5jP2TYD/ 5IeAU1hrAxVH1320xlN61FWf3a/QhzNQZWshzSn0GpBo/vdTmz7uqGhxIb9Z5WrY sPi3rW5/F02TxG6PwON5Z253oLmqmuSXnYzeNS5eM2J7Qa2j/SLodSiBm4PJlMcl Uk7XXsIlsl7buLpljALp/4y6vlhqUBBJd8yYTRoRxhETOiUZeL8i7Dhv3MVW6g+y dn2KpDwI80/tUXx+nCXB9T9juKCFvvcD+QXlW9WVhvYOaKJesualMHQ2y16F83us hwoFisclUs9d2m4sJ6J1OEInWf/jNXpKF4LhC+CM32LTLm5P7bH2bKpEUkil0flR NkzWtUAJhPrQxlsSEnGr =O9Yr -----END PGP SIGNATURE----- --==-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Tue Mar 14 00:07:14 2017 Received: (at 24734) by debbugs.gnu.org; 14 Mar 2017 04:07:14 +0000 Received: from localhost ([127.0.0.1]:54584 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cndjt-0007F0-Vt for submit@debbugs.gnu.org; Tue, 14 Mar 2017 00:07:14 -0400 Received: from mail-it0-f65.google.com ([209.85.214.65]:33362) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cndjs-0007Eh-NY; Tue, 14 Mar 2017 00:07:13 -0400 Received: by mail-it0-f65.google.com with SMTP id g138so8092978itb.0; Mon, 13 Mar 2017 21:07:12 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=zqACFlLALZJVWtpI6V5F1KAQ90qBgtecoVaA8ph4BuE=; b=efH+dvQdZYsFd+999Nx+UB4rRoaaJQlcmfWbDDFl1R1U8fCVBlse2sjWom3kI4gseM 76/C7/kbxoajatDt9TeLSiUC6c3s56RHtQl5Fasj90cegO380DzWESyW6fpmmkaPnlwM xQ8q3OymnRH9tmxOGt9Gyj6ZEaqSGNQ0Zf56wnnFtwNUDJMN6qVq//GkzilBP/rEGzZr TYDHhvn+yiS/qPRK75gP1N7UKYU/rs2YQ+PPnlOVsfmnpbUum3RljWDXIL7x8j7dsvEx Dk78nb88B/7Dlr6KIDtl/sgztPUzAV9bO7Y4LVtuGsgC3B4Okpyu8xNb+ABzUyY1LzEj F0jQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version; bh=zqACFlLALZJVWtpI6V5F1KAQ90qBgtecoVaA8ph4BuE=; b=CqR/OHwVR01B/nbfyXY6QmRPKhIfAv5u4ZX0yxdYy6EJkvo8oet4Y/y2216tlj+MB5 S56wPdrcWAxolNtgLTYJIkyJNePVADQIBhU55TzbDR8mSNI8Z2K2o+r1Xdf3SjwwynC2 JDr5Ixg9CfnH1I7minlDcp1/P9Kkh+gJ4P2/kDNhEwFvScWkxhg1ACBM1XmsIAD8FiR6 8wDgwKWTPOeeF74HzajpNqBGgMCnQIkMz/F5M1Rlwf5GFhUUYOI5IP7CvF9w9Qea4i/9 QW41kNGF5lCNex278lbe/f0E1qyZlDZhM5VyyFFOGNxBgOlgD8reZnoNuz+wtTayRWhx CSwQ== X-Gm-Message-State: AFeK/H1XYHIifd08WDXZz0zYT3GAXt74iAz2mAYxTGdlJ1ZRf33QkTSc4l2KhPIg3urwcw== X-Received: by 10.36.14.77 with SMTP id 74mr13193171ite.115.1489464427216; Mon, 13 Mar 2017 21:07:07 -0700 (PDT) Received: from zony ([45.2.7.65]) by smtp.googlemail.com with ESMTPSA id f9sm4634468itf.9.2017.03.13.21.07.06 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 13 Mar 2017 21:07:06 -0700 (PDT) From: npostavs@users.sourceforge.net To: Hong Xu Subject: Re: bug#24734: Minor improvement of the doc of lisp/paren.el References: <8737jkmad5.fsf@topbug.net> <87pomdn1ln.fsf@topbug.net> Date: Tue, 14 Mar 2017 00:08:24 -0400 In-Reply-To: <87pomdn1ln.fsf@topbug.net> (Hong Xu's message of "Wed, 02 Nov 2016 12:06:12 -0700") Message-ID: <877f3s7b5z.fsf@users.sourceforge.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.7 (/) X-Debbugs-Envelope-To: 24734 Cc: 24734@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 (/) tags 24734 fixed close 24734 25.2 quit Hong Xu writes: > > The attachment is an updated version. Pushed to emacs-25 [1: 6de8429c29]. 1: 2017-03-14 00:07:14 -0400 6de8429c2989d0fccab0a485c7f28e522e07fa92 * lisp/paren.el (show-paren--default, show-paren-function): Add docstring. From unknown Wed Jun 18 00:30:21 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Tue, 11 Apr 2017 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