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#11571: 24.0.97; doc string of `dired-get-subdir-min' Date: Sun, 27 May 2012 14:41:52 -0700 Message-ID: <484EACDE2A4A4185B158B84473AB1710@us.oracle.com> References: <144EDF3C01664A2180447B02D1A6EB09@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1338154981 27803 80.91.229.3 (27 May 2012 21:43:01 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 27 May 2012 21:43:01 +0000 (UTC) To: <11571@debbugs.gnu.org> Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun May 27 23:43:00 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1SYlEk-0004vb-GR for geb-bug-gnu-emacs@m.gmane.org; Sun, 27 May 2012 23:42:54 +0200 Original-Received: from localhost ([::1]:55438 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SYlEk-0004sv-76 for geb-bug-gnu-emacs@m.gmane.org; Sun, 27 May 2012 17:42:54 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:51788) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SYlEg-0004sK-Nm for bug-gnu-emacs@gnu.org; Sun, 27 May 2012 17:42:51 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SYlEe-0001eL-Vt for bug-gnu-emacs@gnu.org; Sun, 27 May 2012 17:42:50 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:36299) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SYlEe-0001eF-SK for bug-gnu-emacs@gnu.org; Sun, 27 May 2012 17:42:48 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SYlFq-0008O3-8E for bug-gnu-emacs@gnu.org; Sun, 27 May 2012 17:44:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 27 May 2012 21:44:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 11571 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 11571-submit@debbugs.gnu.org id=B11571.133815500632188 (code B ref 11571); Sun, 27 May 2012 21:44:02 +0000 Original-Received: (at 11571) by debbugs.gnu.org; 27 May 2012 21:43:26 +0000 Original-Received: from localhost ([127.0.0.1]:45845 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SYlFF-0008N7-NA for submit@debbugs.gnu.org; Sun, 27 May 2012 17:43:26 -0400 Original-Received: from rcsinet15.oracle.com ([148.87.113.117]:38222) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SYlFD-0008Mv-Rd for 11571@debbugs.gnu.org; Sun, 27 May 2012 17:43:24 -0400 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q4RLg3xq015885 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <11571@debbugs.gnu.org>; Sun, 27 May 2012 21:42:04 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q4RLg3TL010386 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for <11571@debbugs.gnu.org>; Sun, 27 May 2012 21:42:03 GMT Original-Received: from abhmt120.oracle.com (abhmt120.oracle.com [141.146.116.72]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q4RLg30s032303 for <11571@debbugs.gnu.org>; Sun, 27 May 2012 16:42:03 -0500 Original-Received: from dradamslap1 (/10.159.190.91) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 27 May 2012 14:42:02 -0700 X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 Thread-Index: Ac08UO46pSuTtze/TVWh9YP/o0w5uAAAEXxw In-Reply-To: <144EDF3C01664A2180447B02D1A6EB09@us.oracle.com> X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:60406 Archived-At: Actually, the real bug is that `dired-get-subdir-min' has no doc string, so the doc string of `cdr' is used in its stead. The whole point of defining and using a separate function for this, instead of just coding with `cdr', is to enable readers of the code - and a fortiori the doc - to think in terms of the data structure of directories and not just abstract cons cells. There should be doc at the proper level of abstraction here.