From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#11571: 24.0.97; doc string of `dired-get-subdir-min' Date: Tue, 05 Nov 2019 16:09:32 +0100 Message-ID: <871rum742b.fsf@marxist.se> References: <144EDF3C01664A2180447B02D1A6EB09@us.oracle.com> <484EACDE2A4A4185B158B84473AB1710@us.oracle.com> <871tzdgcmg.fsf@building.gnus.org> <878sozighj.fsf@skangas.se> <7374f5d9-6d88-4351-bd63-b526ea0d3486@default> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="160846"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: Lars Ingebrigtsen , 11571@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Nov 05 16:10:25 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iS0TR-000ffc-9X for geb-bug-gnu-emacs@m.gmane.org; Tue, 05 Nov 2019 16:10:25 +0100 Original-Received: from localhost ([::1]:45032 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iS0TP-00079A-Ad for geb-bug-gnu-emacs@m.gmane.org; Tue, 05 Nov 2019 10:10:23 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:33842) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iS0T9-00077A-88 for bug-gnu-emacs@gnu.org; Tue, 05 Nov 2019 10:10:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iS0T4-0007Jd-9l for bug-gnu-emacs@gnu.org; Tue, 05 Nov 2019 10:10:07 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:58357) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iS0T4-0007JV-2W for bug-gnu-emacs@gnu.org; Tue, 05 Nov 2019 10:10:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iS0T3-00008C-Ot for bug-gnu-emacs@gnu.org; Tue, 05 Nov 2019 10:10:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 05 Nov 2019 15:10:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 11571 X-GNU-PR-Package: emacs Original-Received: via spool by 11571-submit@debbugs.gnu.org id=B11571.1572966586475 (code B ref 11571); Tue, 05 Nov 2019 15:10:01 +0000 Original-Received: (at 11571) by debbugs.gnu.org; 5 Nov 2019 15:09:46 +0000 Original-Received: from localhost ([127.0.0.1]:38945 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iS0Sn-00007b-KN for submit@debbugs.gnu.org; Tue, 05 Nov 2019 10:09:45 -0500 Original-Received: from host.gofardesign.uk ([208.79.239.190]:39392) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iS0Sl-00007I-3n for 11571@debbugs.gnu.org; Tue, 05 Nov 2019 10:09:44 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=marxist.se; s=default; h=Content-Type:MIME-Version:Message-ID:Date:References: In-Reply-To:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=ahp/NZaJ+0Z1DKOo5ZTAf80YKcYSyz52UIpT+crrxf4=; b=A41bVmEQj/ORqwA2vrujGPxiZh Xwi5tuiQlDLqEs2ufEBSNAG3up1t5l101L9yzGeX+H50YLS2Z5BO53TLD9OOGILw6vEMcoxjbgCz/ ZL0TjYRLqB6pBO8PeSuJdBsA5crojBc8ROJ58uqpQqVC8I8nBNozgGsKwE2KJzvHaw5A=; Original-Received: from h-70-69.a785.priv.bahnhof.se ([155.4.70.69]:59880 helo=localhost) by host.gofardesign.uk with esmtpsa (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.92) (envelope-from ) id 1iS0Sc-0007N1-NV; Tue, 05 Nov 2019 09:09:35 -0600 In-Reply-To: <7374f5d9-6d88-4351-bd63-b526ea0d3486@default> (Drew Adams's message of "Fri, 1 Nov 2019 13:54:55 -0700 (PDT)") X-OutGoing-Spam-Status: No, score=-1.0 X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - host.gofardesign.uk X-AntiAbuse: Original Domain - debbugs.gnu.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - marxist.se X-Get-Message-Sender-Via: host.gofardesign.uk: authenticated_id: stefan@marxist.se X-Authenticated-Sender: host.gofardesign.uk: stefan@marxist.se X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.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" Xref: news.gmane.org gmane.emacs.bugs:170976 Archived-At: Drew Adams writes: > The use of cdr is clear enough, as long as you > understand what `dired-subdir-alist' is. > > But that could be clearer. > > `C-h v dired-subdir-alist' says: > > Association list of subdirectories and their buffer positions. > Each subdirectory has an element: (DIRNAME . STARTMARKER). > ... > > Directories don't have buffer positions. > > It would be clearer to say "listed subdirectories". > It's not about subdirectories. It's about those > subdirs that are listed in the Dired buffer, and > STARTMARKER is the buffer position where such a > _listing_ starts. > > The buffer position of a subdirectory isn't clear. > The buffer position of a subdirectory listing is > clear. FWIW, I think it's already clear enough, given that the value after dired-maybe-insert-subdir will be something like: (("/home/skangas/wip/emacs/etc/" . #) ("/home/skangas/wip/emacs/" . #)) I'm not against trying to make it even clearer though. Do you have a suggestion for how to rewrite this text without going over the recommended 67 character limit? Association list of subdirectories and their buffer positions. The best I could come up with is this (exactly 67 characters): Alist of subdirectories and the buffer positions of their listings. Best regards, Stefan Kangas