From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: David Kastrup Newsgroups: gmane.emacs.devel Subject: Re: docstrings in dired.el Date: Fri, 23 May 2008 08:41:09 +0200 Message-ID: <85lk21h69m.fsf@lola.goethe.zz> References: <18486.19302.606327.955538@tfkp07.physik.uni-erlangen.de> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1211524895 2682 80.91.229.12 (23 May 2008 06:41:35 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 23 May 2008 06:41:35 +0000 (UTC) Cc: emacs-devel@gnu.org To: "Roland Winkler" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri May 23 08:42:11 2008 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1JzQyd-00042e-OE for ged-emacs-devel@m.gmane.org; Fri, 23 May 2008 08:42:07 +0200 Original-Received: from localhost ([127.0.0.1]:59462 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JzQxt-0007kR-3u for ged-emacs-devel@m.gmane.org; Fri, 23 May 2008 02:41:21 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JzQxm-0007fX-2u for emacs-devel@gnu.org; Fri, 23 May 2008 02:41:14 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JzQxk-0007bj-CO for emacs-devel@gnu.org; Fri, 23 May 2008 02:41:13 -0400 Original-Received: from [199.232.76.173] (port=36492 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JzQxk-0007bJ-53 for emacs-devel@gnu.org; Fri, 23 May 2008 02:41:12 -0400 Original-Received: from mail-in-09.arcor-online.net ([151.189.21.49]:38815) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1JzQxj-0003NN-Ks for emacs-devel@gnu.org; Fri, 23 May 2008 02:41:11 -0400 Original-Received: from mail-in-06-z2.arcor-online.net (mail-in-06-z2.arcor-online.net [151.189.8.18]) by mail-in-09.arcor-online.net (Postfix) with ESMTP id 2B454302942; Fri, 23 May 2008 08:41:10 +0200 (CEST) Original-Received: from mail-in-10.arcor-online.net (mail-in-10.arcor-online.net [151.189.21.50]) by mail-in-06-z2.arcor-online.net (Postfix) with ESMTP id 021F4ABAAE; Fri, 23 May 2008 08:41:10 +0200 (CEST) Original-Received: from lola.goethe.zz (dslb-084-061-024-152.pools.arcor-ip.net [84.61.24.152]) by mail-in-10.arcor-online.net (Postfix) with ESMTP id D36FE26D364; Fri, 23 May 2008 08:41:09 +0200 (CEST) Original-Received: by lola.goethe.zz (Postfix, from userid 1002) id 74FA81C46131; Fri, 23 May 2008 08:41:09 +0200 (CEST) In-Reply-To: <18486.19302.606327.955538@tfkp07.physik.uni-erlangen.de> (Roland Winkler's message of "Fri, 23 May 2008 06:43:18 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (gnu/linux) X-Virus-Scanned: ClamAV 0.92.1/7220/Fri May 23 04:08:41 2008 on mail-in-10.arcor-online.net X-Virus-Status: Clean X-detected-kernel: by monty-python.gnu.org: Linux 2.4-2.6 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:97558 Archived-At: "Roland Winkler" writes: > I am trying to develop proced.el in analogy with dired.el. However, > I am always a bit annoyed by the fact that too many functions in > dired.el come with comments instead of docstrings. So I'll convert > these comments into docstrings (unless somebody is really unhappy > about that). dired has an ancient history, from a time when DOC strings were still occupying main memory. M-x checkdoc RET would probably help with the conversion. -- David Kastrup, Kriemhildstr. 15, 44793 Bochum