From debbugs-submit-bounces@debbugs.gnu.org Wed Apr 18 11:29:14 2018 Received: (at submit) by debbugs.gnu.org; 18 Apr 2018 15:29:15 +0000 Received: from localhost ([127.0.0.1]:59492 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f8p1G-0006yN-Mu for submit@debbugs.gnu.org; Wed, 18 Apr 2018 11:29:14 -0400 Received: from eggs.gnu.org ([208.118.235.92]:58068) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f8p1E-0006yA-4R for submit@debbugs.gnu.org; Wed, 18 Apr 2018 11:29:13 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1f8p18-0006Rv-2G for submit@debbugs.gnu.org; Wed, 18 Apr 2018 11:29:06 -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]:40040) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1f8p17-0006Rr-VS for submit@debbugs.gnu.org; Wed, 18 Apr 2018 11:29:06 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:48990) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f8p13-0004q3-VV for bug-gnu-emacs@gnu.org; Wed, 18 Apr 2018 11:29:05 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1f8p0y-0006Ny-Tr for bug-gnu-emacs@gnu.org; Wed, 18 Apr 2018 11:29:01 -0400 Received: from aserp2120.oracle.com ([141.146.126.78]:52192) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1f8p0y-0006NR-IZ for bug-gnu-emacs@gnu.org; Wed, 18 Apr 2018 11:28:56 -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 w3IFPsYt052274 for ; Wed, 18 Apr 2018 15:28:54 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-2017-10-26; bh=Sbw7qykQabs7XYcUTf+0yBVNY5HAQgfaDcWsQBSmnWo=; b=Gt0r5lp4FMzMYrAEXgemzy07q3PmV0VCh+N/SbXWOrD+SVEDObx+bHqbHZDmUk+RC2QK TfT5C9FnbyqsSBKvIOIttU+ALfW8QYIP7rK8sOzoq9FxYpVcrrY8sIpC9hpzJQL4coo4 ExvlznFOHa67KdT4liyi5fky5fj5voDFiemeqX73K0ss9Oqev6NnvlwX/ORzTg55AO4n Hy4uyQm/Tk2XORRPETnOKCq47z16RiHyetvpNtaW62IEMARmg8Ivt45BcgrEeNkGUvd4 mYtjSdDzlGMG5h9W3lVYU7n35VAA4zi/t7ogNJNsXWgDyqK//eRrdCIjvKZZqtcxPYss Qg== Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by aserp2120.oracle.com with ESMTP id 2hdrxnb8u0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 18 Apr 2018 15:28:54 +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 w3IFSr1d017466 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 18 Apr 2018 15:28:53 GMT Received: from abhmp0016.oracle.com (abhmp0016.oracle.com [141.146.116.22]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w3IFSqMo023103 for ; Wed, 18 Apr 2018 15:28:53 GMT MIME-Version: 1.0 Message-ID: <5cbda7e0-323f-450f-9e64-b73fc3b39e44@default> Date: Wed, 18 Apr 2018 08:28:51 -0700 (PDT) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 26; Doc strings of commands and other functions of `replace.el' X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4678.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8866 signatures=668698 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1711220000 definitions=main-1804180140 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] 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: -5.0 (-----) 1. The doc strings of many functions do not describe all of their args, including these: query-replace-read-from query-replace-compile-replacement query-replace-read-to query-replace query-replace-regexp replace-string replace-regexp occur-mode-goto-occurrence occur-next-error occur-rename-buffer multi-occur multi-occur-in-matching-buffers perform-replace =20 In many cases, it is the more recently added args which are not documented (of the args of recently added functions). This suggests oversight/laziness - no one has yet bothered to DTRT for those newly added args. 2. There are also numerous functions in this file that have no doc strings. They should have doc strings, and those doc strings should describe the arguments. For example, none of the `occur-engine' functions have doc strings. Laziness on the part of the person who added them, perhaps - but this should be corrected now. 3. In some cases there are poorly named args whose names are not explained (the args are not really described). For example, BUFREGEXP. In GNU Emacs 26.1 (build 1, x86_64-w64-mingw32) of 2018-04-10 Repository revision: c267421647510319d2a70554e42f0d1c394dba0a Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3'' From debbugs-submit-bounces@debbugs.gnu.org Sun Oct 06 13:27:33 2019 Received: (at 31207) by debbugs.gnu.org; 6 Oct 2019 17:27:33 +0000 Received: from localhost ([127.0.0.1]:46780 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHAJh-0007x0-7v for submit@debbugs.gnu.org; Sun, 06 Oct 2019 13:27:33 -0400 Received: from aserp2120.oracle.com ([141.146.126.78]:49080) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHAJg-0007wl-5F for 31207@debbugs.gnu.org; Sun, 06 Oct 2019 13:27:32 -0400 Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x96HQ19P184486 for <31207@debbugs.gnu.org>; Sun, 6 Oct 2019 17:27:26 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2019-08-05; bh=VxKnFNB/tFfNQjGEjh9jpWij0q2eCVK0jDD4PTfjllw=; b=WzdElWnTBfaYsX0DL/XNPN13ByuqaFRlVjT7MmO2LMs8qYQT1rZ4MbfgCXjBxTd4nXCe /wv93m6ntWYBrT4yZoDtGmDAGXveifmT1j65rS8VysoGC4Ay8EQPPFVkj042l+UgWwFM 9I4rn51THpkTLmLkvCzKCf8/e3RveUDWU85jonb5Ld0ERfN2xwA+AMO8F6KcAyUYo8G3 aiCIeI36znOr/ISDnKGQjG0Y0EcRe7d4dnPn6OKVnbw6AgwwlWhMpJR2W7bIv0X4mgKA eLT5A0lWokNOhs+2xuPlgEkA0EQ4euO3mDlEp8A58ramLuXIytyWQydePljszdS3lcxF bw== Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by aserp2120.oracle.com with ESMTP id 2vek4q3jnh-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for <31207@debbugs.gnu.org>; Sun, 06 Oct 2019 17:27:26 +0000 Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x96HN2nH123531 for <31207@debbugs.gnu.org>; Sun, 6 Oct 2019 17:27:25 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userp3020.oracle.com with ESMTP id 2vf5ajemeb-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for <31207@debbugs.gnu.org>; Sun, 06 Oct 2019 17:27:25 +0000 Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id x96HROV4011121 for <31207@debbugs.gnu.org>; Sun, 6 Oct 2019 17:27:24 GMT MIME-Version: 1.0 Message-ID: Date: Sun, 6 Oct 2019 10:27:23 -0700 (PDT) From: Drew Adams To: 31207@debbugs.gnu.org Subject: RE: bug#31207: 26; Doc strings of commands and other functions of `replace.el' References: <5cbda7e0-323f-450f-9e64-b73fc3b39e44@default> In-Reply-To: <5cbda7e0-323f-450f-9e64-b73fc3b39e44@default> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4900.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9402 signatures=668684 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=13 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=739 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1910060178 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9402 signatures=668684 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=13 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=838 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1910060178 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 31207 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 (---) Ping. I was about to file a new bug, just to say that for `query-replace(-regexp)' there is no description of argument REGION-NONCONTIGUOUS-P. Checked my posted bug reports and came across this one, which never got a reply. The functions in `replace.el' really need to have their arguments described in their doc strings. Especially so, since most of the functions are not documented in the Elisp manual. The doc strings are all users have as guidance (beyond the source code itself). From debbugs-submit-bounces@debbugs.gnu.org Mon Oct 07 07:36:52 2019 Received: (at 31207) by debbugs.gnu.org; 7 Oct 2019 11:36:52 +0000 Received: from localhost ([127.0.0.1]:47417 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHRJs-0006Gf-Da for submit@debbugs.gnu.org; Mon, 07 Oct 2019 07:36:52 -0400 Received: from mail-wm1-f51.google.com ([209.85.128.51]:55275) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHRJq-0006GQ-B3 for 31207@debbugs.gnu.org; Mon, 07 Oct 2019 07:36:51 -0400 Received: by mail-wm1-f51.google.com with SMTP id p7so12266675wmp.4 for <31207@debbugs.gnu.org>; Mon, 07 Oct 2019 04:36:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:mail-copies-to:gmane-reply-to-list :date:in-reply-to:message-id:mime-version; bh=xTZsm9BOrUrZUUI4f5GFvR06xOB2VjbEU5r/p6cIaB0=; b=DsGdFMvBYp/1yyjCDylCe9Qj+gpzHpuo/WrflB2u5kTwwAgp8Yq+jS46+Chkbsygqf 08yCWItlj2cRjM0OuNiFPJ1WQo57xCGzva328qhCyeowUSiOfbaDB6PcAU7YjpVgRusv xIfbEAThe2YC6B9NvxZ+Q4knQhtzywynDeGZ1He53gBtIQ0uf5l4b8aTcN1Yx3jIp2NO oa9w/2hV2N4ciZk8b2Gdx9ENtPPjBze2fXsTCKKS5UdzzzZhyQjguDakDGypAPKkbTe0 D5VhX6iICMeYjga8iTS33mEDtETQFcSG3uTbiacJKKkYJkDbNXZo+ZlfRfGI2G7zLQCn oMIA== 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:mail-copies-to :gmane-reply-to-list:date:in-reply-to:message-id:mime-version; bh=xTZsm9BOrUrZUUI4f5GFvR06xOB2VjbEU5r/p6cIaB0=; b=YJ3TxJUKO82jZ/1be4n5YrC/CUm1lWow9xRTztGKnuVIsmX2x9G+w2KO3jkf7Gb32d p2E6cMjnkUfXpJo06Nzj0ZfOiHVBMbcefTCOunaLHVGdZNgJW/AkSmgwjgsE/eAreO3a +VrlFSdvTrnyYWG2sothtlKCJ0Tvr0ApCHZ/C1Ah+oSYgJhkS8gsZ1saUI2urshVGJre Cuq9HkGPIieWfHoUdJKXAOd7WPRz3vXXZj8SGFo0xuwlCyCTHa1N9zq8KKlkzgZBVHKo MOe6h1FsTpE6RWdOTY9jI2NosgQS0OaN6U/27A/5R46TRam1zjrHAYCt4HH4dCPZaJFR Hdgg== X-Gm-Message-State: APjAAAVugbo85npWDFqzOA4P+WAULpLn5UK5YvFeClg4J6X2bCPYv7Id FJt1ENnovUqznghFJ5LEmYdAR/Rb X-Google-Smtp-Source: APXvYqw2cgLN9ZrdOw5OCmyeCUrCtuj+mCt1hHR/j2YiIlshAufoih19a21EnX0Ux/hc64jpE2YBgQ== X-Received: by 2002:a05:600c:2291:: with SMTP id 17mr12296275wmf.58.1570448203898; Mon, 07 Oct 2019 04:36:43 -0700 (PDT) Received: from rpluim-mac ([149.5.228.1]) by smtp.gmail.com with ESMTPSA id j26sm22607099wrd.2.2019.10.07.04.36.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 07 Oct 2019 04:36:42 -0700 (PDT) From: Robert Pluim To: Drew Adams Subject: Re: bug#31207: 26; Doc strings of commands and other functions of `replace.el' References: <5cbda7e0-323f-450f-9e64-b73fc3b39e44@default> X-Debbugs-No-Ack: yes Mail-Copies-To: never Gmane-Reply-To-List: yes Date: Mon, 07 Oct 2019 13:36:41 +0200 In-Reply-To: (Drew Adams's message of "Sun, 6 Oct 2019 10:27:23 -0700 (PDT)") Message-ID: MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 31207 Cc: 31207@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: -1.0 (-) >>>>> On Sun, 6 Oct 2019 10:27:23 -0700 (PDT), Drew Adams said: Drew> Ping. Drew> I was about to file a new bug, just to say that for Drew> `query-replace(-regexp)' there is no description of Drew> argument REGION-NONCONTIGUOUS-P. query-replace: Arguments FROM-STRING, TO-STRING, DELIMITED, START, END, BACKWARD, and REGION-NONCONTIGUOUS-P are passed to `perform-replace' (which see). perform-replace: Non-nil REGION-NONCONTIGUOUS-P means that the region is composed of noncontiguous pieces. The most common example of this is a rectangular region, where the pieces are separated by newline characters." Drew> Checked my posted bug reports and came across this Drew> one, which never got a reply. Drew> The functions in `replace.el' really need to have Drew> their arguments described in their doc strings. Did you have specific functions in mind? There are quite a few in that file. Robert From debbugs-submit-bounces@debbugs.gnu.org Mon Oct 07 13:30:08 2019 Received: (at 31207) by debbugs.gnu.org; 7 Oct 2019 17:30:08 +0000 Received: from localhost ([127.0.0.1]:49038 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHWpk-0002Ja-1C for submit@debbugs.gnu.org; Mon, 07 Oct 2019 13:30:08 -0400 Received: from userp2120.oracle.com ([156.151.31.85]:39908) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHWph-0002Hj-Hx for 31207@debbugs.gnu.org; Mon, 07 Oct 2019 13:30:06 -0400 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x97HP2Ph068772; Mon, 7 Oct 2019 17:29:59 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-2019-08-05; bh=scE/Eu82BapAIPvJXUKftK1J1+fy7T/tDlTxD0cfugw=; b=d16EimZzI9c2+3n4i6a7knMiDZ4riFz/9QB7ZhJXTtYNy3Vo3Z8wjTFdSP+lvxwhH6w1 MBVNeS1tVxAPaJxt4Jrv5AnBuXgXG5lNi1RNCpuiVaDYf1Ok0RgClesoAsBh6vX+KubF NgJcagxkOzNiYvGcwoSUENM/+f9NfqkmGjfI6DQvHNwBVmbhPRzj37wrMAHbovtiytDp Js/zwM6wfzA5dn9bimW5YlknivR6pxbcBREPu9a9E1uuiGFvOtZ3q6N7vw/d12yY8Uz7 hDPkSkFmPFR6isZ8AVDY1ttjr6XCC2ZF1BO0Fi0EnNfwbTY1MaiPyRD8979SFM3nhIN/ QA== Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by userp2120.oracle.com with ESMTP id 2vektr84a9-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 07 Oct 2019 17:29:59 +0000 Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x97HTpca045472; Mon, 7 Oct 2019 17:29:59 GMT Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userp3030.oracle.com with ESMTP id 2vf4n9qsm5-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 07 Oct 2019 17:29:53 +0000 Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id x97HTHhm029521; Mon, 7 Oct 2019 17:29:17 GMT MIME-Version: 1.0 Message-ID: Date: Mon, 7 Oct 2019 10:29:15 -0700 (PDT) From: Drew Adams To: Robert Pluim Subject: RE: bug#31207: 26; Doc strings of commands and other functions of `replace.el' References: <5cbda7e0-323f-450f-9e64-b73fc3b39e44@default> In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4900.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9403 signatures=668684 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=765 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1910070159 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9403 signatures=668684 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=852 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1910070159 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 31207 Cc: 31207@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: -3.3 (---) > Drew> for `query-replace(-regexp)' there is no > description of argument REGION-NONCONTIGUOUS-P. >=20 > query-replace: >=20 > Arguments FROM-STRING, TO-STRING, DELIMITED, START, END, BACKWARD, an= d > REGION-NONCONTIGUOUS-P are passed to `perform-replace' (which see). I have only Emacs 26.3 - the latest release, and the release I reported on. That text is not in the doc string. > perform-replace: >=20 > Non-nil REGION-NONCONTIGUOUS-P means that the region is composed of > noncontiguous pieces. The most common example of this is a > rectangular region, where the pieces are separated by newline > characters." That too is missing from Emacs 26.3. If you feel that this bug is completely fixed in Emacs 27, please close it as "fixed". Thx. From debbugs-submit-bounces@debbugs.gnu.org Tue Oct 08 07:32:28 2019 Received: (at 31207) by debbugs.gnu.org; 8 Oct 2019 11:32:28 +0000 Received: from localhost ([127.0.0.1]:49640 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHnj9-0001Qc-Rd for submit@debbugs.gnu.org; Tue, 08 Oct 2019 07:32:28 -0400 Received: from mail-wm1-f49.google.com ([209.85.128.49]:35386) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHnj7-0001NB-Ks for 31207@debbugs.gnu.org; Tue, 08 Oct 2019 07:32:26 -0400 Received: by mail-wm1-f49.google.com with SMTP id y21so2758871wmi.0 for <31207@debbugs.gnu.org>; Tue, 08 Oct 2019 04:32:25 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:mail-copies-to:gmane-reply-to-list :date:in-reply-to:message-id:mime-version:content-transfer-encoding; bh=9t/oq2YBXu5YrC6XAXTe3DloiscsuF7aXtOj01IwiEY=; b=VnVP5wVIY+2myLx5QJK/77RGfSVP6Jq2TDc94jpns6K4VCxZP93xneX9Rb4ot85mSM 6i72EVRtiDDCyGp1A9p7h5r7AgUrtAtEykPqnCVnqs1X6eaaNPRxzktYIkE44ZbEVcIJ 0nfyPTLt5kG9ATr7K3vr0g7a1ALVJXIY3xs/2UI3XClVFNNKLWzu8cg7D3KsBNRd5rx5 TuRtoYMpf5ve2rYk2DbeXxRG1c6UF1KMiMxd8AayGCdrPTk1ebZ+w9NCXj4+3/fC19U0 wuzRcseqvj0ZSdUJZN5hFaVGCr3AK9dJRKN6NAbEReRVJFHHxPiyM/LvGJx2J4i7tBNb CyIA== 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:mail-copies-to :gmane-reply-to-list:date:in-reply-to:message-id:mime-version :content-transfer-encoding; bh=9t/oq2YBXu5YrC6XAXTe3DloiscsuF7aXtOj01IwiEY=; b=sWNSzwendXYYxMpIWJ4t/6tNirMZnHXB34d6IaWayxZn+rqA4jQd+NdZV8pNru/usm Eik9tMZPxku/goTFTTnxeRRISTzzuSiHMDiV8sp1r8xOLZswx23kcBBV5TBQ5nRguBbb x6uEfoOVKd/uijNCEdU2/9XRKGCTbP3qnz+4eaYQBpOFtcMF1ea4EWxv73p3Kf1kYDot Dm2XN5hpq9f3wgdCIaNNL1i9G28yeH5RUM2dwrmpxGxWko1YtXra2um3KGA2jqUqyi3m FnQfzT0pJ7rXARxfYec9lN0NNNeL0/hAkoTrE7f6o/la8/ZlmhXLrMNdUPEvMkzSirXX wB2Q== X-Gm-Message-State: APjAAAUYnvaNNSO/mmMMd/1zLoKlZqGwtg1v/8qISuTqnKt66IFgwWJS lkrfIVsdGGsHD0pudMvRC+iP5IH4uik= X-Google-Smtp-Source: APXvYqxjh1pOCXsTUPajm9q4I2m0H1ceoYKEB3Jm94kvhy7SuGCWUPcAH/X7SqvU+JJiq4ovA7cqQA== X-Received: by 2002:a1c:9d0b:: with SMTP id g11mr3268555wme.22.1570534339298; Tue, 08 Oct 2019 04:32:19 -0700 (PDT) Received: from rpluim-mac ([149.5.228.1]) by smtp.gmail.com with ESMTPSA id l4sm17616456wrw.6.2019.10.08.04.32.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 08 Oct 2019 04:32:18 -0700 (PDT) From: Robert Pluim To: Drew Adams Subject: Re: bug#31207: 26; Doc strings of commands and other functions of `replace.el' References: <5cbda7e0-323f-450f-9e64-b73fc3b39e44@default> X-Debbugs-No-Ack: yes Mail-Copies-To: never Gmane-Reply-To-List: yes Date: Tue, 08 Oct 2019 13:32:17 +0200 In-Reply-To: (Drew Adams's message of "Mon, 7 Oct 2019 10:29:15 -0700 (PDT)") Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 31207 Cc: 31207@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: -1.0 (-) >>>>> On Mon, 7 Oct 2019 10:29:15 -0700 (PDT), Drew Adams said: Drew> for `query-replace(-regexp)' there is no >> description of argument REGION-NONCONTIGUOUS-P. >>=20 >> query-replace: >>=20 >> Arguments FROM-STRING, TO-STRING, DELIMITED, START, END, BACKWARD, a= nd >> REGION-NONCONTIGUOUS-P are passed to `perform-replace' (which see). Drew> I have only Emacs 26.3 - the latest release, and the Drew> release I reported on. That text is not in the doc string. OK >> perform-replace: >>=20 >> Non-nil REGION-NONCONTIGUOUS-P means that the region is composed of >> noncontiguous pieces. The most common example of this is a >> rectangular region, where the pieces are separated by newline >> characters." Drew> That too is missing from Emacs 26.3. OK Drew> If you feel that this bug is completely fixed in Drew> Emacs 27, please close it as "fixed". Thx. I can=CA=BCt answer that, because I don=CA=BCt know which of the defuns in replace.el you feel are underdocumented. Please don=CA=BCt say 'all of them'. Rober From debbugs-submit-bounces@debbugs.gnu.org Tue Oct 08 10:37:30 2019 Received: (at 31207) by debbugs.gnu.org; 8 Oct 2019 14:37:30 +0000 Received: from localhost ([127.0.0.1]:51191 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHqcE-0001tj-FY for submit@debbugs.gnu.org; Tue, 08 Oct 2019 10:37:30 -0400 Received: from aserp2120.oracle.com ([141.146.126.78]:36298) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHqcC-0001tX-QR for 31207@debbugs.gnu.org; Tue, 08 Oct 2019 10:37:29 -0400 Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x98ESnQu041770; Tue, 8 Oct 2019 14:37:22 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-2019-08-05; bh=sicq8pnOP5eGrwpVYgwlOwGPwe9+knhVqJoNMitD804=; b=V0ngpzE2iwauyNmE76VbAn9OpIx6WVRsnk3s6aGyb9Mf4zIwn4QyUGPlWq7T5ejUivwf g8AwtdbY6jlYFqdIIaOqKK39AGTXGpij1LywO8GBOCc7rAwO91R6yworxCHI6oswxS8F Lnp54W73PBerqXTwy7+Czg1Ap5JlVmdK+VGm7J0SK8oYiOwLqF62ar8HHqpMpg2rYrmF Jthf4/UhsSPjcp5PLnQQTxVhbE/JwoY8Ys8ODOCdO5VDxgcFI4tqOCbA3z1nmOS0vBCU pJVRLfHb7W/TmQVF5tOgm7hEeDTuPC0oUCMJvR7NyiyblJzYNowphZEPg5P+KIL0Gumr TQ== Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by aserp2120.oracle.com with ESMTP id 2vek4qdp47-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 08 Oct 2019 14:37:22 +0000 Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x98ERwn9011652; Tue, 8 Oct 2019 14:37:21 GMT Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userp3020.oracle.com with ESMTP id 2vg206egda-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 08 Oct 2019 14:37:21 +0000 Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id x98EbJUY023013; Tue, 8 Oct 2019 14:37:19 GMT MIME-Version: 1.0 Message-ID: <81b71baa-dd6c-46a5-900a-47d84492c560@default> Date: Tue, 8 Oct 2019 07:37:18 -0700 (PDT) From: Drew Adams To: Robert Pluim Subject: RE: bug#31207: 26; Doc strings of commands and other functions of `replace.el' References: <5cbda7e0-323f-450f-9e64-b73fc3b39e44@default> In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4900.0 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9403 signatures=668684 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=653 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1910080133 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9403 signatures=668684 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=755 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1910080133 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 31207 Cc: 31207@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: -3.3 (---) > Drew> If you feel that this bug is completely fixed in > Drew> Emacs 27, please close it as "fixed". Thx. >=20 > I can=CA=BCt answer that, because I don=CA=BCt know which of the defuns i= n > replace.el you feel are underdocumented. Please don=CA=BCt say 'all of > them'. Any doc string that does not describe all of the function arguments, either directly or indirectly (by referencing another doc string). This is nothing new. Function doc strings should describe the arguments. That's all. From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 09 06:15:10 2019 Received: (at 31207-done) by debbugs.gnu.org; 9 Oct 2019 10:15:10 +0000 Received: from localhost ([127.0.0.1]:52165 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iI8zt-0004xE-R4 for submit@debbugs.gnu.org; Wed, 09 Oct 2019 06:15:10 -0400 Received: from eggs.gnu.org ([209.51.188.92]:46484) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iI8zr-0004x0-TJ for 31207-done@debbugs.gnu.org; Wed, 09 Oct 2019 06:15:08 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:38232) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1iI8zm-0006CR-Kr; Wed, 09 Oct 2019 06:15:02 -0400 Received: from [176.228.60.248] (port=4519 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1iI8zk-0005F6-J4; Wed, 09 Oct 2019 06:15:01 -0400 Date: Wed, 09 Oct 2019 13:14:41 +0300 Message-Id: <831rvmw7hq.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: <81b71baa-dd6c-46a5-900a-47d84492c560@default> (message from Drew Adams on Tue, 8 Oct 2019 07:37:18 -0700 (PDT)) Subject: Re: bug#31207: 26; Doc strings of commands and other functions of `replace.el' References: <5cbda7e0-323f-450f-9e64-b73fc3b39e44@default> <81b71baa-dd6c-46a5-900a-47d84492c560@default> 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-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 31207-done Cc: rpluim@gmail.com, 31207-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: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Tue, 8 Oct 2019 07:37:18 -0700 (PDT) > From: Drew Adams > Cc: 31207@debbugs.gnu.org > > > Drew> If you feel that this bug is completely fixed in > > Drew> Emacs 27, please close it as "fixed". Thx. > > > > I canʼt answer that, because I donʼt know which of the defuns in > > replace.el you feel are underdocumented. Please donʼt say 'all of > > them'. > > Any doc string that does not describe all of > the function arguments, either directly or > indirectly (by referencing another doc string). > > This is nothing new. Function doc strings > should describe the arguments. That's all. What an unhelpful response. Do you realize how such responses shoot yourself (and us) in the foot by preventing well-meaning contributors from fixing your bug reports? I fixed the doc strings in all functions except perform-replace. The latter is clearly an internal function, and its doc string says so. From unknown Mon Jun 23 02:23:22 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Wed, 06 Nov 2019 12: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