From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#31207: 26; Doc strings of commands and other functions of `replace.el' Date: Tue, 8 Oct 2019 07:37:18 -0700 (PDT) Message-ID: <81b71baa-dd6c-46a5-900a-47d84492c560@default> References: <5cbda7e0-323f-450f-9e64-b73fc3b39e44@default> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="46683"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 31207@debbugs.gnu.org To: Robert Pluim Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Oct 08 16:42:56 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iHqhT-000C1D-Nv for geb-bug-gnu-emacs@m.gmane.org; Tue, 08 Oct 2019 16:42:55 +0200 Original-Received: from localhost ([::1]:56832 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iHqhS-0007Io-D1 for geb-bug-gnu-emacs@m.gmane.org; Tue, 08 Oct 2019 10:42:54 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51472) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iHqck-0001VO-Pw for bug-gnu-emacs@gnu.org; Tue, 08 Oct 2019 10:38:03 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iHqcj-00065W-RJ for bug-gnu-emacs@gnu.org; Tue, 08 Oct 2019 10:38:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:42370) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iHqcj-00065Q-Nm for bug-gnu-emacs@gnu.org; Tue, 08 Oct 2019 10:38:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iHqcj-0001uZ-Jk for bug-gnu-emacs@gnu.org; Tue, 08 Oct 2019 10:38:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 08 Oct 2019 14:38:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 31207 X-GNU-PR-Package: emacs Original-Received: via spool by 31207-submit@debbugs.gnu.org id=B31207.15705454507305 (code B ref 31207); Tue, 08 Oct 2019 14:38:01 +0000 Original-Received: (at 31207) by debbugs.gnu.org; 8 Oct 2019 14:37:30 +0000 Original-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 Original-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 Original-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== Original-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 Original-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 Original-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 Original-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 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)] 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-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: 209.51.188.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:168653 Archived-At: > 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.