From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: don@donarmstrong.com (Emacs bug Tracking System) Newsgroups: gmane.emacs.bugs Subject: bug#714: marked as done (directory-files: Doc string is irritatingly vague wrt sorting.) Date: Fri, 15 Aug 2008 13:25:05 -0700 Message-ID: References: <877iai8211.fsf@cyd.mit.edu> <20080813191141.GA2825@muc.de> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="----------=_1218831905-32233-0" X-Trace: ger.gmane.org 1218832074 5100 80.91.229.12 (15 Aug 2008 20:27:54 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 15 Aug 2008 20:27:54 +0000 (UTC) To: Chong Yidong Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Aug 15 22:28:46 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 1KU5ue-0007fA-KO for geb-bug-gnu-emacs@m.gmane.org; Fri, 15 Aug 2008 22:28:45 +0200 Original-Received: from localhost ([127.0.0.1]:40895 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KU5th-0004oP-OQ for geb-bug-gnu-emacs@m.gmane.org; Fri, 15 Aug 2008 16:27:45 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1KU5tS-0004iq-9O for bug-gnu-emacs@gnu.org; Fri, 15 Aug 2008 16:27:30 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1KU5tQ-0004hy-TP for bug-gnu-emacs@gnu.org; Fri, 15 Aug 2008 16:27:29 -0400 Original-Received: from [199.232.76.173] (port=41880 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KU5tQ-0004hi-Gw for bug-gnu-emacs@gnu.org; Fri, 15 Aug 2008 16:27:28 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:52187) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1KU5tQ-0004vs-0a for bug-gnu-emacs@gnu.org; Fri, 15 Aug 2008 16:27:28 -0400 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 m7FKRPcV001026; Fri, 15 Aug 2008 13:27:26 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id m7FKP5LW032347; Fri, 15 Aug 2008 13:25:05 -0700 X-Mailer: MIME-tools 5.420 (Entity 5.420) X-Loop: don@donarmstrong.com X-Emacs-PR-Message: closed 714 X-Emacs-PR-Package: emacs X-detected-kernel: by monty-python.gnu.org: Linux 2.6 (newer, 3) 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:19484 Archived-At: This is a multi-part message in MIME format... ------------=_1218831905-32233-0 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 Your message dated Fri, 15 Aug 2008 16:19:06 -0400 with message-id <877iai8211.fsf@cyd.mit.edu> and subject line Re: directory-files: Doc string is irritatingly vague wrt= sorting. has caused the Emacs bug report #714, regarding directory-files: Doc string is irritatingly vague wrt sorting. to be marked as done. This means that you claim that the problem has been dealt with. If this is not the case it is now your responsibility to reopen the bug report if necessary, and/or fix the problem forthwith. (NB: If you are a system administrator and have no idea what this message is talking about, this may indicate a serious mail system misconfiguration somewhere. Please contact don@donarmstrong.com immediately.) --=20 714: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=3D714 Emacs Bug Tracking System Contact don@donarmstrong.com with problems ------------=_1218831905-32233-0 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit 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=-5.8 required=4.0 tests=AWL,BAYES_00,FOURLA, RCVD_IN_DNSWL_LOW autolearn=ham version=3.2.3-bugs.debian.org_2005_01_02 Received: (at submit) by emacsbugs.donarmstrong.com; 13 Aug 2008 19:09:50 +0000 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m7DJ9jMp018970 for ; Wed, 13 Aug 2008 12:09:47 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1KTLj5-0005Zy-Ds for bug-gnu-emacs@gnu.org; Wed, 13 Aug 2008 15:09:43 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1KTLj3-0005YX-KH for bug-gnu-emacs@gnu.org; Wed, 13 Aug 2008 15:09:42 -0400 Received: from [199.232.76.173] (port=57898 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KTLj3-0005YM-A8 for bug-gnu-emacs@gnu.org; Wed, 13 Aug 2008 15:09:41 -0400 Received: from colin.muc.de ([193.149.48.1]:1975 helo=mail.muc.de) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1KTLj0-0003vs-Nb for bug-gnu-emacs@gnu.org; Wed, 13 Aug 2008 15:09:39 -0400 Received: (qmail 31431 invoked by uid 3782); 13 Aug 2008 19:09:33 -0000 Received: from acm.muc.de (pD9E51A56.dip.t-dialin.net [217.229.26.86]) by colin2.muc.de (tmda-ofmipd) with ESMTP; Wed, 13 Aug 2008 21:09:32 +0200 Received: (qmail 2932 invoked by uid 1000); 13 Aug 2008 19:11:41 -0000 Date: Wed, 13 Aug 2008 19:11:41 +0000 To: bug-gnu-emacs@gnu.org Subject: directory-files: Doc string is irritatingly vague wrt sorting. Message-ID: <20080813191141.GA2825@muc.de> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.5.9i X-Delivery-Agent: TMDA/1.1.5 (Fettercairn) From: Alan Mackenzie X-Primary-Address: acm@muc.de X-detected-kernel: by monty-python.gnu.org: FreeBSD 4.6-4.9 Hi, Emacs! The doc string for directory files is: directory-files is a built-in function in `src/dired.c'. (directory-files DIRECTORY &optional FULL MATCH NOSORT) Return a list of names of files in DIRECTORY. There are three optional arguments: If FULL is non-nil, return absolute file names. Otherwise return names that are relative to the specified directory. If MATCH is non-nil, mention only file names that match the regexp MATCH. If NOSORT is non-nil, the list is not sorted--its order is unpredictable. NOSORT is useful if you plan to sort the result yourself. This sort of implies (but doesn't state) that if NOSORT is nil, the returned list is sorted. More importantly, it doesn't state the predicate used for the sorting. "Obviously", this will be some sort of alphabetical sort, but this gets complicated for mixed case filenames and (more importantly) for character sets which aren't vanilla ASCII. -- Alan Mackenzie (Nuremberg, Germany). ------------=_1218831905-32233-0 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit 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=-3.5 required=4.0 tests=AWL,BAYES_00 autolearn=ham version=3.2.3-bugs.debian.org_2005_01_02 Received: (at 714-done) by emacsbugs.donarmstrong.com; 15 Aug 2008 20:18:23 +0000 Received: from cyd.mit.edu (CYD.MIT.EDU [18.115.2.24]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m7FKIKLe030547 for <714-done@emacsbugs.donarmstrong.com>; Fri, 15 Aug 2008 13:18:21 -0700 Received: by cyd.mit.edu (Postfix, from userid 1000) id ACE3F57E337; Fri, 15 Aug 2008 16:19:06 -0400 (EDT) From: Chong Yidong To: Alan Mackenzie Cc: 714-done@emacsbugs.donarmstrong.com Subject: Re: directory-files: Doc string is irritatingly vague wrt sorting. Date: Fri, 15 Aug 2008 16:19:06 -0400 Message-ID: <877iai8211.fsf@cyd.mit.edu> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii I've clarified the docstring. Thanks. ------------=_1218831905-32233-0--