From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.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: Tue, 5 Nov 2019 08:21:39 -0800 (PST) Message-ID: References: <144EDF3C01664A2180447B02D1A6EB09@us.oracle.com> <484EACDE2A4A4185B158B84473AB1710@us.oracle.com> <871tzdgcmg.fsf@building.gnus.org> <878sozighj.fsf@skangas.se> <7374f5d9-6d88-4351-bd63-b526ea0d3486@default> <871rum742b.fsf@marxist.se> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="212688"; mail-complaints-to="usenet@blaine.gmane.org" Cc: Lars Ingebrigtsen , 11571@debbugs.gnu.org To: Stefan Kangas Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Nov 05 17:22:16 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 1iS1av-000t8f-7C for geb-bug-gnu-emacs@m.gmane.org; Tue, 05 Nov 2019 17:22:13 +0100 Original-Received: from localhost ([::1]:45966 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iS1at-0004nV-FA for geb-bug-gnu-emacs@m.gmane.org; Tue, 05 Nov 2019 11:22:11 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:55978) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iS1al-0004nE-PO for bug-gnu-emacs@gnu.org; Tue, 05 Nov 2019 11:22:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iS1ak-0002Zz-Mw for bug-gnu-emacs@gnu.org; Tue, 05 Nov 2019 11:22:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:58412) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iS1ak-0002Zu-II for bug-gnu-emacs@gnu.org; Tue, 05 Nov 2019 11:22:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iS1ak-00025L-C3 for bug-gnu-emacs@gnu.org; Tue, 05 Nov 2019 11:22:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 05 Nov 2019 16:22:02 +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.15729709107998 (code B ref 11571); Tue, 05 Nov 2019 16:22:02 +0000 Original-Received: (at 11571) by debbugs.gnu.org; 5 Nov 2019 16:21:50 +0000 Original-Received: from localhost ([127.0.0.1]:39000 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iS1aY-00024u-9E for submit@debbugs.gnu.org; Tue, 05 Nov 2019 11:21:50 -0500 Original-Received: from userp2130.oracle.com ([156.151.31.86]:43430) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iS1aW-00024d-KG for 11571@debbugs.gnu.org; Tue, 05 Nov 2019 11:21:49 -0500 Original-Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.27/8.16.0.27) with SMTP id xA5GESns091653; Tue, 5 Nov 2019 16:21:42 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2019-08-05; bh=VNdEMnZGHpaFMs7T7/XJsZlPchkcCUYBk6FGjJihYw0=; b=BNxvLLfCVxydfFZDB/E8Rqn+MuO1gOHS9svzXIRDzqjXUH5VPgfr7lxY3K/RofErLZGE 2aP4BpYX/UF8d/5dIHWNvCSVSehpi3CUB8NdOFY5lM4PRAiMT5uki9wLWL9kFKPByw9F rU/VV2uiU1y1iBvMenOU0xtXUEhtLPM5VPRy4EOHamJWAYgAibPR5NHnlhquh/7Wucwl txXoD5T4ZeWmau9hvJsFTVCGzB6qsrhkxHFnjLiPaenI1//GDMjbXFQaG+wdoDgXddXV m6Ahl2ADXDxrRo0c4qRwX5mEK/t1GseMahfcZLZOxY2CZ3JnljdAIIuQ/P/xalnvF0JE bw== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by userp2130.oracle.com with ESMTP id 2w117tyqen-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 05 Nov 2019 16:21:42 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.27/8.16.0.27) with SMTP id xA5GJYWH019954; Tue, 5 Nov 2019 16:21:42 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserp3020.oracle.com with ESMTP id 2w2wck75da-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 05 Nov 2019 16:21:41 +0000 Original-Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id xA5GLeA4006699; Tue, 5 Nov 2019 16:21:40 GMT In-Reply-To: <871rum742b.fsf@marxist.se> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4900.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9432 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1911050134 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9432 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1911050134 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:170978 Archived-At: > > 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. > =20 > 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. I already suggested it, at the beginning: "listed subdirectories" instead of just "subdirectories". To be even more precise, as it's not the listed subdirs that are used in the alist, but their names: Alist of listed subdirectory names and their buffer positions. However, the alist contains not only elements for the listed subdirs but also an element for the listed main dir. The doc string is unclear about that. This is clear, I think. And the lines are all less than 60 chars wide: Alist of listed directory names and their buffer positions. Alist elements have the form (DIRNAME . STARTMARKER), where DIRNAME is the listed absolute name of the directory and STARTMARKER is a marker at the beginning of DIRNAME. The elements are in reverse order of the listing. If no subdirectories are listed then the alist contains only one element, for the listed directory. That also makes clear that DIRNAME is an absolute file name, and it is what is shown in the listing. And it makes clear what the "one element" is when there are no subdir listings.=20