From unknown Thu Aug 14 17:18:31 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#957 <957@debbugs.gnu.org> To: bug#957 <957@debbugs.gnu.org> Subject: Status: 23.0.60; No doc string for Dired functions Reply-To: bug#957 <957@debbugs.gnu.org> Date: Fri, 15 Aug 2025 00:18:31 +0000 retitle 957 23.0.60; No doc string for Dired functions reassign 957 emacs submitter 957 "Drew Adams" severity 957 minor thanks From drew.adams@oracle.com Wed Sep 10 09:16:26 2008 X-Spam-Checker-Version: SpamAssassin 3.2.3-bugs.debian.org_2005_01_02 (2007-08-08) on rzlab.ucr.edu X-Spam-Level: X-Spam-Status: No, score=-6.6 required=4.0 tests=AWL,BAYES_00, RCVD_IN_DNSWL_MED,UNPARSEABLE_RELAY autolearn=ham version=3.2.3-bugs.debian.org_2005_01_02 Received: (at submit) by emacsbugs.donarmstrong.com; 10 Sep 2008 16:16:26 +0000 Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m8AGGNH9009066 for ; Wed, 10 Sep 2008 09:16:24 -0700 Received: from mail.gnu.org ([199.232.76.166]:57795 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1KdSKx-0008It-VG for emacs-pretest-bug@gnu.org; Wed, 10 Sep 2008 12:14:36 -0400 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1KdSMc-0004MX-JW for emacs-pretest-bug@gnu.org; Wed, 10 Sep 2008 12:16:22 -0400 Received: from rgminet01.oracle.com ([148.87.113.118]:18140) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1KdSMc-0004Lv-7x for emacs-pretest-bug@gnu.org; Wed, 10 Sep 2008 12:16:18 -0400 Received: from rgmgw2.us.oracle.com (rgmgw2.us.oracle.com [138.1.186.111]) by rgminet01.oracle.com (Switch-3.2.4/Switch-3.1.6) with ESMTP id m8AGGDS5022515 for ; Wed, 10 Sep 2008 10:16:13 -0600 Received: from acsmt707.oracle.com (acsmt707.oracle.com [141.146.40.85]) by rgmgw2.us.oracle.com (Switch-3.2.4/Switch-3.2.4) with ESMTP id m8AGGCIS008123 for ; Wed, 10 Sep 2008 10:16:12 -0600 Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 10 Sep 2008 09:16:11 -0700 From: "Drew Adams" To: Subject: 23.0.60; No doc string for Dired functions Date: Wed, 10 Sep 2008 09:16:11 -0700 Message-ID: <001d01c91360$8a9cf4a0$c2b22382@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AckTYInvMW8+beZLRE6SE+0uoHXmWQ== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 X-Brightmail-Tracker: AAAAAQAAAAI= X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE X-Whitelist: TRUE X-detected-kernel: by monty-python.gnu.org: Linux 2.4-2.6 There is still no doc string for many useful Dired functions, from things like `dired-repeat-overlines' to all of the tree Dired non-interactive functions. At a minimum, the arguments should be described in a doc string. Even some commands, like `dired-kill-line', still have no doc. In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600) of 2008-08-29 on LENNART-69DE564 Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/g/include -fno-crossjumping' From Roland.Winkler@physik.uni-erlangen.de Thu Sep 11 13:55:51 2008 X-Spam-Checker-Version: SpamAssassin 3.2.3-bugs.debian.org_2005_01_02 (2007-08-08) on rzlab.ucr.edu X-Spam-Level: X-Spam-Status: No, score=-6.8 required=4.0 tests=AWL,BAYES_00,HAS_BUG_NUMBER autolearn=ham version=3.2.3-bugs.debian.org_2005_01_02 Received: (at 957) by emacsbugs.donarmstrong.com; 11 Sep 2008 20:55:51 +0000 Received: from tfkpsv.physik.uni-erlangen.de (tfkpsv.physik.uni-erlangen.de [131.188.164.197]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m8BKtlA0013518 for <957@emacsbugs.donarmstrong.com>; Thu, 11 Sep 2008 13:55:49 -0700 Received: from tfkp07.physik.uni-erlangen.de (tfkp07.physik.uni-erlangen.de [131.188.164.207]) by tfkpsv.physik.uni-erlangen.de (Postfix) with ESMTP id 871EA21139; Thu, 11 Sep 2008 22:55:42 +0200 (CEST) To: Drew Adams Cc: 957@debbugs.gnu.org Subject: Re: bug#957: 23.0.60; No doc string for Dired functions References: From: Roland Winkler Date: Thu, 11 Sep 2008 22:55:41 +0200 In-Reply-To: (Drew Adams's message of "Wed\, 10 Sep 2008 09\:16\:11 -0700") Message-ID: User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii "Drew Adams" writes: > There is still no doc string for many useful Dired functions, from > things like `dired-repeat-overlines' to all of the tree Dired > non-interactive functions. At a minimum, the arguments should be > described in a doc string. Even some commands, like `dired-kill-line', > still have no doc. I had promised to look into that. I am sorry for the delay. Roland From lekktu@gmail.com Sat Jan 24 05:21:16 2009 Received: (at control) by emacsbugs.donarmstrong.com; 24 Jan 2009 13:21:16 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: *** X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=3.8 required=4.0 tests=MISSING_SUBJECT,NOSUBJECT, PHONENUMBER,VALID_BTS_CONTROL autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from mail-ew0-f10.google.com (mail-ew0-f10.google.com [209.85.219.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n0ODLCeZ023904 for ; Sat, 24 Jan 2009 05:21:14 -0800 Received: by ewy3 with SMTP id 3so5801145ewy.1 for ; Sat, 24 Jan 2009 05:21:07 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:date:message-id:subject :from:to:content-type:content-transfer-encoding; bh=xXa9eJVBndAYpPlZV8dLwqFosNsK4rqZOXRdWeYuJ4Q=; b=FSm4a7/ADlwvXftqIX5VnzAVcCu/qib11/WaJF0LyO3OJgKUp/NoIlvVk00YYAmQF5 dKWaUoM9GnZq+bL0SJD4rmcaiXm/3DZz1Gk86c0l73B/wLm05ZnrpbLuhWt/UvChd+Da t4TYf4l4StJDbisL5VT8nHaax0U9aF0FVlars= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:date:message-id:subject:from:to:content-type :content-transfer-encoding; b=ZTn4XF1egvmTGHFRvkqbsxdU3rXu4MiBWbTgcNKLgroBbFd0Tx/g2yd1YFAh6K4Q9l IVNvAMcs7GZuIg4hfmUU9io9zK5caCM70VAcodynraeu2Bo5NapviQJKWm7IJfMzcKX/ J1Zf8PnYatGaoHWFE1/9qKg1u3yUg8bpcdwOs= MIME-Version: 1.0 Received: by 10.210.41.14 with SMTP id o14mr1847258ebo.22.1232803267097; Sat, 24 Jan 2009 05:21:07 -0800 (PST) Date: Sat, 24 Jan 2009 14:21:07 +0100 Message-ID: Subject: From: Juanma Barranquero To: control@debbugs.gnu.org Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit reassign 1207 emacs,w32 reassign 140 emacs,python reassign 359 emacs,python reassign 1985 emacs,python reassign 1987 emacs,python reassign 881 emacs,python reassign 949 emacs,documentation reassign 957 emacs,documentation reassign 965 emacs,documentation reassign 1010 emacs,documentation reassign 1084 emacs,documentation reassign 1193 emacs,documentation reassign 1581 emacs,documentation reassign 1807 emacs,documentation reassign 1989 emacs,documentation reassign 1184 emacs,documentation reassign 1381 emacs,documentation reassign 74 emacs,documentation reassign 1351 emacs,documentation reassign 1478 emacs,documentation reassign 1526 emacs,documentation reassign 1947 emacs,documentation reassign 352 emacs,documentation reassign 575 emacs,documentation quit From rgm@gnu.org Wed Jan 28 17:08:10 2009 Received: (at control) by emacsbugs.donarmstrong.com; 29 Jan 2009 01:08:10 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-2.0 required=4.0 tests=VALID_BTS_CONTROL autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n0T187NV011081 for ; Wed, 28 Jan 2009 17:08:08 -0800 Received: from rgm by fencepost.gnu.org with local (Exim 4.67) (envelope-from ) id 1LSLMQ-0007kj-O7; Wed, 28 Jan 2009 20:06:26 -0500 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <18817.274.653222.676340@fencepost.gnu.org> Date: Wed, 28 Jan 2009 20:06:26 -0500 From: Glenn Morris To: control Subject: control message severity 1084 minor severity 1010 minor severity 1001 minor severity 957 minor severity 2042 wishlist reassign 2093 emacs,vc-dir reassign 2098 spam reassign 2100 spam From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 06 14:36:22 2011 Received: (at 957) by debbugs.gnu.org; 6 Jul 2011 18:36:23 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QeWxS-000189-0g for submit@debbugs.gnu.org; Wed, 06 Jul 2011 14:36:22 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QeWxP-00017q-RQ for 957@debbugs.gnu.org; Wed, 06 Jul 2011 14:36:20 -0400 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1QeWxD-0000Bp-Ot; Wed, 06 Jul 2011 20:36:07 +0200 From: Lars Magne Ingebrigtsen To: "Drew Adams" Subject: Re: 23.0.60; No doc string for Dired functions In-Reply-To: <001d01c91360$8a9cf4a0$c2b22382@us.oracle.com> (Drew Adams's message of "Wed, 10 Sep 2008 09:16:11 -0700") Date: Wed, 06 Jul 2011 20:27:45 +0200 Message-ID: References: <001d01c91360$8a9cf4a0$c2b22382@us.oracle.com> User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) X-Now-Playing: Demdike Stare's _Tryptych (2): Liberation Through Hearing_: "The Stars Are Moving" X-Hashcash: 1:23:110706:drew.adams@oracle.com::4MARqWaa707BbbLJ:0000000000000000000000000000000000000000Qlie X-Hashcash: 1:23:110706:957@debbugs.gnu.org::fD0KcS0HVmQHRIhI:000000000000000000000000000000000000000000eV82 MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1QeWxD-0000Bp-Ot X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1310582168.13138@MkwHTKvASYNNSxyj0AEjcA X-Spam-Status: No X-Spam-Score: -2.8 (--) X-Debbugs-Envelope-To: 957 Cc: 957@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.8 (--) "Drew Adams" writes: > There is still no doc string for many useful Dired functions, from > things like `dired-repeat-overlines' to all of the tree Dired > non-interactive functions. At a minimum, the arguments should be > described in a doc string. Even some commands, like `dired-kill-line', > still have no doc. I've added a doc to `dired-kill-line', but I don't know what `dired-repeat-overlines' is... And the noninteractive functions don't need doc strings, really, do they? -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 06 15:16:56 2011 Received: (at 957) by debbugs.gnu.org; 6 Jul 2011 19:16:56 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QeXai-00037D-5W for submit@debbugs.gnu.org; Wed, 06 Jul 2011 15:16:56 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QeXag-00036x-9G for 957@debbugs.gnu.org; Wed, 06 Jul 2011 15:16:55 -0400 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by rcsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p66JGkll025814 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 6 Jul 2011 19:16:47 GMT Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p66JGj8K006604 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 6 Jul 2011 19:16:45 GMT Received: from abhmt112.oracle.com (abhmt112.oracle.com [141.146.116.64]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p66JGdK3031326; Wed, 6 Jul 2011 14:16:39 -0500 Received: from dradamslap1 (/10.159.55.239) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 06 Jul 2011 12:16:39 -0700 From: "Drew Adams" To: "'Lars Magne Ingebrigtsen'" References: <001d01c91360$8a9cf4a0$c2b22382@us.oracle.com> Subject: RE: 23.0.60; No doc string for Dired functions Date: Wed, 6 Jul 2011 12:16:37 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 Thread-Index: Acw8C5sEmlowcnpCQPSreenChfxzIwABD59w X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090201.4E14B4A0.0059:SCFMA922111,ss=1,re=-4.000,fgs=0 X-Spam-Score: -4.4 (----) X-Debbugs-Envelope-To: 957 Cc: 957@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.4 (----) > > There is still no doc string for many useful Dired functions, from > > things like `dired-repeat-overlines' to all of the tree Dired > > non-interactive functions. At a minimum, the arguments should be > > described in a doc string. Even some commands, like > > `dired-kill-line', still have no doc. > > I've added a doc to `dired-kill-line' Thank you. > but I don't know what `dired-repeat-overlines' is... All the more reason for it to get a doc string! You don't know what it is, but _it_ should know what it is and be able to tell us. Someone (TM) will need to figure that out and give it a little help in the self-explanation department. > And the noninteractive functions don't need doc strings, > really, do they? Sure they do, in general. Since when do we document only commands? In the Dark Ages, doc strings were relatively more expensive (disk, memory, etc.), and some minor functions were handled with only a comment. Nowadays there is rarely a good reason not to provide a doc string. Emacs is the self-documenting editor. If you must access the source code just to get a description of a function from comments, or worse, to parse uncommented code to figure out what a function does, then Emacs is not doing its self-documenting job well. From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 07 12:30:52 2011 Received: (at control) by debbugs.gnu.org; 7 Jul 2011 16:30:53 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QerTY-0003Oe-IZ for submit@debbugs.gnu.org; Thu, 07 Jul 2011 12:30:52 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QerTW-0003MZ-IL for control@debbugs.gnu.org; Thu, 07 Jul 2011 12:30:50 -0400 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1QerTL-0005aN-PN for control@debbugs.gnu.org; Thu, 07 Jul 2011 18:30:39 +0200 Date: Thu, 07 Jul 2011 18:30:39 +0200 Message-Id: To: control@debbugs.gnu.org From: Lars Magne Ingebrigtsen Subject: control message for bug #957 X-MailScanner-ID: 1QerTL-0005aN-PN X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1310661039.8873@WZmaNDaEK9UHgjazDGppKw X-Spam-Status: No X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) close 957 24.1 From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 07 12:31:13 2011 Received: (at 957) by debbugs.gnu.org; 7 Jul 2011 16:31:13 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QerTs-0003Pk-Q1 for submit@debbugs.gnu.org; Thu, 07 Jul 2011 12:31:13 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QerTq-0003PY-Uv for 957@debbugs.gnu.org; Thu, 07 Jul 2011 12:31:11 -0400 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1QerTd-0005ad-Ou; Thu, 07 Jul 2011 18:30:57 +0200 From: Lars Magne Ingebrigtsen To: "Drew Adams" Subject: Re: 23.0.60; No doc string for Dired functions In-Reply-To: (Drew Adams's message of "Wed, 6 Jul 2011 12:16:37 -0700") Date: Thu, 07 Jul 2011 18:30:18 +0200 Message-ID: References: <001d01c91360$8a9cf4a0$c2b22382@us.oracle.com> User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAElBMVEVGGAVbJgw1CgCRYTwj AAAqAwB/NdFoAAACZElEQVQ4jV2SzZLbIBCEGxTfQWTvgK278Oze7Q26a4l4/1dJD3bWqVAluzQf PT0/ggte5swDKf5xnEE2WAne/geOwBN8tJwjxJkXAGAIKLDRu5fCAtGLFHk8/5z1CbwnCM9gGKB/ lWLVPIv/e5jKo0cHBcm+AEQ82oykfUzrNzBGVg9XjFdgZgnPojCxPnh6rQ8PebYIP2m9Bs4PMLkQ ZCi8aIdzzMbmyN79zKqHRtaE85UhBeUsju37QEYlJoLGepMQxMzgFUgiOK8fvdMhsgg35+QpQygF fB3grEUVGjm+hOLYpOm9NyqUIHnP4k1JBMENYkQHoTUx4WmCpnjLBEmBNVwcwewQnMi7GWA0yr2V wElBN/ThB2DypSXdjFh6rEHepGhZxSPnL03hsFNxDxPrGUCnQbDaaAk+xzpLCkFnweueX4KBXG8P YAw3wy9lYpwfE07HndN2HCs/Jbbtkta2e9zq74UWccwIfKKZ89I9ljTdOL+0Ym70bLbFxHmDijgV KdOKpWXY3fbclk7ldr8yk5GrVcDVdDtGh867CpxddJNMNUAHu/gZ/STIYy1tobMeBZeabgn5UNLz CLcLNi9H7TcHvdjoM0A/UEGwsQWNt9wemRaCFupWN9hleKgN4VGxddTKn7xUJZEKroWptp4riV5i rvgsrld83n7U7VK3g5S1qkWjN1Pd6D0zSp26Msi/WnFoxKuBAo6pbyogYPyyE2iuoejH1lnmr4si phspnvPoR8T5VL9PH+3phW5wr/UT/glyf1jttml3xp0eBmNOKtgR8b4v7G0bArp2jufYdpf+AOGC v1EP/btvAAAAAElFTkSuQmCC X-Now-Playing: The Smiths's _The World Won't Listen_: "Bigmouth strikes again" X-Hashcash: 1:23:110707:drew.adams@oracle.com::brik5XqL2esBNXIj:00000000000000000000000000000000000000003yrr X-Hashcash: 1:23:110707:957@debbugs.gnu.org::5/BznCUqxtgWSSSG:000000000000000000000000000000000000000000wKfE MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1QerTd-0005ad-Ou X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1310661057.93674@d9suPfeH9VHIwy4cPGlYwg X-Spam-Status: No X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: 957 Cc: 957@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) "Drew Adams" writes: >> but I don't know what `dired-repeat-overlines' is... > > All the more reason for it to get a doc string! I meant that I couldn't find it. :-) But grepping for `dired-repeat-over-lines' found it for me. It, too, is an internal function, and I don't think it's worth documenting all these. They are only useful if you're doing dired development, and then you presumably have the sources and can look at the comments. > Sure they do, in general. Since when do we document only commands? > > In the Dark Ages, doc strings were relatively more expensive (disk, memory, > etc.), and some minor functions were handled with only a comment. Nowadays > there is rarely a good reason not to provide a doc string. I agree, but adding doc strings to purely internal functions that are presumably self-explanatory to people who need to use them to develop isn't all that useful. It's not that I'm against adding doc strings (if somebody feels like doing that), but it's not, in my opinion worth the time. So I'm closing this report. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 07 12:43:21 2011 Received: (at 957) by debbugs.gnu.org; 7 Jul 2011 16:43:21 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qerfc-0003lZ-Fk for submit@debbugs.gnu.org; Thu, 07 Jul 2011 12:43:20 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qerfb-0003lL-3P for 957@debbugs.gnu.org; Thu, 07 Jul 2011 12:43:19 -0400 Received: from rtcsinet22.oracle.com (rtcsinet22.oracle.com [66.248.204.30]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p67GhAeD000557 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 7 Jul 2011 16:43:12 GMT Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by rtcsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p67Gh9Cu024349 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Thu, 7 Jul 2011 16:43:10 GMT Received: from abhmt108.oracle.com (abhmt108.oracle.com [141.146.116.60]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p67Gh4ko022585; Thu, 7 Jul 2011 11:43:04 -0500 Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Thu, 07 Jul 2011 09:43:03 -0700 From: "Drew Adams" To: "'Lars Magne Ingebrigtsen'" References: <001d01c91360$8a9cf4a0$c2b22382@us.oracle.com> Subject: RE: 23.0.60; No doc string for Dired functions Date: Thu, 7 Jul 2011 09:43:04 -0700 Message-ID: <78089EA4628C4A17A9944B0109FE76BE@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: Acw8w0m4THfYkPiFTL+mpcbvmqcU4wAAWNoA X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: rtcsinet22.oracle.com [66.248.204.30] X-CT-RefId: str=0001.0A090209.4E15E220.0093:SCFSTAT5015188, ss=1, re=-4.000, fgs=0 X-Spam-Score: -4.4 (----) X-Debbugs-Envelope-To: 957 Cc: 957@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.4 (----) > It's not that I'm against adding doc strings (if somebody feels like > doing that), but it's not, in my opinion worth the time. So > I'm closing this report. Leave it open, if you're not against someone adding the doc strings. Just because you don't have the time or aren't interested in adding the doc strings does not mean that the bug should be closed. From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 07 12:49:14 2011 Received: (at 957) by debbugs.gnu.org; 7 Jul 2011 16:49:15 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QerlK-0004jo-1E for submit@debbugs.gnu.org; Thu, 07 Jul 2011 12:49:14 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QerlH-0004ja-KM for 957@debbugs.gnu.org; Thu, 07 Jul 2011 12:49:12 -0400 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1Qerl6-0005uw-F5; Thu, 07 Jul 2011 18:49:00 +0200 From: Lars Magne Ingebrigtsen To: "Drew Adams" Subject: Re: 23.0.60; No doc string for Dired functions In-Reply-To: <78089EA4628C4A17A9944B0109FE76BE@us.oracle.com> (Drew Adams's message of "Thu, 7 Jul 2011 09:43:04 -0700") Date: Thu, 07 Jul 2011 18:48:57 +0200 Message-ID: References: <001d01c91360$8a9cf4a0$c2b22382@us.oracle.com> <78089EA4628C4A17A9944B0109FE76BE@us.oracle.com> User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAElBMVEVGGAVbJgw1CgCRYTwj AAAqAwB/NdFoAAACZElEQVQ4jV2SzZLbIBCEGxTfQWTvgK278Oze7Q26a4l4/1dJD3bWqVAluzQf PT0/ggte5swDKf5xnEE2WAne/geOwBN8tJwjxJkXAGAIKLDRu5fCAtGLFHk8/5z1CbwnCM9gGKB/ lWLVPIv/e5jKo0cHBcm+AEQ82oykfUzrNzBGVg9XjFdgZgnPojCxPnh6rQ8PebYIP2m9Bs4PMLkQ ZCi8aIdzzMbmyN79zKqHRtaE85UhBeUsju37QEYlJoLGepMQxMzgFUgiOK8fvdMhsgg35+QpQygF fB3grEUVGjm+hOLYpOm9NyqUIHnP4k1JBMENYkQHoTUx4WmCpnjLBEmBNVwcwewQnMi7GWA0yr2V wElBN/ThB2DypSXdjFh6rEHepGhZxSPnL03hsFNxDxPrGUCnQbDaaAk+xzpLCkFnweueX4KBXG8P YAw3wy9lYpwfE07HndN2HCs/Jbbtkta2e9zq74UWccwIfKKZ89I9ljTdOL+0Ym70bLbFxHmDijgV KdOKpWXY3fbclk7ldr8yk5GrVcDVdDtGh867CpxddJNMNUAHu/gZ/STIYy1tobMeBZeabgn5UNLz CLcLNi9H7TcHvdjoM0A/UEGwsQWNt9wemRaCFupWN9hleKgN4VGxddTKn7xUJZEKroWptp4riV5i rvgsrld83n7U7VK3g5S1qkWjN1Pd6D0zSp26Msi/WnFoxKuBAo6pbyogYPyyE2iuoejH1lnmr4si phspnvPoR8T5VL9PH+3phW5wr/UT/glyf1jttml3xp0eBmNOKtgR8b4v7G0bArp2jufYdpf+AOGC v1EP/btvAAAAAElFTkSuQmCC X-Now-Playing: The Smiths's _The World Won't Listen_: "Half a person" X-Hashcash: 1:23:110707:drew.adams@oracle.com::agmWkzJxwAJDKGWx:00000000000000000000000000000000000000002TSK X-Hashcash: 1:23:110707:957@debbugs.gnu.org::AE/XWh02KeqXCSbk:0000000000000000000000000000000000000000009Skc MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1Qerl6-0005uw-F5 X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1310662140.54033@359BdaKFbLCz1F8DAz0b0A X-Spam-Status: No X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: 957 Cc: 957@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) "Drew Adams" writes: > Just because you don't have the time or aren't interested in adding the doc > strings does not mean that the bug should be closed. It is my opinion that doc strings will not be added to the internal functions of dired.el through being unclosed in this bug tracker. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From unknown Thu Aug 14 17:18:31 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Fri, 05 Aug 2011 11:24:05 +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