From unknown Mon Aug 18 11:25:10 2025 X-Loop: help-debbugs@gnu.org Subject: bug#33179: 26; Doc string of `filter-buffer-substring' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 27 Oct 2018 17:25:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 33179 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 33179@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.154066109116287 (code B ref -1); Sat, 27 Oct 2018 17:25:02 +0000 Received: (at submit) by debbugs.gnu.org; 27 Oct 2018 17:24:51 +0000 Received: from localhost ([127.0.0.1]:45703 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGSKR-0004Eb-Ai for submit@debbugs.gnu.org; Sat, 27 Oct 2018 13:24:51 -0400 Received: from eggs.gnu.org ([208.118.235.92]:42835) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGSKP-0004EJ-1u for submit@debbugs.gnu.org; Sat, 27 Oct 2018 13:24:49 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gGSKJ-0007Mk-7X for submit@debbugs.gnu.org; Sat, 27 Oct 2018 13:24:43 -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 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:45247) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gGSKJ-0007Mg-3h for submit@debbugs.gnu.org; Sat, 27 Oct 2018 13:24:43 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:52443) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gGSKI-0008LS-At for bug-gnu-emacs@gnu.org; Sat, 27 Oct 2018 13:24:43 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gGSKF-0007KP-3Z for bug-gnu-emacs@gnu.org; Sat, 27 Oct 2018 13:24:42 -0400 Received: from userp2130.oracle.com ([156.151.31.86]:60238) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gGSKC-0007IY-Sz for bug-gnu-emacs@gnu.org; Sat, 27 Oct 2018 13:24:38 -0400 Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w9RHNVeh180906 for ; Sat, 27 Oct 2018 17:24:33 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=gq9v2WophiPKaw6XTqSWpuOSuCjA1xaOLqZTuiV/apU=; b=vBQCW+EdQNAyuQFGEOPxFMBuagUPjkOBXIFT90DMy8aISirVQgyi49aWwS+3c+6ReO/r NPtO7F5vyf6uXlIyWwnwSZouCdCcSVK0S0hhbrtwpzUA+aFigF1+xhxBaoMLXofIrUtQ l0XQBd7c/9y22nlPYfjvmCjXEo5SASKO0uwF8ftQ5rk7rDi2rutLFEKDTS5pnJkI6i9w vIQYGFm7saGfgmxgEsr6Wux0bZzQDWLGS4h64yoPdupmChNHslBXGF/bcpeYRXevxABW PFnZkpB9i9nksYcqytI6WZuiqjQJ1P+FtRTjrxUIvDeXPy8PzhWWOrLQVm9RreTOSICL sg== Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by userp2130.oracle.com with ESMTP id 2ncfet93x5-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 27 Oct 2018 17:24:33 +0000 Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0022.oracle.com (8.14.4/8.14.4) with ESMTP id w9RHOXUV007012 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 27 Oct 2018 17:24:33 GMT Received: from abhmp0006.oracle.com (abhmp0006.oracle.com [141.146.116.12]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w9RHOWXR000938 for ; Sat, 27 Oct 2018 17:24:33 GMT MIME-Version: 1.0 Message-ID: <08b6c241-7972-48e3-b354-95b6cb50fe52@default> Date: Sat, 27 Oct 2018 10:24:32 -0700 (PDT) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4756.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9059 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=993 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1807170000 definitions=main-1810270162 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 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-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: -5.0 (-----) IIUC, the meaning of "extract" in this sentence is to exclude the chars from the result. If so, please consider using "exclude" or "remove" (preferably the former, as nothing is removed from the buffer) instead. "Extract" can give the impression that those chars are extracted as the result, rather than being excluded from the result. "For example, major or minor modes can use 'filter-buffer-substring-function' to extract characters that are ^^^^^^^ special to a buffer, and should not be copied into other buffers." Yes, if read carefully one can guess what was really meant here, because of the "and should not..." part. Still, the text can be misleading as it is now. In GNU Emacs 26.1 (build 1, x86_64-w64-mingw32) of 2018-05-30 Repository revision: 07f8f9bc5a51f5aa94eb099f3e15fbe0c20ea1ea Windowing system distributor `Microsoft Corp.', version 10.0.16299 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3'' From unknown Mon Aug 18 11:25:10 2025 X-Loop: help-debbugs@gnu.org Subject: bug#33179: 26; Doc string of `filter-buffer-substring' Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 27 Oct 2018 18:54:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 33179 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 33179@debbugs.gnu.org Received: via spool by 33179-submit@debbugs.gnu.org id=B33179.154066643124285 (code B ref 33179); Sat, 27 Oct 2018 18:54:02 +0000 Received: (at 33179) by debbugs.gnu.org; 27 Oct 2018 18:53:51 +0000 Received: from localhost ([127.0.0.1]:45723 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGTiY-0006Jd-QH for submit@debbugs.gnu.org; Sat, 27 Oct 2018 14:53:51 -0400 Received: from eggs.gnu.org ([208.118.235.92]:58640) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGTiW-0006JP-Px for 33179@debbugs.gnu.org; Sat, 27 Oct 2018 14:53:49 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gGTiO-0000b3-Ij for 33179@debbugs.gnu.org; Sat, 27 Oct 2018 14:53:43 -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 autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:60686) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gGTiO-0000ax-FK; Sat, 27 Oct 2018 14:53:40 -0400 Received: from [176.228.60.248] (port=1723 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1gGTiO-0005W3-1C; Sat, 27 Oct 2018 14:53:40 -0400 Date: Sat, 27 Oct 2018 21:53:45 +0300 Message-Id: <83in1nmdae.fsf@gnu.org> From: Eli Zaretskii In-reply-to: <08b6c241-7972-48e3-b354-95b6cb50fe52@default> (message from Drew Adams on Sat, 27 Oct 2018 10:24:32 -0700 (PDT)) References: <08b6c241-7972-48e3-b354-95b6cb50fe52@default> 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-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: -6.0 (------) > Date: Sat, 27 Oct 2018 10:24:32 -0700 (PDT) > From: Drew Adams > > IIUC, the meaning of "extract" in this sentence is to exclude the chars > from the result. No, I don't think it means that. It means "take". From unknown Mon Aug 18 11:25:10 2025 X-Loop: help-debbugs@gnu.org Subject: bug#33179: 26; Doc string of `filter-buffer-substring' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 27 Oct 2018 19:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 33179 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii , Drew Adams Cc: 33179@debbugs.gnu.org Received: via spool by 33179-submit@debbugs.gnu.org id=B33179.154066742525951 (code B ref 33179); Sat, 27 Oct 2018 19:11:02 +0000 Received: (at 33179) by debbugs.gnu.org; 27 Oct 2018 19:10:25 +0000 Received: from localhost ([127.0.0.1]:45734 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGTyb-0006kV-I6 for submit@debbugs.gnu.org; Sat, 27 Oct 2018 15:10:25 -0400 Received: from aserp2120.oracle.com ([141.146.126.78]:59264) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGTyZ-0006kI-I8 for 33179@debbugs.gnu.org; Sat, 27 Oct 2018 15:10:23 -0400 Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w9RJ9014047656; Sat, 27 Oct 2018 19:10:17 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=Pa3ACVk836KIqxy3b0iD64LgoIIe+vV1jR8cflNlt7Q=; b=vNq+DDHEv9AEU8EFGeKA4CIuTQOHc7/zPNDpCtBiNw3KDbq0nxHlWv0uIoWI7NWKMnch Dq+4gcsrzD817XHesdD3JzhlkTyrJvQUlBRQopU/4swpMRfFt4Q5Z5zUxaWOeH/bEglM gUfKb4nYC56F5IUAIviTOlgxTzaNdn1KZPA6YhgCYkLtdmqLAp9vWgKOmjHt2ckO5/Hl bhmoorBcqwBdkMQjwkA4m5gCq07bWToga5sRm7OB6jSz1LGTPCwofSr2mavU5Z5XpMNC Zbdx2luyG42NsKxuARQgoNdD2vXodoD8l8xkgNgO/4VDvaXD4WmJLBtNM0ZmG7wPASW1 6Q== Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp2120.oracle.com with ESMTP id 2ncfyph582-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 27 Oct 2018 19:10:17 +0000 Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserv0022.oracle.com (8.14.4/8.14.4) with ESMTP id w9RJAG5r023956 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 27 Oct 2018 19:10:17 GMT Received: from abhmp0006.oracle.com (abhmp0006.oracle.com [141.146.116.12]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w9RJAFa2000971; Sat, 27 Oct 2018 19:10:16 GMT MIME-Version: 1.0 Message-ID: <8c1ed257-be78-4355-84a1-572cfa1d3af6@default> Date: Sat, 27 Oct 2018 12:10:15 -0700 (PDT) From: Drew Adams References: <<08b6c241-7972-48e3-b354-95b6cb50fe52@default>> <<83in1nmdae.fsf@gnu.org>> In-Reply-To: <<83in1nmdae.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4756.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9059 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=865 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1807170000 definitions=main-1810270177 X-Spam-Score: -2.3 (--) 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: -3.3 (---) > > IIUC, the meaning of "extract" in this sentence is to exclude the > > chars from the result. >=20 > No, I don't think it means that. It means "take". Then I don't understand the "and should not be copied into other buffers" part. I thought that text describes a situation where you want to return some parts, for copying to another buffer, and you want to exclude other parts from that copying. By "copying into other buffers" does we mean copy+paste here? What kind of copying is meant? In sum, it's not clear to me what that "For example..." sentence is trying to describe. I thought I had some idea, but that was apparently the wrong idea. From unknown Mon Aug 18 11:25:10 2025 X-Loop: help-debbugs@gnu.org Subject: bug#33179: 26; Doc string of `filter-buffer-substring' Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 27 Oct 2018 19:26:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 33179 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 33179@debbugs.gnu.org Received: via spool by 33179-submit@debbugs.gnu.org id=B33179.154066834227357 (code B ref 33179); Sat, 27 Oct 2018 19:26:01 +0000 Received: (at 33179) by debbugs.gnu.org; 27 Oct 2018 19:25:42 +0000 Received: from localhost ([127.0.0.1]:45747 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGUDO-00077B-Bw for submit@debbugs.gnu.org; Sat, 27 Oct 2018 15:25:42 -0400 Received: from eggs.gnu.org ([208.118.235.92]:35847) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGUDN-000770-Jx for 33179@debbugs.gnu.org; Sat, 27 Oct 2018 15:25:41 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gGUD6-0000DU-QV for 33179@debbugs.gnu.org; Sat, 27 Oct 2018 15:25:31 -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 autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:32802) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gGUD6-0000D6-Hn; Sat, 27 Oct 2018 15:25:24 -0400 Received: from [176.228.60.248] (port=3660 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1gGUD3-0005BX-RC; Sat, 27 Oct 2018 15:25:24 -0400 Date: Sat, 27 Oct 2018 22:25:23 +0300 Message-Id: <83ftwrmbto.fsf@gnu.org> From: Eli Zaretskii In-reply-to: <8c1ed257-be78-4355-84a1-572cfa1d3af6@default> (message from Drew Adams on Sat, 27 Oct 2018 12:10:15 -0700 (PDT)) References: <<08b6c241-7972-48e3-b354-95b6cb50fe52@default>> <<83in1nmdae.fsf@gnu.org>> <8c1ed257-be78-4355-84a1-572cfa1d3af6@default> 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-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: -6.0 (------) > Date: Sat, 27 Oct 2018 12:10:15 -0700 (PDT) > From: Drew Adams > Cc: 33179@debbugs.gnu.org > > > > IIUC, the meaning of "extract" in this sentence is to exclude the > > > chars from the result. > > > > No, I don't think it means that. It means "take". > > Then I don't understand the "and should not be copied > into other buffers" part. It's a "for example", so not very important, IMO. From unknown Mon Aug 18 11:25:10 2025 X-Loop: help-debbugs@gnu.org Subject: bug#33179: 26; Doc string of `filter-buffer-substring' Resent-From: Noam Postavsky Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 27 Oct 2018 19:33:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 33179 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 33179@debbugs.gnu.org, Eli Zaretskii Received: via spool by 33179-submit@debbugs.gnu.org id=B33179.154066877928073 (code B ref 33179); Sat, 27 Oct 2018 19:33:02 +0000 Received: (at 33179) by debbugs.gnu.org; 27 Oct 2018 19:32:59 +0000 Received: from localhost ([127.0.0.1]:45757 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGUKR-0007Ii-Jp for submit@debbugs.gnu.org; Sat, 27 Oct 2018 15:32:59 -0400 Received: from mail-io1-f47.google.com ([209.85.166.47]:33221) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGUKP-0007IV-Oe for 33179@debbugs.gnu.org; Sat, 27 Oct 2018 15:32:58 -0400 Received: by mail-io1-f47.google.com with SMTP id l25-v6so2726233ioj.0 for <33179@debbugs.gnu.org>; Sat, 27 Oct 2018 12:32:57 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=nv1Gr9WtSPCIrYz3wMQe7SPOI/3AG7BmcSHAu2YR28I=; b=JoG+cUOYTaYVDcNalQ5aVbh8gYy4pyDmDhPN/swtM+tavxaiIiY0XVCkNBUfALzLFy 83LlUh/X2dZ03FcbvZWjgD56bgQJWS06fDNYJ7+ljvNibQH9ZkgomPMHT+I943n6sl82 mOF0XSS8za6TXtcWzXV4Ebs6s6cOufEtJdAUv9rsFCI+9AVOlZ9Q5Wx4itLVTrGsvAdH KQq8iT3VlZ0oTBAuqxtBeDp5419G/3SiwJKdu46JXEMOhTFWLxPczJn5leg+O92ms8dk feUCGheFWeYSaE4jNj2+OcwflXHcyl4pPcramUZCXL18Mg1kQQuT0eSGPMEvZqK3kX8V qleQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=nv1Gr9WtSPCIrYz3wMQe7SPOI/3AG7BmcSHAu2YR28I=; b=MAr8+Qndz4vJXGGjdU3tIPPWQdqQyo2cOnNIXC0SiJled4tVXIlDXsCga3/5L2ePQe TNZE9f4WchFJ3ha5daarHjew+DFG5aJWObKuhLK9H1yYSLC2uyj3KnoNIcekxHLyR1ZM 93BPJRiL9GCOifwTpuOxYvCFo0WeEByTarzEeMX3T6nDoRZfvMRLFUNekrkNvmLJWOtg otXSAR9f8D4jQGtWn9/D7NG7ZLPzXDYrJkeW+qs/c18/09aZYhFX7HPTpraCAK41AwkS e1mos1katkZyx5L5GV6HCs3RUyZks/qJHAz6PrnJbrgz1SAAT+Y6d/6DbrqhpGW8I+VF KyKA== X-Gm-Message-State: AGRZ1gJyIzzlmxGsxRa724WDhurCwCbLZEJk6pWq7WwLMdNwRAp6Inn7 xTMeRJeUMKLaM5GflfoFf6Btm9vx X-Google-Smtp-Source: AJdET5fgoAwsINUAJLdwlWpeCUoZerFn8NiJ5OhiG4j/3DiEFTc+wOlOOS+8PnJ7Rp/82hBxfH2lIA== X-Received: by 2002:a6b:2b95:: with SMTP id r143-v6mr4621437ior.98.1540668771997; Sat, 27 Oct 2018 12:32:51 -0700 (PDT) Received: from zebian (cbl-45-2-119-34.yyz.frontiernetworks.ca. [45.2.119.34]) by smtp.googlemail.com with ESMTPSA id x67-v6sm1861777ita.3.2018.10.27.12.32.51 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sat, 27 Oct 2018 12:32:51 -0700 (PDT) From: Noam Postavsky References: <08b6c241-7972-48e3-b354-95b6cb50fe52@default>> <83in1nmdae.fsf@gnu.org>> <8c1ed257-be78-4355-84a1-572cfa1d3af6@default> Date: Sat, 27 Oct 2018 15:32:50 -0400 In-Reply-To: <8c1ed257-be78-4355-84a1-572cfa1d3af6@default> (Drew Adams's message of "Sat, 27 Oct 2018 12:10:15 -0700 (PDT)") Message-ID: <87h8h7jicd.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Spam-Score: -0.0 (/) 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: -1.0 (-) --=-=-= Content-Type: text/plain Drew Adams writes: >> > IIUC, the meaning of "extract" in this sentence is to exclude the >> > chars from the result. >> >> No, I don't think it means that. It means "take". > > Then I don't understand the "and should not be copied > into other buffers" part. I thought that text describes > a situation where you want to return some parts, for > copying to another buffer, and you want to exclude other > parts from that copying. For what it's worth, I read it like Drew does. I also think giving "characters" as an example doesn't make much sense, because I can't really think of characters so "special to a buffer" that they "should not be copied into other buffers". Grepping the Emacs source, the only example usage I found was in org-indent.el, which uses it to exclude text properties, so I propose changing the docstring example accordingly. --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=v1-0001-lisp-simple.el-filter-buffer-substring-Clarify-do.patch Content-Description: patch >From c0cbc1cb7d5bbb0942a76781c1ed29d1346e5644 Mon Sep 17 00:00:00 2001 From: Noam Postavsky Date: Sat, 27 Oct 2018 15:27:45 -0400 Subject: [PATCH v1] * lisp/simple.el (filter-buffer-substring): Clarify doc (Bug#33179). --- lisp/simple.el | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lisp/simple.el b/lisp/simple.el index 29bb9cbcfb..08f622ad8e 100644 --- a/lisp/simple.el +++ b/lisp/simple.el @@ -4232,7 +4232,7 @@ filter-buffer-substring Use `filter-buffer-substring' instead of `buffer-substring', `buffer-substring-no-properties', or `delete-and-extract-region' when you want to allow filtering to take place. For example, major or minor -modes can use `filter-buffer-substring-function' to extract characters +modes can use `filter-buffer-substring-function' to exclude text properties that are special to a buffer, and should not be copied into other buffers." (funcall filter-buffer-substring-function beg end delete)) -- 2.11.0 --=-=-=-- From unknown Mon Aug 18 11:25:10 2025 X-Loop: help-debbugs@gnu.org Subject: bug#33179: 26; Doc string of `filter-buffer-substring' Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 27 Oct 2018 19:39:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 33179 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Noam Postavsky Cc: 33179@debbugs.gnu.org, drew.adams@oracle.com Received: via spool by 33179-submit@debbugs.gnu.org id=B33179.154066913328589 (code B ref 33179); Sat, 27 Oct 2018 19:39:02 +0000 Received: (at 33179) by debbugs.gnu.org; 27 Oct 2018 19:38:53 +0000 Received: from localhost ([127.0.0.1]:45765 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGUQ8-0007R3-Ij for submit@debbugs.gnu.org; Sat, 27 Oct 2018 15:38:52 -0400 Received: from eggs.gnu.org ([208.118.235.92]:38025) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGUQ3-0007Qk-VB for 33179@debbugs.gnu.org; Sat, 27 Oct 2018 15:38:48 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gGUPr-0007uT-HP for 33179@debbugs.gnu.org; Sat, 27 Oct 2018 15:38: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=-1.9 required=5.0 tests=BAYES_00 autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:32948) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gGUPm-0007s9-68; Sat, 27 Oct 2018 15:38:30 -0400 Received: from [176.228.60.248] (port=4570 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1gGUPl-0003cl-4O; Sat, 27 Oct 2018 15:38:30 -0400 Date: Sat, 27 Oct 2018 22:38:32 +0300 Message-Id: <83d0rvmb7r.fsf@gnu.org> From: Eli Zaretskii In-reply-to: <87h8h7jicd.fsf@gmail.com> (message from Noam Postavsky on Sat, 27 Oct 2018 15:32:50 -0400) References: <08b6c241-7972-48e3-b354-95b6cb50fe52@default>> <83in1nmdae.fsf@gnu.org>> <8c1ed257-be78-4355-84a1-572cfa1d3af6@default> <87h8h7jicd.fsf@gmail.com> 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-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: -6.0 (------) > From: Noam Postavsky > Cc: Eli Zaretskii , 33179@debbugs.gnu.org > Date: Sat, 27 Oct 2018 15:32:50 -0400 > > For what it's worth, I read it like Drew does. I also think giving > "characters" as an example doesn't make much sense, because I can't > really think of characters so "special to a buffer" that they "should > not be copied into other buffers". Grepping the Emacs source, the only > example usage I found was in org-indent.el, which uses it to exclude > text properties, so I propose changing the docstring example > accordingly. > > >From c0cbc1cb7d5bbb0942a76781c1ed29d1346e5644 Mon Sep 17 00:00:00 2001 > From: Noam Postavsky > Date: Sat, 27 Oct 2018 15:27:45 -0400 > Subject: [PATCH v1] * lisp/simple.el (filter-buffer-substring): Clarify doc > (Bug#33179). This patch is fine with me, thanks. From unknown Mon Aug 18 11:25:10 2025 X-Loop: help-debbugs@gnu.org Subject: bug#33179: 26; Doc string of `filter-buffer-substring' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 27 Oct 2018 21:36:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 33179 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii , Noam Postavsky Cc: 33179@debbugs.gnu.org, drew.adams@oracle.com Received: via spool by 33179-submit@debbugs.gnu.org id=B33179.154067614515236 (code B ref 33179); Sat, 27 Oct 2018 21:36:01 +0000 Received: (at 33179) by debbugs.gnu.org; 27 Oct 2018 21:35:45 +0000 Received: from localhost ([127.0.0.1]:45863 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGWFF-0003xf-9T for submit@debbugs.gnu.org; Sat, 27 Oct 2018 17:35:45 -0400 Received: from userp2120.oracle.com ([156.151.31.85]:36768) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGWFE-0003xT-1b for 33179@debbugs.gnu.org; Sat, 27 Oct 2018 17:35:44 -0400 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w9RLYv9D077618; Sat, 27 Oct 2018 21:35:38 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=9b3HztpGcp/Ql4XlcDqpckK7BKqiNac4177KVTxHdsY=; b=w7rYPUmfh2Y1oDmpKs2YV7DTiQFQKrLCDsqUJ7bwCBREwh2HOesf01ynZsic3qJ4FVc7 D5N1zk+Ok11aJCRsFRQmQsFlw8rPXxXqg25BfW3A1koMfHfXELLnnueXfomAkUBQ6mPy GZJWg7DudAb50GD0/Xem1qK90ROCTjDX0o/9GbUG7PREmOxjKFR+CG2S/VMW9j3WmwEW bsNdasZQRexPnpYRjtkkGjPQ/8I7n2QjfdxuQ8rOSa2vAbVK7dl9J72XY4ZaSF5NMrz4 6vhOizyVuBKLszcbr6+zM7WeiyoyIztGzUoJBs3tFPWh57H3rFRvPCTEP+aRlZTWAiDz hg== Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by userp2120.oracle.com with ESMTP id 2ncgnqh6d7-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 27 Oct 2018 21:35:38 +0000 Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0022.oracle.com (8.14.4/8.14.4) with ESMTP id w9RLZbDu008145 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 27 Oct 2018 21:35:37 GMT Received: from abhmp0004.oracle.com (abhmp0004.oracle.com [141.146.116.10]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w9RLZbDG025827; Sat, 27 Oct 2018 21:35:37 GMT MIME-Version: 1.0 Message-ID: <9ec3ef58-90ca-494a-8831-70aa9168a690@default> Date: Sat, 27 Oct 2018 14:35:36 -0700 (PDT) From: Drew Adams References: <<08b6c241-7972-48e3-b354-95b6cb50fe52@default>> <83in1nmdae.fsf@gnu.org>>> <<8c1ed257-be78-4355-84a1-572cfa1d3af6@default>> <<87h8h7jicd.fsf@gmail.com>> <<83d0rvmb7r.fsf@gnu.org>> In-Reply-To: <<83d0rvmb7r.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4756.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9059 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=616 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1807170000 definitions=main-1810270198 X-Spam-Score: -2.3 (--) 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: -3.3 (---) > > For what it's worth, I read it like Drew does. I also think giving > > "characters" as an example doesn't make much sense, because I can't > > really think of characters so "special to a buffer" that they "should > > not be copied into other buffers". Grepping the Emacs source, the > only > > example usage I found was in org-indent.el, which uses it to exclude > > text properties, so I propose changing the docstring example > > accordingly. > > > This patch is fine with me, thanks. Thanks, guys. From unknown Mon Aug 18 11:25:10 2025 X-Loop: help-debbugs@gnu.org Subject: bug#33179: 26; Doc string of `filter-buffer-substring' Resent-From: Noam Postavsky Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 27 Oct 2018 22:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 33179 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 33179@debbugs.gnu.org, Eli Zaretskii Received: via spool by 33179-submit@debbugs.gnu.org id=B33179.154067755317396 (code B ref 33179); Sat, 27 Oct 2018 22:00:02 +0000 Received: (at 33179) by debbugs.gnu.org; 27 Oct 2018 21:59:13 +0000 Received: from localhost ([127.0.0.1]:45894 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGWbx-0004WR-Gn for submit@debbugs.gnu.org; Sat, 27 Oct 2018 17:59:13 -0400 Received: from mail-it1-f175.google.com ([209.85.166.175]:33387) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gGWbv-0004W9-6g; Sat, 27 Oct 2018 17:59:11 -0400 Received: by mail-it1-f175.google.com with SMTP id h6-v6so7289130ith.0; Sat, 27 Oct 2018 14:59:11 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=HYppP9+Q6u5aXzuvr0wRllxESRynB4H37qeKBrFKvr0=; b=O9ohcK2PHsOLmQvDPrjyTWpAe3CXh/2u1W7JFe6bN3h7t6mJ9NmEaZ+kfmy++GWR9T xPw3q7++KUWNbuQKXwY4J8FE+Hw96Ib/h6gKBjpMjigbEwRH52PgOy74EaHDYeNmgO2Y NAkFvAHhBq1uVr6Z3URAmmcGinXNIQQvUsDbsgxUbVSTE23sYBbMQ6GAjnCohETxpaCR uaNEs8dySN8/anLNSSiBSgPwd3DNFYxoUprZfjMY36cLJ/TbE7f61ey87HDbcW1LL/C5 p758Y4XuuhdoBaz3KoWy+twve5nSRkNBu/GsxXwAxAx0YUimj2oh2fBxZcoooq6ftrd+ efWg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=HYppP9+Q6u5aXzuvr0wRllxESRynB4H37qeKBrFKvr0=; b=t85MpUsjef0MtJOAfqEfIAgAYa9kO0jeyeZRria5+JwLfr+ia18JzCPI+OJH+rlZtp qVZz10VYhZVCYg2JHva0LSeWzFPQSQEBY6AcGa6qouB0G9xzctwWpi/4vSPMuUFcOn15 Li9VYxDX6/i0xrglrkSpHXnFFPk6/KAvRust4ZgtThGhlg/2LHMm41pNo/yhqzRoCFcL SSzIL2rTtoz2NKRDxM4jWNJOo+8H3Dx/KnnUP5eznUM8xR1/QHHHR5WutEKxO/E7XcDg JMeohUIhFVzYB0LW0V/oEFJmca3U1L4z/oBIttJCHSe2T0gMkJLmFl7RBPgS0dgfvs7d 9W0w== X-Gm-Message-State: AGRZ1gJUSt6Ox02UKeMtX+38CtIJXwy6KGNTpvkeIM8Y38dn/4q+yxup 2LD1FzxkRLmc8HqWUYtaYm/FaiEd X-Google-Smtp-Source: AJdET5fcLkaWYqcxAqNs3TRNYZwJxcRHhwb09GgvA7H5p6QMjxNBW3X+Ta6oxszN+lDbO6OMrLn4Lg== X-Received: by 2002:a24:5c54:: with SMTP id q81-v6mr6545813itb.112.1540677545430; Sat, 27 Oct 2018 14:59:05 -0700 (PDT) Received: from zebian (cbl-45-2-119-34.yyz.frontiernetworks.ca. [45.2.119.34]) by smtp.googlemail.com with ESMTPSA id q205-v6sm4979058iod.63.2018.10.27.14.59.04 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sat, 27 Oct 2018 14:59:04 -0700 (PDT) From: Noam Postavsky References: <08b6c241-7972-48e3-b354-95b6cb50fe52@default>> <83in1nmdae.fsf@gnu.org>>> <8c1ed257-be78-4355-84a1-572cfa1d3af6@default>> <87h8h7jicd.fsf@gmail.com>> <83d0rvmb7r.fsf@gnu.org>> <9ec3ef58-90ca-494a-8831-70aa9168a690@default> Date: Sat, 27 Oct 2018 17:59:03 -0400 In-Reply-To: <9ec3ef58-90ca-494a-8831-70aa9168a690@default> (Drew Adams's message of "Sat, 27 Oct 2018 14:35:36 -0700 (PDT)") Message-ID: <87bm7fjbko.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) 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: -1.0 (-) tags 33179 fixed close 33179 26.2 quit Drew Adams writes: >> > example usage I found was in org-indent.el, which uses it to exclude >> > text properties, so I propose changing the docstring example >> > accordingly. >> > >> This patch is fine with me, thanks. > > Thanks, guys. Pushed to emacs-26. [1: de2818432a]: 2018-10-27 17:56:28 -0400 * lisp/simple.el (filter-buffer-substring): Clarify doc (Bug#33179). https://git.savannah.gnu.org/cgit/emacs.git/commit/?id=de2818432acacea4eec35d5a92f240856de7b765