From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#67053: 29.1; Doc string of variable `dired-use-ls-dired' Date: Fri, 10 Nov 2023 20:41:01 +0000 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="39455"; mail-complaints-to="usenet@ciao.gmane.io" To: 67053@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Nov 10 21:42:45 2023 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1r1YKx-0004wX-Tv for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 10 Nov 2023 21:42:44 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1r1YKf-0000yk-2o; Fri, 10 Nov 2023 15:42:25 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1r1YKc-0000yG-Td for bug-gnu-emacs@gnu.org; Fri, 10 Nov 2023 15:42:22 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1r1YKc-0003HF-J5 for bug-gnu-emacs@gnu.org; Fri, 10 Nov 2023 15:42:22 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1r1YLG-0007FC-6W for bug-gnu-emacs@gnu.org; Fri, 10 Nov 2023 15:43: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: Fri, 10 Nov 2023 20:43:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 67053 X-GNU-PR-Package: emacs X-Debbugs-Original-To: "bug-gnu-emacs@gnu.org" Original-Received: via spool by submit@debbugs.gnu.org id=B.169964892127764 (code B ref -1); Fri, 10 Nov 2023 20:43:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 10 Nov 2023 20:42:01 +0000 Original-Received: from localhost ([127.0.0.1]:50942 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1r1YKH-0007Dg-5Z for submit@debbugs.gnu.org; Fri, 10 Nov 2023 15:42:01 -0500 Original-Received: from lists.gnu.org ([2001:470:142::17]:40838) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1r1YKC-0007DN-60 for submit@debbugs.gnu.org; Fri, 10 Nov 2023 15:42:00 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1r1YJS-0000tq-9f for bug-gnu-emacs@gnu.org; Fri, 10 Nov 2023 15:41:10 -0500 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1r1YJP-00036N-Jp for bug-gnu-emacs@gnu.org; Fri, 10 Nov 2023 15:41:10 -0500 Original-Received: from pps.filterd (m0333521.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 3AAHiU8w020691 for ; Fri, 10 Nov 2023 20:41:05 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : subject : date : message-id : content-type : content-transfer-encoding : mime-version; s=corp-2023-03-30; bh=c6DYQcn5orPRszcTYYzorFkhNc0AIx53grhFtQNxgFY=; b=KDhfK2IDxEYxbaUn2aXG3Li0fNGhpAqZ9OJ6c5jg4ncK8VJE+nkzY6n2nLe3/jZFrbJq O9sFd6kkogEb/TGBIVuT5F62b3c9syyJoCN8NfLpHpVwJmo/lsX/A78TrSn0v6wDyrHB Etrra8Jse3BGWX1LcwjBtjxmdm7XNku5QRf0PIkg2GccxcPdqdgHox0+T9Evq5uAeZUT VgpXijZd/PI0O0c8nfLqQroHKG1Re5Ex57Si+7hxIBRHTrnl6bUmB+HoIiAXlLCR2ljR WWnuxjkMp/3ew7sw/zH0+u2oU0goOxgHZ67z7h4CY6zSFbsfQV4Lp7P1W0GVuToIbzgM Fw== Original-Received: from iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta03.appoci.oracle.com [130.35.103.27]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3u7w23pv49-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 10 Nov 2023 20:41:04 +0000 Original-Received: from pps.filterd (iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 3AAIcLSF018297 for ; Fri, 10 Nov 2023 20:41:03 GMT Original-Received: from nam12-bn8-obe.outbound.protection.outlook.com (mail-bn8nam12lp2168.outbound.protection.outlook.com [104.47.55.168]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3u8c028sb4-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 10 Nov 2023 20:41:03 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=l8dZin2lYtGfREObIJrgQj6Sw7wgxrd2QXKsj5UJHXnrSBexHLQlwJ7v5dhhBHO1U48pqYRVrJivdsAFbEP4Sg0Bh7oyVXeboZDqAngthjeDyv0Qva0a1MnI7qLiHZTwdcX2B2Ff8CVetWjr2xwbDbxIciYKgw49o1ELcgSGzE2Pw7QPCNWPHQrcFvbcx7CAJ+tN14VIPUHepmsjmv7Pf4c8Nm/h/pYUjlGWvR5jsylYZkOrMHZ1SWIrQF5BICt9OSaYwUAvlbs31onetGimPvgMco0hnhAyZk4c6M9pgq3v4Y4rVw2DLEXOkqJvPUX3iqsHQNUD1MzBUYiSKrsDYA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=c6DYQcn5orPRszcTYYzorFkhNc0AIx53grhFtQNxgFY=; b=QlnG4eehhZWtgH9v+599WfF/awwKbfBjYh6NXaUVTdI1KRS+ovN40c9TcU56SZJ+R5I65C3oQ9TYcFJYu9dtnojJ7JsnXsacUtXb2U66kmaeR7jJq7VNwnG3/f3sXQ4bRQxQHBb4gb+oQrM4RvMnGn0qp0THHEemtGMZVkoz8ZdZ/LnPfpaKb4S0hC0aZEwGQ+SvvOcDqOGgjgqZFD12pHrH6A+vkodCoi/SDf7TLOR+JYfsCX5WdCPmCw+SY0Uyapw/gJL6jCFA2piTttPhFTtJC0vokUBiuwyAPbGz4tYGR+Avlaq1caSP0Wr9FeCJgjrLRk28LXSpk1V6VD/jkQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=c6DYQcn5orPRszcTYYzorFkhNc0AIx53grhFtQNxgFY=; b=l/iMIISc68FCigVlBtW0/SrH9LFzzBdHJsJU8/xhsQZcpmED5TnxnqSrrwD5VNY6QYgKMUau04cSwnq1SYZz6Zdczxr1e2YW5VBfik5lizj9UWYvxZ5tROXrYB8i7qxussYt3rsGezpVGPwniXMXEMohvQbL31ijEb7akq5Lp/w= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by PH0PR10MB5780.namprd10.prod.outlook.com (2603:10b6:510:149::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6954.28; Fri, 10 Nov 2023 20:41:01 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::3b4c:a669:c229:47b4]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::3b4c:a669:c229:47b4%6]) with mapi id 15.20.6977.019; Fri, 10 Nov 2023 20:41:01 +0000 Thread-Topic: 29.1; Doc string of variable `dired-use-ls-dired' Thread-Index: AdoUFcw1fjQHwBBzQDaFxUcSDtefYA== Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-traffictypediagnostic: SJ0PR10MB5488:EE_|PH0PR10MB5780:EE_ x-ms-office365-filtering-correlation-id: df24e1f4-8f94-4047-6c4b-08dbe22d5a11 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: iFYF1pDOABHO123q8IFl5FbcVjWwYtb03uoa+MPoIcrHGVsPOQaNSIVuBQ34j0utmRA0EHi7RyhrkFI5nDz/FdO8iFyXshKEXE6CCsqMJInK0IWUB9RkPKHcITmCPCYhJfteykmFCR8bseFyUn21fmYQI8l5+8orB7gddmPGL1OY7qCYvG9oew3ssVtv5t9po0d0VpfTJ+AGEcWRgZt9MCcnHcaYweIdCVsPJVkNkoqBwmtrShrjf1b8XWP+JH2H2Ojk/mWHj6sVcycMYjzafuEj2sC7MY6iZw+zQwQzcoRQhaNzvFRTpnITU7j/FkUUC/wVJNH3tYWa23YXKWkbp2ODqQ3ckXOT+aGznkb9Ljc11nvIrAq1lgOcrriNeJ/5+2fPqHa+jnAZAhg/aAuSKbNSooRMouSVfiwDRcROLo5AkO17lfqc21+o/loHB7KdpdVUXAWzbCmfhnOhG8iufrtH+xg9fQUmuE/Bq6B24OPX6GJ0k5yrSkPw8iUzxwEMrg0fmsc+ba/boPcTOjGNcnJ5XWXiKnKEO51QyOPPUnmy+jNGYX7PE95yLCw2Nei0wtMfp/l30+e6tNTBxqfd/x2kk82WnUM9nuDKgnIrSJtbmDRtAanD3S38zpS9ClhrBsF8afu3Bg8JjcDXCH9RxA== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SJ0PR10MB5488.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230031)(366004)(396003)(376002)(136003)(346002)(39860400002)(230922051799003)(64100799003)(451199024)(1800799009)(186009)(55016003)(38100700002)(8676002)(38070700009)(41300700001)(8936002)(86362001)(33656002)(2906002)(71200400001)(7696005)(6506007)(478600001)(66476007)(122000001)(64756008)(9686003)(45080400002)(76116006)(5660300002)(316002)(52536014)(66946007)(66446008)(44832011)(6916009)(26005)(66556008)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: A5b/2Jda2Xi/zJIovIvcKyzYT1uyJ6q+1I/FBK9yoAvr50Rb+/g7scft0SkF/Xd47/EujCXNq5UFlM52H2A3KVi9AUsrYIzd+FQNb/g+G3um4B40ERTntvLnC3bZjWGMfLvllpBMKYIhqlwxxjU9E3BNHItk0zJINGQXvj1mnfJZepDUll+bb08LnEa1xazBR116pkQKmmC8XT/ZN5PnWF9bSJiSChAIEIk8oeirZw43jQ30tf5zvdSl5Erl362QLoKhKqQYX9SaJMpVIvhIhjKm+TqhD1qvGu3HOhJGjz1k8nhSNIdzpZYolrtWKIaDF8qRmfemxHlPvVqyK1aVyLHPvVGu/OhvFgS4dV/pxH0nNcRUFkN9UmXIPeOYUaS+mMPhWw+W7xru+T9nXFBUzUw5V7KE86ThULe7s904YU9uqQGNMepeANz04fHJmmD45HjnnczdJAEuN0yCSIkjHWehg27McqoPF0tr6Pje05f7yo9Vw1yr4ytSAps5IcoVzFjqIhemyeYojkiKBolj4RS6rCNaZ4u7uHckAA8KZ3ur7cVUs1CQoqKFTpleYhhbus9KhZm9tE4AULXDtfiBlQtzVXGUuSlWFoOnRz7rW6j2M75dSvwjM/dydafj+s9c+sdosCMYrOc7ejQDKkn9DRMDhy2MgeeCcMn7e9uMxMKxPCtBZb7GFCXNfx7IVpTKZCkVzXKLSSA3HIBrf3HfpX1IjXay5yFIds0fx4R3DNmsfsMoZvLU3SNP6o mybHPZj5wRX03Chx+AMnZFYWHAcnkC9m847AxeoX6/IfPzVWTJhlKlvVJlATPht8TFUzlOoybB3w0sn3tRl9Uqa2jOpnJP8tYa X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: Y+EzemOIxXLSM73nn1XmUdf8f22Tatsj9oOGqFOkOOkFWw1vZVkw1VEHHhoD1bc06Y081MLP+NITgkR/dcnK2T3+5JtH04szzqSBGr2DMMDfoF22DC/MoKLTU+lr9CIPvixX4FZ+flX73IDzVmDknEcFJLP73o4a8YDZ9BmFmdPHblgu0J5C3OUgQwnNqjG6QQ55hQA6/3mC45MA8iyvQ6moJ4+IuPsXPRVFYnwkdLp6/9YzkVLTtrIb/1hNURIamf3sdU0VNmAvesIiB9ImgMeuTPu7TJdA4TjNJmCb4v41tuSUO9RyCJgZMSCzpDxSjzBAn0LeFswAMoUYOFZ4zHaQqQNelChMZFOBdyVT1cDQSVeeSHehQP/yYuWXXct+kUxrD1qkd5xUj+M5rm2XavUXxFLfcAdGXz49GEDjxeB0qVFrtH0ohTcKjPWghxrnis3JxDr6OZcwVJtE917098QLbRdmKyL8kCc6+rgIj5b0P7pe+LzvAQDI8lhd1CKY8CBeNx2POTF9NrZ2uGt1cevOaMeH/olekDbrIiLzaEF6wQMf29UEQB5gM3oVOXrRMhnUlwtN5XV5LsK+S8EntSwaJD3W5r01GlY8PDMdDtaxHsrlBT6hVOjMNNKcCWRSZkfkUF++scnIH0GJHo6hqGka42C+j2qh/RM8ZW2UiBwQqlrjYvSw5x4snl0Y4t6r3zmRyEQ44gfunGM6Hn1XE/61cHmFdtA76SU2N4CqR1gyZp jS8jMTZEtKhzxzVXwZ X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SJ0PR10MB5488.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: df24e1f4-8f94-4047-6c4b-08dbe22d5a11 X-MS-Exchange-CrossTenant-originalarrivaltime: 10 Nov 2023 20:41:01.5047 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: 4wh9fK+Km63e525iCEnRLmjY7FhWKP6uue0C41QAeC5fnghU1ycjDo1sVikQNjrAQT3O+cEJ5DoR264/xFl3qw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR10MB5780 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.987,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-11-10_18,2023-11-09_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=770 phishscore=0 spamscore=0 suspectscore=0 adultscore=0 bulkscore=0 malwarescore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2311060000 definitions=main-2311100172 X-Proofpoint-GUID: KNj4m3uzO02Prhg5XYKWD7eqkVVaUoOM X-Proofpoint-ORIG-GUID: KNj4m3uzO02Prhg5XYKWD7eqkVVaUoOM Received-SPF: pass client-ip=205.220.165.32; envelope-from=drew.adams@oracle.com; helo=mx0a-00069f02.pphosted.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:275493 emacs -Q. With MS Windows, which uses ls-lisp, the value of this variable is `unspecified'. I think it always has this value. Maybe this is necessary/correct (?). But the doc string says this: The special value of 'unspecified' means to check whether "ls" supports the "--dired" option, and save the result in this variable. This is performed the first time 'dired-insert-directory' is invoked. That's not as clear as it should be. It gives the impression that the result of saving the result of that check of the value will be nil or some non-nil value other than `unspecified'. It would be better to at least say that the result of the check can be that it hasn't been determined whether "ls" supports the "--dired" option, and thus that the variable value will remain `unspecified' after the check. Or if it's the case that the check does, for MS Windows (or more generally for ls-lisp use), determine that "ls" doesn't support "--dired", then the value should be changed from `unspecified' to some other non-nil value, such as `t'. Perhaps I'm misunderstanding something? If so, please make the doc string clearer to avoid such misunderstanding. Thx. In GNU Emacs 29.1 (build 2, x86_64-w64-mingw32) of 2023-08-02 built on AVALON Windowing system distributor 'Microsoft Corp.', version 10.0.19045 System Description: Microsoft Windows 10 Pro (v10.0.2009.19045.3570) Configured using: 'configure --with-modules --without-dbus --with-native-compilation=3Daot --without-compress-install --with-tree-sitter CFLAGS=3D-O2' Configured features: ACL GIF GMP GNUTLS HARFBUZZ JPEG JSON LCMS2 LIBXML2 MODULES NATIVE_COMP NOTIFY W32NOTIFY PDUMPER PNG RSVG SOUND SQLITE3 THREADS TIFF TOOLKIT_SCROLL_BARS TREE_SITTER WEBP XPM ZLIB (NATIVE_COMP present but libgccjit not available)