From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#33179: 26; Doc string of `filter-buffer-substring' Date: Sat, 27 Oct 2018 10:24:32 -0700 (PDT) Message-ID: <08b6c241-7972-48e3-b354-95b6cb50fe52@default> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1540660991 15147 195.159.176.226 (27 Oct 2018 17:23:11 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 27 Oct 2018 17:23:11 +0000 (UTC) To: 33179@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Oct 27 19:23:07 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 1gGSIj-0003nj-HG for geb-bug-gnu-emacs@m.gmane.org; Sat, 27 Oct 2018 19:23:05 +0200 Original-Received: from localhost ([::1]:37311 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gGSKq-0008O4-3l for geb-bug-gnu-emacs@m.gmane.org; Sat, 27 Oct 2018 13:25:16 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52496) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gGSKg-0008Nm-34 for bug-gnu-emacs@gnu.org; Sat, 27 Oct 2018 13:25:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gGSKc-0007Ui-QD for bug-gnu-emacs@gnu.org; Sat, 27 Oct 2018 13:25:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:41445) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gGSKc-0007UY-M5 for bug-gnu-emacs@gnu.org; Sat, 27 Oct 2018 13:25:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1gGSKc-0004F9-BV for bug-gnu-emacs@gnu.org; Sat, 27 Oct 2018 13:25:02 -0400 X-Loop: help-debbugs@gnu.org 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: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.154066109116287 (code B ref -1); Sat, 27 Oct 2018 17:25:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 27 Oct 2018 17:24:51 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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== Original-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 Original-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 Original-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 X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4756.0 (x86)] 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-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:151690 Archived-At: 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''