From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#1351: 23.0.60; Provide doc strings for functions in replace.el Date: Sat, 15 Nov 2008 16:06:21 -0800 Message-ID: <005d01c9477f$28716ab0$0200a8c0@us.oracle.com> References: <005a01c94757$29f2e1c0$0200a8c0@us.oracle.com> <18719.21523.444893.763878@fencepost.gnu.org> Reply-To: Drew Adams , 1351@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1226795436 22829 80.91.229.12 (16 Nov 2008 00:30:36 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 16 Nov 2008 00:30:36 +0000 (UTC) To: "'Glenn Morris'" , <1351@emacsbugs.donarmstrong.com> Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Nov 16 01:31:39 2008 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1L1VYA-0001q5-Mg for geb-bug-gnu-emacs@m.gmane.org; Sun, 16 Nov 2008 01:31:39 +0100 Original-Received: from localhost ([127.0.0.1]:37337 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L1VX2-0000hc-DQ for geb-bug-gnu-emacs@m.gmane.org; Sat, 15 Nov 2008 19:30:28 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1L1VWp-0000eG-22 for bug-gnu-emacs@gnu.org; Sat, 15 Nov 2008 19:30:15 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1L1VWn-0000dU-GQ for bug-gnu-emacs@gnu.org; Sat, 15 Nov 2008 19:30:14 -0500 Original-Received: from [199.232.76.173] (port=49492 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L1VWn-0000dI-5t for bug-gnu-emacs@gnu.org; Sat, 15 Nov 2008 19:30:13 -0500 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:42264) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1L1VWm-0005fM-Lw for bug-gnu-emacs@gnu.org; Sat, 15 Nov 2008 19:30:12 -0500 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mAG0U8eT007885; Sat, 15 Nov 2008 16:30:08 -0800 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id mAG0F2sg003859; Sat, 15 Nov 2008 16:15:02 -0800 X-Loop: don@donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Sun, 16 Nov 2008 00:15:02 +0000 Resent-Message-ID: Resent-Sender: don@donarmstrong.com X-Emacs-PR-Message: report 1351 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by 1351-submit@emacsbugs.donarmstrong.com id=B1351.12267939792581 (code B ref 1351); Sun, 16 Nov 2008 00:15:02 +0000 Original-Received: (at 1351) by emacsbugs.donarmstrong.com; 16 Nov 2008 00:06:19 +0000 Original-Received: from acsinet12.oracle.com (acsinet12.oracle.com [141.146.126.234]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mAG06G58002575 for <1351@emacsbugs.donarmstrong.com>; Sat, 15 Nov 2008 16:06:17 -0800 Original-Received: from acsinet13.oracle.com (acsinet13.oracle.com [141.146.126.235]) by acsinet12.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id mAG05x4K025378 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 16 Nov 2008 00:06:00 GMT Original-Received: from acsmt702.oracle.com (acsmt702.oracle.com [141.146.40.80]) by acsinet13.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id mAG06KIc018921; Sun, 16 Nov 2008 00:06:22 GMT Original-Received: from dradamslap1 (/24.23.165.218) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 15 Nov 2008 16:06:06 -0800 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <18719.21523.444893.763878@fencepost.gnu.org> Thread-Index: AclHd29BKQ5xLNLZS36c3Xuj9fZeKAABcjuw X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 X-Source-IP: acsmt702.oracle.com [141.146.40.80] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A09020A.491F63F0.00FC:SCFSTAT928724,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Sat, 15 Nov 2008 19:30:14 -0500 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:22400 Archived-At: > From: Glenn Morris Sent: Saturday, November 15, 2008 2:58 PM > Yes, many functions in Emacs unfortunately lack doc strings. It is not > very difficult to find them. Let me save you the trouble of opening > bugs for them all: > (let (undocumented) > (mapatoms (lambda (s) > (and (fboundp s) > (not (documentation s)) > (push s undocumented)))) > undocumented)) Impertinent and not helpful. I'm not looking for them all. This is not a report that all functions and variables need doc strings. The functions and variables I reported, in particular, could use doc strings. That would help at least one user, me, understand the code. > Would you like to write some? No. When I understand code that lacks doc strings where doc strings would help, I don't hesitate to send proposed doc along. Likewise, for doc-string corrections. When I don't understand code that lacks doc strings, I report that they could help understanding. Would you like to write some? If not, pass. Let me save you the trouble of responding uselessly to bug reports - feel free not to bother.