From unknown Tue Jun 17 01:34:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#77974: Manual updates for the VC-aware project backend Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 21 Apr 2025 21:52:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 77974 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: 77974@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.17452723106422 (code B ref -1); Mon, 21 Apr 2025 21:52:02 +0000 Received: (at submit) by debbugs.gnu.org; 21 Apr 2025 21:51:50 +0000 Received: from localhost ([127.0.0.1]:40014 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u6z3N-0001fW-Gy for submit@debbugs.gnu.org; Mon, 21 Apr 2025 17:51:50 -0400 Received: from lists.gnu.org ([2001:470:142::17]:32876) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u6z3J-0001fF-7r for submit@debbugs.gnu.org; Mon, 21 Apr 2025 17:51:46 -0400 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 1u6z3D-00017n-EU for bug-gnu-emacs@gnu.org; Mon, 21 Apr 2025 17:51:39 -0400 Received: from fout-a3-smtp.messagingengine.com ([103.168.172.146]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1u6z3A-0002TX-NQ for bug-gnu-emacs@gnu.org; Mon, 21 Apr 2025 17:51:39 -0400 Received: from phl-compute-04.internal (phl-compute-04.phl.internal [10.202.2.44]) by mailfout.phl.internal (Postfix) with ESMTP id D51051380185 for ; Mon, 21 Apr 2025 17:51:33 -0400 (EDT) Received: from phl-mailfrontend-02 ([10.202.2.163]) by phl-compute-04.internal (MEProxy); Mon, 21 Apr 2025 17:51:33 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gutov.dev; h=cc :content-type:content-type:date:date:from:from:in-reply-to :message-id:mime-version:reply-to:subject:subject:to:to; s=fm1; t=1745272293; x=1745358693; bh=L4bVkhZSBggv3d8j5suF16iNMg0UqznH 6gPRZs4UR8s=; b=QZMzNvmeqzl7ktexcDVG5sRkjWJzbWw4WBOwkj63XLYB2fsg 6jVImRFYws4tPP+V5OQzeb2+nhUT7nLAXLAVAqKSYf2dqQrUBcgTGuD3KQcTKqZM 4PpE/YqHWTFECNqfp+D5UTvaEUF7EScrs8xxMiKBlpCiIV/536uLLZtN7pzE8UoF goBO+3ye7POHLqhWoThBAFnEznb4H4MQUxXgnLmehdSAL77CiRB2qMtZ1TkKzga5 OZQiDV6fraY6GCnbZWHj0BSuxLDt+Y/8PBPWcIbgXJ4tewH7lPX3YsVRrPLgPM1c qRLd89nX6wkDAZZeZvUb1N4AaVxz/vOWKSIADA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:content-type:date:date :feedback-id:feedback-id:from:from:in-reply-to:message-id :mime-version:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm2; t=1745272293; x= 1745358693; bh=L4bVkhZSBggv3d8j5suF16iNMg0UqznH6gPRZs4UR8s=; b=h RPUeuTL+1Eu040tqH+p8vfl6tiCANGbSLIV6vaU1fZJi2WsOO2QXvvasxYujhqC5 zWoY0XtB2UntCSteqjstnnDCc6SGqGWHkMaN61r3XzrDoOZ8G2muyTRNr33vqSrg ZWvDugmeuW7qoUD3G1pK4Bc0QTUBEGOdB/r1egAmySQCUke3ND8ztnVtmnu/ptH2 8MygpQoHrWUkKMNk+MNnyP+Y07F0W9uWyFAQ8CIoRO5WlE42QAXeqa8nDvYL7wxE gRE+xJdYevxZvH/SbT3kSjpu5fRPL+7lM21Xh680OtXpm94Mn4hcAahXqDssyWWf sNfAP4rIwGWqVMTqX/kRQ== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefvddrtddtgddvgeduleejucetufdoteggodetrf dotffvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdggtfgfnhhsuhgsshgtrhhisggv pdfurfetoffkrfgpnffqhgenuceurghilhhouhhtmecufedttdenucenucfjughrpegtkf ffgggfvffhufesmhdtreertddvjeenucfhrhhomhepffhmihhtrhihucfiuhhtohhvuceo ughmihhtrhihsehguhhtohhvrdguvghvqeenucggtffrrghtthgvrhhnpeehvdffheeige fftdelgfeugfelgfduueehfeeljeduueekieetiefhhefhheeuheenucevlhhushhtvghr ufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpegumhhithhrhiesghhuthhovh druggvvhdpnhgspghrtghpthhtohepuddpmhhouggvpehsmhhtphhouhhtpdhrtghpthht ohepsghughdqghhnuhdqvghmrggtshesghhnuhdrohhrgh X-ME-Proxy: Feedback-ID: i07de48aa:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Mon, 21 Apr 2025 17:51:33 -0400 (EDT) Content-Type: multipart/mixed; boundary="------------5Awgzls6RR1nHkYiefXMKJ8r" Message-ID: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> Date: Tue, 22 Apr 2025 00:51:30 +0300 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Content-Language: en-US From: Dmitry Gutov Received-SPF: pass client-ip=103.168.172.146; envelope-from=dmitry@gutov.dev; helo=fout-a3-smtp.messagingengine.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_H2=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.3 (/) This is a multi-part message in MIME format. --------------5Awgzls6RR1nHkYiefXMKJ8r Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Tags: patch Here are some proposed updates, which create a new node for this backend and list some of the options that were until now not mentioned in the manual. Feedback welcome on the general structure (do we want the new node in that place?) and the phrasing of the new text as well. --------------5Awgzls6RR1nHkYiefXMKJ8r Content-Type: text/x-patch; charset=UTF-8; name="project-vc-manual-updates.diff" Content-Disposition: attachment; filename="project-vc-manual-updates.diff" Content-Transfer-Encoding: base64 ZGlmZiAtLWdpdCBhL2RvYy9lbWFjcy9tYWludGFpbmluZy50ZXhpIGIvZG9jL2VtYWNzL21h aW50YWluaW5nLnRleGkKaW5kZXggYzc2MWRjMzNjODYuLmY2YzBjZDcxZGM0IDEwMDY0NAot LS0gYS9kb2MvZW1hY3MvbWFpbnRhaW5pbmcudGV4aQorKysgYi9kb2MvZW1hY3MvbWFpbnRh aW5pbmcudGV4aQpAQCAtMTc4MiwyMCArMTc4MiwxOCBAQCBQcm9qZWN0cwogYSBoaWVyYXJj aHkgb2YgZGlyZWN0b3JpZXM7IHRoZSB0b3AtbGV2ZWwgZGlyZWN0b3J5IG9mIHRoZSBoaWVy YXJjaHkKIGlzIGtub3duIGFzIHRoZSBAZGZue3Byb2plY3Qgcm9vdH0uCiAKLUBjaW5kZXgg cHJvamVjdCBiYWNrLWVuZAorQGNpbmRleCBwcm9qZWN0IGJhY2tlbmQKICAgV2hldGhlciBh IGdpdmVuIGRpcmVjdG9yeSBpcyBhIHJvb3Qgb2Ygc29tZSBwcm9qZWN0IGlzIGRldGVybWlu ZWQgYnkKLXRoZSBwcm9qZWN0LXNwZWNpZmljIGluZnJhc3RydWN0dXJlLCBrbm93biBhcyBA ZGZue3Byb2plY3QgYmFjay1lbmR9LgotRW1hY3MgY3VycmVudGx5IHN1cHBvcnRzIHR3byBz dWNoIGJhY2stZW5kczogVkMtYXdhcmUgKEBweHJlZntWZXJzaW9uCit0aGUgcHJvamVjdC1z cGVjaWZpYyBpbmZyYXN0cnVjdHVyZSwga25vd24gYXMgQGRmbntwcm9qZWN0IGJhY2tlbmR9 LgorRW1hY3MgY3VycmVudGx5IHN1cHBvcnRzIHR3byBzdWNoIGJhY2tlbmRzOiBWQy1hd2Fy ZSAoQHB4cmVme1ZlcnNpb24KIENvbnRyb2x9KSwgd2hlcmVieSBhIFZDUyByZXBvc2l0b3J5 IGlzIGNvbnNpZGVyZWQgYSBwcm9qZWN0OyBhbmQgRURFCiAoQHB4cmVme0VERX0pLiAgVGhp cyBpcyBleHBlY3RlZCB0byBiZSBleHRlbmRlZCBpbiB0aGUgZnV0dXJlIHRvCiBzdXBwb3J0 IGFkZGl0aW9uYWwgdHlwZXMgb2YgcHJvamVjdHMuCiAKICAgV2hpY2ggZmlsZXMgZG8gb3Ig ZG9uJ3QgYmVsb25nIHRvIGEgcHJvamVjdCBpcyBhbHNvIGRldGVybWluZWQgYnkKLXRoZSBw cm9qZWN0IGJhY2stZW5kLiAgRm9yIGV4YW1wbGUsIHRoZSBWQy1hd2FyZSBiYWNrLWVuZCBk b2Vzbid0Cit0aGUgcHJvamVjdCBiYWNrZW5kLiAgRm9yIGV4YW1wbGUsIHRoZSBWQy1hd2Fy ZSBiYWNrZW5kIGRvZXNuJ3QKIGNvbnNpZGVyIGBgaWdub3JlZCcnIGZpbGVzIChAcHhyZWZ7 VkMgSWdub3JlfSkgdG8gYmUgcGFydCBvZiB0aGUKLXByb2plY3QuICBBbHNvLCB0aGUgVkMt YXdhcmUgUHJvamVjdCBiYWNrLWVuZCBjb25zaWRlcnMgYGB1bnRyYWNrZWQnJwotZmlsZXMg YnkgZGVmYXVsdC4gIFRoYXQgYmVoYXZpb3IgaXMgY29udHJvbGxhYmxlIHdpdGggdGhlIHZh cmlhYmxlCi1AY29kZXtwcm9qZWN0LXZjLWluY2x1ZGUtdW50cmFja2VkfS4KK3Byb2plY3Qu ICBTZWUgaXRzIGVudHJ5IGJlbG93IGZvciBkZXNjcmlwdGlvbiBhbmQgcmVsYXRlZCBvcHRp b25zLgogCiBAY2luZGV4IGN1cnJlbnQgcHJvamVjdCBuYW1lIG9uIG1vZGUgbGluZQogQGRl Zm9wdCBwcm9qZWN0LW1vZGUtbGluZQpAQCAtMTgwNiwxMiArMTgwNCw1OCBAQCBQcm9qZWN0 cwogQGVuZCBkZWZvcHQKIAogQG1lbnUKKyogVkMtQXdhcmUgUHJvamVjdCBCYWNrZW5kOjog RGVmYXVsdCBwcm9qZWN0IGJhY2tlbmQuCiAqIFByb2plY3QgRmlsZSBDb21tYW5kczo6ICAg Q29tbWFuZHMgZm9yIGhhbmRsaW5nIHByb2plY3QgZmlsZXMuCiAqIFByb2plY3QgQnVmZmVy IENvbW1hbmRzOjogQ29tbWFuZHMgZm9yIGhhbmRsaW5nIHByb2plY3QgYnVmZmVycy4KICog U3dpdGNoaW5nIFByb2plY3RzOjogICAgICBTd2l0Y2hpbmcgYmV0d2VlbiBwcm9qZWN0cy4K ICogTWFuYWdpbmcgUHJvamVjdHM6OiAgICAgICBNYW5hZ2luZyB0aGUgcHJvamVjdCBsaXN0 IGZpbGUuCiBAZW5kIG1lbnUKIAorQG5vZGUgVkMtQXdhcmUgUHJvamVjdCBCYWNrZW5kCisK K1RoaXMgYmFja2VuZCBpcyB1c2VkIGJ5IGRlZmF1bHQuICBJdCBkZXRlcm1pbmVzIHRoZSBj b250ZW50cyBvZiB0aGUKK3Byb2plY3QgYmFzZWQgb24gdGhlIFZDUyByZXBvc2l0b3J5J3Mg Y29uZmlndXJhdGlvbiAoaWYgYW55KSwgZXhjbHVkaW5nCit0aGUgYGBpZ25vcmVkJycgZmls ZXMgZnJvbSB0aGUgb3V0cHV0LgorCitJdCBoYXMgc29tZSBwZXJmb3JtYW5jZSBvcHRpbWl6 YXRpb25zIGZvciBsaXN0aW5nIHRoZSBmaWxlcyB3aXRoIHNvbWUgb2YKK3RoZSBwb3B1bGFy IFZDUyBzeXN0ZW1zIChjdXJyZW50bHkgR2l0IGFuZCBNZXJjdXJpYWwpLgorCitAZGVmb3B0 IHByb2plY3QtdmMtaW5jbHVkZS11bnRyYWNrZWQKK2BgdW50cmFja2VkJycgZmlsZXMgYXJl IGNvbnNpZGVyZWQgdG8gYmUgcGFydCBvZiB0aGUgcHJvamVjdC4gIFRvIGNoYW5nZQordGhh dCwgeW91IGNhbiBjdXN0b21pemUgdGhpcyB2YXJpYWJsZSB0byBuaWwuCitAZW5kIGRlZm9w dAorCitAZGVmb3B0IHByb2plY3QtdmMtaWdub3JlcworVXNpbmcgdGhpcyB2YXJpYWJsZSB5 b3UgY2FuIGFkZCBtb3JlIGlnbm9yZSBwYXR0ZXJucyB0byB0aGUgcHJvamVjdCwgdG8KK2V4 Y2x1ZGUgbW9yZSBmaWxlcyBmcm9tIHRoZSBwcm9qZWN0J3MgZmlsZSBsaXN0aW5nLiAgVGhl IHZhbHVlIGlzIGEgbGlzdAorb2YgZ2xvYiBzdHJpbmdzLiAgVGhleSBjYW4gbWF0Y2ggYm90 aCByZWd1bGFyIGZpbGVzIGFuZCBkaXJlY3Rvcmllcy4gIFRvCithbmNob3IgYW4gZW50cnkg dG8gdGhlIHByb2plY3Qgcm9vdCwgc3RhcnQgaXQgd2l0aCBAY29kZXsuL30uICBUbyBtYXRj aAorZGlyZWN0b3JpZXMgb25seSwgZW5kIGl0IHdpdGggQGNvZGV7L30uCitAZW5kIGRlZm9w dAorCitAZGVmb3B0IHByb2plY3QtdmMtbWVyZ2Utc3VibW9kdWxlcworQnkgZGVmYXVsdCBh bGwgc3VibW9kdWxlcyBpbnNpZGUgYSBHaXQgcHJvamVjdCBhcmUgY29uc2lkZXJlZCB0byBi ZSBwYXJ0CitvZiB0aGUgcGFyZW50IHJlcG9zaXRvcnkncyBwcm9qZWN0LiAgQ3VzdG9taXpl IHRoaXMgdG8gbmlsIHRvIG1ha2UgdGhlbQorc2VwYXJhdGUgcHJvamVjdHMuCitAZW5kIGRl Zm9wdAorCitAZGVmb3B0IHByb2plY3QtdmMtbmFtZQorVGhpcyB2YXJpYWJsZSBhbGxvd3Mg eW91IHRvIGNoYW5nZSB0aGUgYXV0b21hdGljYWxseSBkZXRlY3RlZCBuYW1lIG9mCit0aGUg cHJvamVjdCB0byBhIHN0cmluZyBvZiB5b3VyIGNob2ljZS4gIEJ5IGRlZmF1bHQgdGhlIG5h bWUgaXMgdGhlIGJhc2UKK25hbWUgb2YgaXRzIHJvb3QgZGlyZWN0b3J5LgorQGVuZCBkZWZv cHQKKworQGRlZm9wdCBwcm9qZWN0LXZjLWV4dHJhLXJvb3QtbWFya2VycworVGhpcyB2YXJp YWJsZSBhbGxvd3MgeW91IHRvIHNldCB1cCBkZXRlY3Rpb24gb2Ygbm9uLVZDIHByb2plY3Rz IGluIHRoaXMKK2JhY2tlbmQsIGFuZCBhbHNvIHRvIGhhdmUgc29tZSBzdWJkaXJlY3Rvcmll cyBkZXRlY3RlZCBhcyBzZXBhcmF0ZQorcHJvamVjdHMuICBUaGUgdmFsdWUgaXMgYSBsaXN0 LgorCitFYWNoIGVsZW1lbnQgaXMgZWl0aGVyIGEgYmFzZSBmaWxlIG5hbWUgb3IgYSBnbG9i IHBhdHRlcm4gZm9yIHN1Y2guCisKK0V4YW1wbGUgdmFsdWVzOiBAc2FtcHsiLmRpci1sb2Nh bHMuZWwifSwgQHNhbXB7InBhY2thZ2UuanNvbiJ9LAorQHNhbXB7InJlcXVpcmVtZW50cy50 eHR9LCBAc2FtcHsiKi5nZW1zcGVjIn0uCitAZW5kIGRlZm9wdAorCiBAbm9kZSBQcm9qZWN0 IEZpbGUgQ29tbWFuZHMKIEBzdWJzZWN0aW9uIFByb2plY3QgQ29tbWFuZHMgVGhhdCBPcGVy YXRlIG9uIEZpbGVzCiAK --------------5Awgzls6RR1nHkYiefXMKJ8r-- From unknown Tue Jun 17 01:34:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#77974: Manual updates for the VC-aware project backend Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 22 Apr 2025 11:59:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 77974 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Dmitry Gutov Cc: 77974@debbugs.gnu.org Received: via spool by 77974-submit@debbugs.gnu.org id=B77974.174532310326792 (code B ref 77974); Tue, 22 Apr 2025 11:59:02 +0000 Received: (at 77974) by debbugs.gnu.org; 22 Apr 2025 11:58:23 +0000 Received: from localhost ([127.0.0.1]:46582 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u7CGc-0006y0-Al for submit@debbugs.gnu.org; Tue, 22 Apr 2025 07:58:22 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:57596) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u7CGX-0006xl-Rt for 77974@debbugs.gnu.org; Tue, 22 Apr 2025 07:58:20 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1u7CGS-0001hV-4Z; Tue, 22 Apr 2025 07:58:12 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=45Wyj3n/I7jWdCPcqG4Bz1H41T3t/2rk0p2zsNCDs8I=; b=bUTJcBJC4hnD yV8u/7EtnuznlXeK8Oq4baIc/i3dU0nj13YKn3Xz9AyCyipvIcqHbpb3Ue48CUj/bmGmSnru1FM/7 LeetZYUf92WKLM+0FGkNp/yRy0FczQTugO+18RgofXGGyHlg+5au3hQBOvSwuU1Vmt/2xbtx7nMyI DQW1Vvg6KrQmxN7nnK2zMBxZfq0NT34vdQloh/UTV59jHm55/VyUQAaBjNtvy6r3DclQc2AZepya5 VuFRQjFw7245mh5ZmbzT+Jlr322c/yMl8K6Uga4lcArhMkIK2XRiaxVenAMXNbZxIykpXjTLZGiti 2okmaJelRteAdNrWaIZ/ZA==; Date: Tue, 22 Apr 2025 14:58:07 +0300 Message-Id: <86msc82ysw.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> (message from Dmitry Gutov on Tue, 22 Apr 2025 00:51:30 +0300) References: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Tue, 22 Apr 2025 00:51:30 +0300 > From: Dmitry Gutov > > Here are some proposed updates, which create a new node for this backend > and list some of the options that were until now not mentioned in the > manual. > > Feedback welcome on the general structure (do we want the new node in > that place?) and the phrasing of the new text as well. Thanks. This node should probably be the last in its parent node, not the first one, because it describes a specific project backend while the rest of the section describes backend-agnostic features. I'm also not sure why these 5 user options are deemed important enough to be in the manual, while the other 14 defined in project.el aren't. E.g., is project-vc-merge-submodules (which seems to be specific to Git, but its name doesn't say so?) really important enough to be in the manual? > +@node VC-Aware Project Backend Index entry leading to this node is missing here. Think about a reader who wants to find this quickly without knowing the exact name of the node. > +This backend is used by default. This sentence confused me. What does it mean for a backend to be used by default? This should be explained, I think, if we consider this backend important enough to be described. > +@defopt project-vc-include-untracked > +``untracked'' files are considered to be part of the project. To change ^^^^^^^^^^^ Sentences should start with capital letters. Also, when you introduce new terminology, it is best to use @dfn instead of literal quotes, and also have an indexing command for that terminology. > +that, you can customize this variable to nil. > +@end defopt > + > +@defopt project-vc-ignores > +Using this variable you can add more ignore patterns to the project, to > +exclude more files from the project's file listing. The value is a list > +of glob strings. They can match both regular files and directories. To > +anchor an entry to the project root, start it with @code{./}. To match > +directories only, end it with @code{/}. > +@end defopt > + > +@defopt project-vc-merge-submodules > +By default all submodules inside a Git project are considered to be part > +of the parent repository's project. Customize this to nil to make them > +separate projects. > +@end defopt > + > +Each element is either a base file name or a glob pattern for such. > + > +Example values: @samp{".dir-locals.el"}, @samp{"package.json"}, > +@samp{"requirements.txt}, @samp{"*.gemspec"}. Since these are file names, it is better to use @file markup and lose the quotes. If you decide to install this, don't forget to update the @detailmenu in emacs.texi. From unknown Tue Jun 17 01:34:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#77974: Manual updates for the VC-aware project backend Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 22 Apr 2025 17:05:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 77974 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Eli Zaretskii Cc: 77974@debbugs.gnu.org Received: via spool by 77974-submit@debbugs.gnu.org id=B77974.174534146721603 (code B ref 77974); Tue, 22 Apr 2025 17:05:02 +0000 Received: (at 77974) by debbugs.gnu.org; 22 Apr 2025 17:04:27 +0000 Received: from localhost ([127.0.0.1]:49683 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u7H2o-0005cN-V8 for submit@debbugs.gnu.org; Tue, 22 Apr 2025 13:04:27 -0400 Received: from fout-b6-smtp.messagingengine.com ([202.12.124.149]:41699) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u7H2j-0005c4-MQ for 77974@debbugs.gnu.org; Tue, 22 Apr 2025 13:04:24 -0400 Received: from phl-compute-04.internal (phl-compute-04.phl.internal [10.202.2.44]) by mailfout.stl.internal (Postfix) with ESMTP id 4131D1140199; Tue, 22 Apr 2025 13:04:16 -0400 (EDT) Received: from phl-mailfrontend-02 ([10.202.2.163]) by phl-compute-04.internal (MEProxy); Tue, 22 Apr 2025 13:04:16 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gutov.dev; h=cc :cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm1; t=1745341456; x=1745427856; bh=2sKMpIHgB6fe3QPz7R2Q8sd/LyL3ACPmuGC0YYbU5ns=; b= ZWJ08oGLJong5VuWU//oSKF7uD2Sta4fiEQeF6ljvLhYwo8psq5uSoEPFMYOWl1a AZGyifNrcqkoX2qm1VHQsBqxXwAv/XusQWNUIxvId4ambRZfMj02ea01sm7yOMp+ WpXcA9XamY0PVeRVtoPnHZfN+Y2wz3/pLlQbc+YXdD5j5NHBJkCVMhnD7Biv0mXo esAA+5ccjVptoAlWzQ/vZfAlUNpLRiNOFNK3iPNhj5xXws6p4RAvme80WYbDlfNN y5W1i8LcChfdN7h4UDEq6iYD0qr4EgvkoKaNbSlC5tynH981Ie7jsj7s+grsA6W/ +spYpTvOtmR6Rxdhv1DqXg== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm2; t=1745341456; x= 1745427856; bh=2sKMpIHgB6fe3QPz7R2Q8sd/LyL3ACPmuGC0YYbU5ns=; b=G hRnYfT6YmTOSXxMsRfmZFZNedn6trD78pZ/Un6xgZnX9ZSglDZUmlWiOmw/phdLB s71tN0OPDLyVOhaQMGC7XxXoSaL+6oKCJQVXgSUCLonw1pB76W71MXs87c+DMdj7 muzZdCy4KycUEEDGGzn2oZqVdQDRgtsxk5cQeVJw4BuPF1Hgp9wEcbp22sS7GVqp mZev8mkBFRvn2WVzfHI1DHaoSOyR3fwdBu4tM5Bhiac/uAj+Uzfkm/fKk9ZRCY6y gRUaCTW9aCWJuKG38y6A13ahRq7gBAUf2qHumZ/a8d1h9DbtPkcmrVDAWgUySA32 Jo6KDzp0FueCm+Y9hVQIw== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefvddrtddtgddvgeegvdekucetufdoteggodetrf dotffvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdggtfgfnhhsuhgsshgtrhhisggv pdfurfetoffkrfgpnffqhgenuceurghilhhouhhtmecufedttdenucesvcftvggtihhpih gvnhhtshculddquddttddmnecujfgurhepkfffgggfuffvvehfhfgjtgfgsehtjeertddt vdejnecuhfhrohhmpeffmhhithhrhicuifhuthhovhcuoegumhhithhrhiesghhuthhovh druggvvheqnecuggftrfgrthhtvghrnhepfeekheeuteeigeevledtjeefheefheehjeeh keeuhfeffeelveffleehfefhvdevnecuffhomhgrihhnpehgihhthhhusgdrtghomhenuc evlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpegumhhithhr hiesghhuthhovhdruggvvhdpnhgspghrtghpthhtohepvddpmhhouggvpehsmhhtphhouh htpdhrtghpthhtohepvghlihiisehgnhhurdhorhhgpdhrtghpthhtohepjeejleejgees uggvsggsuhhgshdrghhnuhdrohhrgh X-ME-Proxy: Feedback-ID: i07de48aa:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue, 22 Apr 2025 13:04:14 -0400 (EDT) Message-ID: Date: Tue, 22 Apr 2025 20:04:12 +0300 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird References: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> <86msc82ysw.fsf@gnu.org> Content-Language: en-US From: Dmitry Gutov In-Reply-To: <86msc82ysw.fsf@gnu.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) On 22/04/2025 14:58, Eli Zaretskii wrote: >> Date: Tue, 22 Apr 2025 00:51:30 +0300 >> From: Dmitry Gutov >> >> Here are some proposed updates, which create a new node for this backend >> and list some of the options that were until now not mentioned in the >> manual. >> >> Feedback welcome on the general structure (do we want the new node in >> that place?) and the phrasing of the new text as well. > > Thanks. > > This node should probably be the last in its parent node, not the > first one, because it describes a specific project backend while the > rest of the section describes backend-agnostic features. All right. > I'm also not sure why these 5 user options are deemed important enough > to be in the manual, while the other 14 defined in project.el aren't. These are the options for the backend, which this aims to document. Got a request to have 'project-vc-extra-root-markers' documented: https://github.com/buzztaiki/project-rootfile.el/issues/17#issuecomment-2816505984 Most of the other options added affect which files are contained in a project. The existing manual mentions project-vc-include-untracked already, and it seemed to make sense to add project-vc-ignores and project-vc-merge-submodules which also affect the fileset (and should be more popular than the former, IMO). > E.g., is project-vc-merge-submodules (which seems to be specific to > Git, but its name doesn't say so?) really important enough to be in > the manual? I don't really mind dropping this one, except for the fact that it's also among the options that affects the fileset. Being Git-specific seems unimportant (99% of all projects use Git), but being specific to submodules might make it too specialized, I don't know. >> +@node VC-Aware Project Backend > > Index entry leading to this node is missing here. Think about a > reader who wants to find this quickly without knowing the exact name > of the node. Any suggestions for what it should say? >> +This backend is used by default. > > This sentence confused me. What does it mean for a backend to be used > by default? This should be explained, I think, if we consider this > backend important enough to be described. Used out of the box. Without extra configuration necessary. Before any third-package uses the hook variable. Which of the explanations sounds better? >> +@defopt project-vc-include-untracked >> +``untracked'' files are considered to be part of the project. To change > ^^^^^^^^^^^ > Sentences should start with capital letters. > > Also, when you introduce new terminology, it is best to use @dfn > instead of literal quotes, and also have an indexing command for that > terminology. "Untracked" is a fairly common term to the VC subsystem and VC systems in general. It doesn't seem like it has a description in the manual, though. >> +Each element is either a base file name or a glob pattern for such. >> + >> +Example values: @samp{".dir-locals.el"}, @samp{"package.json"}, >> +@samp{"requirements.txt}, @samp{"*.gemspec"}. > > Since these are file names, it is better to use @file markup and lose > the quotes. Not exactly file names -- they are globs. The last one contains a wildcard, for example. Should @file still be used? > If you decide to install this, don't forget to update the @detailmenu > in emacs.texi. Thanks. From unknown Tue Jun 17 01:34:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#77974: Manual updates for the VC-aware project backend Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 23 Apr 2025 11:18:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 77974 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Dmitry Gutov Cc: 77974@debbugs.gnu.org Received: via spool by 77974-submit@debbugs.gnu.org id=B77974.17454070762238 (code B ref 77974); Wed, 23 Apr 2025 11:18:02 +0000 Received: (at 77974) by debbugs.gnu.org; 23 Apr 2025 11:17:56 +0000 Received: from localhost ([127.0.0.1]:54623 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u7Y71-0000a2-GV for submit@debbugs.gnu.org; Wed, 23 Apr 2025 07:17:56 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:57058) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u7Y6x-0000Yi-UA for 77974@debbugs.gnu.org; Wed, 23 Apr 2025 07:17:53 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1u7Y6r-0001vH-UA; Wed, 23 Apr 2025 07:17:45 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=jPFbVEm4jo+F/wLeladORzk6pX6+5VFNlxuWfIHiS+Y=; b=ZqGkcnr3CKh9 /iwNQ0iiyhN9FNZTJHj5BKKOd+KJZaPob4+cgAcX5SCieQflpkzsJAkdxS4xNKnXkkJOddAwKS5tj qpSGugPiF7W9IJMMQLyVrcxWXyoXbNu9fqXr+qnits+SXNcfK4LnzYziHnOwDqv6mPdcoO49uXrza wwfQfXhVzof0cxVxK/dkNXrxkXQoxgwE18A8WqRJ/4GxmPrdFoxZ7LCTKF/FmG1krz9fZd3Vkgc58 90Y/glstDUp/CfR9DqujmEJ9fykmnG8gAqIXo1pr0lTEAjKpPKuuKgN/dgdb9h6wfy407D4Rda/7J QwbfB+2sr8dK1kZ6RNQn2g==; Date: Wed, 23 Apr 2025 14:17:43 +0300 Message-Id: <86tt6f1608.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: (message from Dmitry Gutov on Tue, 22 Apr 2025 20:04:12 +0300) References: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> <86msc82ysw.fsf@gnu.org> X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Tue, 22 Apr 2025 20:04:12 +0300 > Cc: 77974@debbugs.gnu.org > From: Dmitry Gutov > > >> +@node VC-Aware Project Backend > > > > Index entry leading to this node is missing here. Think about a > > reader who wants to find this quickly without knowing the exact name > > of the node. > > Any suggestions for what it should say? Something simple and obvious. I'd start with @cindex VC-aware project backend @cindex project backend, VC-aware > >> +This backend is used by default. > > > > This sentence confused me. What does it mean for a backend to be used > > by default? This should be explained, I think, if we consider this > > backend important enough to be described. > > Used out of the box. Aren't other backends available out of the box? If not, I'd say This backend is part of Emacs and is enabled by default. (Other backend may need installation of add-on packages and their proper configuration.) > >> +@defopt project-vc-include-untracked > >> +``untracked'' files are considered to be part of the project. To change > > ^^^^^^^^^^^ > > Sentences should start with capital letters. > > > > Also, when you introduce new terminology, it is best to use @dfn > > instead of literal quotes, and also have an indexing command for that > > terminology. > > "Untracked" is a fairly common term to the VC subsystem and VC systems > in general. That's beside the point (you don't explain what it means, presumably because that is known well enough). The important part is that this is the first (or only) place where it is mentioned in the Emacs manual. > >> +Each element is either a base file name or a glob pattern for such. > >> + > >> +Example values: @samp{".dir-locals.el"}, @samp{"package.json"}, > >> +@samp{"requirements.txt}, @samp{"*.gemspec"}. > > > > Since these are file names, it is better to use @file markup and lose > > the quotes. > > Not exactly file names -- they are globs. The last one contains a > wildcard, for example. > > Should @file still be used? Yes. Glob patterns are file-name specifications, so @file is still the best markup. From unknown Tue Jun 17 01:34:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#77974: Manual updates for the VC-aware project backend Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 25 Apr 2025 00:28:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 77974 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Eli Zaretskii Cc: 77974@debbugs.gnu.org Received: via spool by 77974-submit@debbugs.gnu.org id=B77974.174554086225063 (code B ref 77974); Fri, 25 Apr 2025 00:28:01 +0000 Received: (at 77974) by debbugs.gnu.org; 25 Apr 2025 00:27:42 +0000 Received: from localhost ([127.0.0.1]:42961 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u86ur-0006W8-LM for submit@debbugs.gnu.org; Thu, 24 Apr 2025 20:27:42 -0400 Received: from fhigh-b7-smtp.messagingengine.com ([202.12.124.158]:52085) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u86uo-0006Vk-Tf for 77974@debbugs.gnu.org; Thu, 24 Apr 2025 20:27:39 -0400 Received: from phl-compute-05.internal (phl-compute-05.phl.internal [10.202.2.45]) by mailfhigh.stl.internal (Postfix) with ESMTP id 436A02540292; Thu, 24 Apr 2025 20:27:32 -0400 (EDT) Received: from phl-mailfrontend-02 ([10.202.2.163]) by phl-compute-05.internal (MEProxy); Thu, 24 Apr 2025 20:27:32 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gutov.dev; h=cc :cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm1; t=1745540852; x=1745627252; bh=7o3+6pLC2uqQbFyGUQK4dfp53uzn2drkNM7NmP38x2k=; b= KO66PpdsKTlIzkXd27h3fOJ5p+0w9vLZC4EXzBYt8Cce8F0USeiCWyRH+/uNLleI /Y3dQtQ/G9Ra3X6qMDd8vEWz7gR9EPlTJzU8qyUn85r99qBaVMzj8TT5XXnijdDd 5i+e7NlJQk45B/9yvMa8Yj6O39stik0FpcxvGuE9rhVem/cSIxjLLH/N0KqpHtls +8/+xHCek//ghuhF2W0Onq8mwRJ3V8P+WFT4n4rDZxsRQ2RVpsCUkK5w0sfflZV8 07QdtI9xB6YWjTul+WbENvIowiSBBl+IgGbhr+RmPxdoesPVxP7uvp+fBvCFzlIQ tADFxLyfWQ7KsTQ2aUhFDQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1745540852; x= 1745627252; bh=7o3+6pLC2uqQbFyGUQK4dfp53uzn2drkNM7NmP38x2k=; b=I Ing+BlzR+g2UC9WFyCgSnH6wNfkPYYi5vIfrvVqahbDRSpYxReauQxYn2ZsOtxDt Wl4ScK4ePb72MMnJIL4YBkNwErHK0ggYziHLmxVMFQcpe2UjSlMlrj6uQZri8hli ZADzhEXsCv8+/MFl4kgOYq63ApnV3uaxlmRC6QL6cGnKyGpSFlhRuqVpKNFiFhWY INCRCR6JKoivng+mq2zN3a7IqCblR8KQe73VETKf+Kr6WvSNAU8INIWa21ps5E3V 5v84SALXPVIFj9N0SLLne1nqrCJeEH2qtGeaEI8RwwaYIXEmFzCLQiNQCtFhn4KL MjDPRI9clMfAGSP9xODrQ== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefvddrtddtgddvhedtkeelucetufdoteggodetrf dotffvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdggtfgfnhhsuhgsshgtrhhisggv pdfurfetoffkrfgpnffqhgenuceurghilhhouhhtmecufedttdenucesvcftvggtihhpih gvnhhtshculddquddttddmnecujfgurhepkfffgggfuffvvehfhfgjtgfgsehtjeertddt vdejnecuhfhrohhmpeffmhhithhrhicuifhuthhovhcuoegumhhithhrhiesghhuthhovh druggvvheqnecuggftrfgrthhtvghrnhepteduleejgeehtefgheegjeekueehvdevieek ueeftddvtdevfefhvdevgedujeehnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrg hmpehmrghilhhfrhhomhepughmihhtrhihsehguhhtohhvrdguvghvpdhnsggprhgtphht thhopedvpdhmohguvgepshhmthhpohhuthdprhgtphhtthhopegvlhhiiiesghhnuhdroh hrghdprhgtphhtthhopeejjeeljeegseguvggssghughhsrdhgnhhurdhorhhg X-ME-Proxy: Feedback-ID: i07de48aa:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Thu, 24 Apr 2025 20:27:30 -0400 (EDT) Message-ID: Date: Fri, 25 Apr 2025 03:27:29 +0300 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird References: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> <86msc82ysw.fsf@gnu.org> <86tt6f1608.fsf@gnu.org> Content-Language: en-US From: Dmitry Gutov In-Reply-To: <86tt6f1608.fsf@gnu.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) On 23/04/2025 14:17, Eli Zaretskii wrote: >> Date: Tue, 22 Apr 2025 20:04:12 +0300 >> Cc: 77974@debbugs.gnu.org >> From: Dmitry Gutov >> >>>> +@node VC-Aware Project Backend >>> >>> Index entry leading to this node is missing here. Think about a >>> reader who wants to find this quickly without knowing the exact name >>> of the node. >> >> Any suggestions for what it should say? > > Something simple and obvious. I'd start with > > @cindex VC-aware project backend > @cindex project backend, VC-aware Very good. >>>> +This backend is used by default. >>> >>> This sentence confused me. What does it mean for a backend to be used >>> by default? This should be explained, I think, if we consider this >>> backend important enough to be described. >> >> Used out of the box. > > Aren't other backends available out of the box? We have EDE as well, which adds itself to project-find-functions, but with lower priority and only when the ede package is loaded. So... however you want to phrase it. > If not, I'd say > > This backend is part of Emacs and is enabled by default. (Other > backend may need installation of add-on packages and their proper > configuration.) "Installation of add-on packages and/or additional setup" perhaps would be more correct. After all some users create their own small backends (which isn't always advised, but still). >>>> +@defopt project-vc-include-untracked >>>> +``untracked'' files are considered to be part of the project. To change >>> ^^^^^^^^^^^ >>> Sentences should start with capital letters. >>> >>> Also, when you introduce new terminology, it is best to use @dfn >>> instead of literal quotes, and also have an indexing command for that >>> terminology. >> >> "Untracked" is a fairly common term to the VC subsystem and VC systems >> in general. > > That's beside the point (you don't explain what it means, presumably > because that is known well enough). The important part is that this > is the first (or only) place where it is mentioned in the Emacs > manual. Okay. Do we provide a definition inline? Or link to another node? Here's what Git says about it: Untracked files in Git are files that exist in your working directory but are not being tracked by Git, meaning they haven't been added to version control. >>> Since these are file names, it is better to use @file markup and lose >>> the quotes. >> >> Not exactly file names -- they are globs. The last one contains a >> wildcard, for example. >> >> Should @file still be used? > > Yes. Glob patterns are file-name specifications, so @file is still > the best markup. Great. From unknown Tue Jun 17 01:34:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#77974: Manual updates for the VC-aware project backend Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 25 Apr 2025 07:24:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 77974 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Dmitry Gutov Cc: 77974@debbugs.gnu.org Received: via spool by 77974-submit@debbugs.gnu.org id=B77974.174556582930291 (code B ref 77974); Fri, 25 Apr 2025 07:24:02 +0000 Received: (at 77974) by debbugs.gnu.org; 25 Apr 2025 07:23:49 +0000 Received: from localhost ([127.0.0.1]:46499 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u8DPZ-0007sV-9v for submit@debbugs.gnu.org; Fri, 25 Apr 2025 03:23:49 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:36872) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u8DPW-0007sD-5N for 77974@debbugs.gnu.org; Fri, 25 Apr 2025 03:23:46 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1u8DPQ-0001e3-MD; Fri, 25 Apr 2025 03:23:40 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=Va/0KMyZqMby6r6TP94ymELRxquvnnZqbg8CV1g1UN0=; b=B7OJkGCt4eN5 8WYQfgWDv9pZ5E2LbgdPr+D4dqnjg0fQYK/DDdYQ1S87+JTrC5lTnNjtyUc6VLnBLo1i1Bpfqt/Rc JMuPbjy6sMZo7FmS5rF1c8LZ8WcTOFG8uIW2wPFjwPa7vSNuo4pI97gp14EzOjeNBe1JtAPfXMlWG hHKSqDyDs3F+7HuVpi0UHXZ4ybd0cynpd8yboMk10EIaiB2UjuUsotQIecVeVm2WC+RJx0GMyvKA1 hLmfWzpPMLxjHNqe+LQD6qD9PWmvNbLzukgdTibWWl0ypMuOotDh7a3csFFymKi3ZE5Ep5DBchqg1 50J46qV37qJRePLawjqagg==; Date: Fri, 25 Apr 2025 10:23:25 +0300 Message-Id: <86a584yaaa.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: (message from Dmitry Gutov on Fri, 25 Apr 2025 03:27:29 +0300) References: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> <86msc82ysw.fsf@gnu.org> <86tt6f1608.fsf@gnu.org> X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Fri, 25 Apr 2025 03:27:29 +0300 > Cc: 77974@debbugs.gnu.org > From: Dmitry Gutov > > >>> Also, when you introduce new terminology, it is best to use @dfn > >>> instead of literal quotes, and also have an indexing command for that > >>> terminology. > >> > >> "Untracked" is a fairly common term to the VC subsystem and VC systems > >> in general. > > > > That's beside the point (you don't explain what it means, presumably > > because that is known well enough). The important part is that this > > is the first (or only) place where it is mentioned in the Emacs > > manual. > > Okay. Do we provide a definition inline? Or link to another node? Here's > what Git says about it: > > Untracked files in Git are files that exist in your working directory > but are not being tracked by Git, meaning they haven't been added to > version control. If you want to explain what "untracked" mean, I think in this case I'd go with a @footnote, and tell there what you quote from Git, but without mentioning Git (because I believe all VCSes handle untracked files the same). From unknown Tue Jun 17 01:34:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#77974: Manual updates for the VC-aware project backend Resent-From: Sean Whitton Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 27 Apr 2025 05:14:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 77974 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Dmitry Gutov Cc: 77974@debbugs.gnu.org Received: via spool by 77974-submit@debbugs.gnu.org id=B77974.174573079015931 (code B ref 77974); Sun, 27 Apr 2025 05:14:02 +0000 Received: (at 77974) by debbugs.gnu.org; 27 Apr 2025 05:13:10 +0000 Received: from localhost ([127.0.0.1]:37929 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u8uKE-00048s-2v for submit@debbugs.gnu.org; Sun, 27 Apr 2025 01:13:10 -0400 Received: from sendmail.purelymail.com ([34.202.193.197]:55170) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u8uKA-00048B-P6 for 77974@debbugs.gnu.org; Sun, 27 Apr 2025 01:13:08 -0400 DKIM-Signature: a=rsa-sha256; b=OeJ3WPrt/hcLVzsq4SRrQxm1c89W7wpIopqYukuk82JvPkrswFmPnN85yd8tI+E/6RGyOKqGsSfpK5/dlINzCnRo9Av8PlPCFqRYYWC7uci82xsFlnpkfUUumXgwJTeXSwJCNDZuSfpG3+CJ+IGKBhQpTB5+9TESQG0PXeclMZ+5NmlqBIg+PmJD0SsW/ObRKuU0OtH0a3xxMU6744BQHIDTxGtdP9SGN8zFAtfvSL1ooNo6kqLCdbGAQICHFkqJGQMqKfRGqRFzTYk7txjq+NzPCjd9MVvL85l/0hHZxsRj7VBUQ3ip0sY9BzVUXt0S+9Y3ea8qkwN6/1I+dLtLJg==; s=purelymail1; d=spwhitton.name; v=1; bh=gX7x+Jaj5PnepWvP2BaYzwgpCWlxJNxYgzxcsdTvJAE=; h=Received:Received:From:To:Subject:Date; DKIM-Signature: a=rsa-sha256; b=KDfzs1a6VfxH3+a6A0NWsyLpT11KMDMNg4EuyETLfrDLpB/+Z0SL/7tyKHPM7gjntBpDoLW2hO2dz2SMBV2Tz8vDkcVxWsq9uAc1y/BZtOYqDQxaMK6x95a6qy4lzB8fhmFqG+NNL68ABEZvF2HHOQLvrJOygp4897Uv0zu5yasSH0QJfjnzn2j2UBEXCXvRW7qBhi88VWKWzQPBTanjrikC8bsK6gZlU8TXZSGkbGAUHxlom+5f0gYPlpmiOG4O6dcvv6CqMZxxoPhfaScLSMNt6iQx0skheGlQNGiS6GqCAREr6AvNVEUAyi7/TbJCu3EqF/927vHHCihMxyWyIA==; s=purelymail1; d=purelymail.com; v=1; bh=gX7x+Jaj5PnepWvP2BaYzwgpCWlxJNxYgzxcsdTvJAE=; h=Feedback-ID:Received:Received:From:To:Subject:Date; Feedback-ID: 20115:3760:null:purelymail X-Pm-Original-To: 77974@debbugs.gnu.org Received: by smtp.purelymail.com (Purelymail SMTP) with ESMTPSA id 1824677886; (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384); Sun, 27 Apr 2025 05:12:53 +0000 (UTC) Received: by melete.silentflame.com (Postfix, from userid 1000) id 364147F3568; Sun, 27 Apr 2025 13:12:49 +0800 (CST) From: Sean Whitton In-Reply-To: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> References: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> Date: Sun, 27 Apr 2025 13:12:49 +0800 Message-ID: <87ldrmi3vy.fsf@melete.silentflame.com> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hello, Thanks for this. On Tue 22 Apr 2025 at 12:51am +03, Dmitry Gutov wrote: > @menu > +* VC-Aware Project Backend:: Default project backend. > * Project File Commands:: Commands for handling project files. > * Project Buffer Commands:: Commands for handling project buffers. > * Switching Projects:: Switching between projects. > * Managing Projects:: Managing the project list file. > @end menu I agree with Eli that it should probably go last, not just because the other parts are backend-agnostic, but also because it is probably less useful information to a new user than what comes before. > +@node VC-Aware Project Backend > + > +This backend is used by default. It determines the contents of the > +project based on the VCS repository's configuration (if any), excluding > +the ``ignored'' files from the output. I'd prefer to avoid the scare quotes around both 'ignored' and 'untracked' (I dislike scare quotes almost as much as Eli dislikes the passive voice ;)). I think you can just say ... excluding files the VCS has been configured to ignore from its output. > +It has some performance optimizations for listing the files with some of > +the popular VCS systems (currently Git and Mercurial). > + > +@defopt project-vc-include-untracked > +``untracked'' files are considered to be part of the project. To change > +that, you can customize this variable to nil. > +@end defopt We already have the "unregistered" state in VC. How about using that? By default, files which are neither registered nor ignored are considered part of this proejct. Customize this variable to nil to change that. ... possibly with a cross-reference to the definitions of the VC terms. (And maybe we should rename the variable?) -- Sean Whitton From unknown Tue Jun 17 01:34:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#77974: Manual updates for the VC-aware project backend Resent-From: Sean Whitton Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 27 Apr 2025 05:15:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 77974 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Dmitry Gutov Cc: 77974@debbugs.gnu.org Received: via spool by 77974-submit@debbugs.gnu.org id=B77974.174573090016168 (code B ref 77974); Sun, 27 Apr 2025 05:15:02 +0000 Received: (at 77974) by debbugs.gnu.org; 27 Apr 2025 05:15:00 +0000 Received: from localhost ([127.0.0.1]:37945 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u8uLz-0004Ch-MP for submit@debbugs.gnu.org; Sun, 27 Apr 2025 01:15:00 -0400 Received: from sendmail.purelymail.com ([34.202.193.197]:43162) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u8uLw-0004CO-U9 for 77974@debbugs.gnu.org; Sun, 27 Apr 2025 01:14:57 -0400 DKIM-Signature: a=rsa-sha256; b=Hi+FHUIbqaZVsB2IwfKceSUFbkCrfxs8hmfIpA6hVKcOjELgQXZ2I+v+MslvMZLpyTfzoGN4ytCpV9I8b8fEMhOCZthy2E6GJH5r5OUyUKLZGesbXJVGqvp9BdPvuFRQ+ewykWNFO9BiEs/1CwgNMomCydnkYuanhAJKhLUrxpoQv5jZIIShSSgYAP73wINXQVEpfwiaxwiDmFpBj861853RBWXFIT63myV9FvXC2NjgKgI3LVrZLLCbtlCX29QDmBELYgvkUm3stvJVyL8Np8Jamrzn3+kiUQq0sfyGONI1jTAvhMftPoKZt//K3jJg6G5QAq8aR/U2q6FK2fUihw==; s=purelymail1; d=spwhitton.name; v=1; bh=1MdSZUXrHMO+RJ5aRayVo28k3uWW5cZ/Jr8XaBfmoAw=; h=Received:Received:From:To:Subject:Date; DKIM-Signature: a=rsa-sha256; b=Rzdbyx40YomYGFATa6Y1s8UB9v+0tvHtEXXnrMnG1Wd1rML+HYUbWYe6qTlnRHKzn2JbvfPaMdX7Os5Jsf1TwUtuCc9qCBjs1aIWH18mDNfj0JiKti8TqfR5DoLkpwVYdCOxYG2aU+Q8OliqJj3rBAtUQi3BlGVpOxvE28h5IRzr3kLkf0A+4NiT/ls/vlYHC3Crkca3nUD8Os35/cdyGAAb+vv8vS+Yt3RFy2jLJgKFwRa6O5B8EpV92jf7hM/Q0rVK4nHINVsTP3tGB+aWkyiZQeXEOLmeEb3tKG8V5mJajnR9aaRlM5p9c3AK1KOYZbmoDuKr1W3nRUNRRQUnfQ==; s=purelymail1; d=purelymail.com; v=1; bh=1MdSZUXrHMO+RJ5aRayVo28k3uWW5cZ/Jr8XaBfmoAw=; h=Feedback-ID:Received:Received:From:To:Subject:Date; Feedback-ID: 20115:3760:null:purelymail X-Pm-Original-To: 77974@debbugs.gnu.org Received: by smtp.purelymail.com (Purelymail SMTP) with ESMTPSA id -540445387; (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384); Sun, 27 Apr 2025 05:14:50 +0000 (UTC) Received: by melete.silentflame.com (Postfix, from userid 1000) id A26117F3568; Sun, 27 Apr 2025 13:14:41 +0800 (CST) From: Sean Whitton In-Reply-To: <87ldrmi3vy.fsf@melete.silentflame.com> References: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> <87ldrmi3vy.fsf@melete.silentflame.com> Date: Sun, 27 Apr 2025 13:14:41 +0800 Message-ID: <87frhui3su.fsf@melete.silentflame.com> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hello, On Sun 27 Apr 2025 at 01:12pm +08, Sean Whitton wrote: > I think you can just say > > ... excluding files the VCS has been configured to ignore from its > output. I meant ... excluding files the VCS has been configured to ignore. -- Sean Whitton From unknown Tue Jun 17 01:34:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#77974: Manual updates for the VC-aware project backend Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 27 Apr 2025 06:31:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 77974 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Sean Whitton Cc: dmitry@gutov.dev, 77974@debbugs.gnu.org Received: via spool by 77974-submit@debbugs.gnu.org id=B77974.17457354051823 (code B ref 77974); Sun, 27 Apr 2025 06:31:02 +0000 Received: (at 77974) by debbugs.gnu.org; 27 Apr 2025 06:30:05 +0000 Received: from localhost ([127.0.0.1]:38288 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u8vWf-0000T7-2x for submit@debbugs.gnu.org; Sun, 27 Apr 2025 02:30:05 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:57976) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u8vWc-0000RZ-Er for 77974@debbugs.gnu.org; Sun, 27 Apr 2025 02:30:03 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1u8vWU-0000Re-WB; Sun, 27 Apr 2025 02:29:55 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=NyxnJFFb6CEdMeZPtiswjC8aucodJcM0OxADQE8e/XU=; b=XiRbMkGpAKEL ISDRNEK9GAWUFT+Tu5wx7mXYQwT2QCl/YKEZoIvP7cFvjC4HjRct4xjOnfzEUc9JYuQPBJkcP7Q2+ TS/YPLYfLQLyz3XMwAYcRnb2e4gs2EDd6Exbrq2mPrmPZyQ/yv7Kq4Ce/4dYGHilU48MMcfTcnN1H HenLYt5ivauihfsOzRFtOn+xt9RrBALo+GLvzL+gMWT0RmUDz2IezK0PQi/wTCSkSk2igMQ+x8xgL eeKqDv7xMivNGvHVct9i+1XbTvIaK/xbIdRwsTysYxj+5paE+5raNvBZYYvM0JasEFPP6t8QwxMWI ivhh3fQQZiKvbXYzQT2stw==; Date: Sun, 27 Apr 2025 09:29:50 +0300 Message-Id: <86ecxeruap.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: <87ldrmi3vy.fsf@melete.silentflame.com> (message from Sean Whitton on Sun, 27 Apr 2025 13:12:49 +0800) References: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> <87ldrmi3vy.fsf@melete.silentflame.com> X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Cc: 77974@debbugs.gnu.org > From: Sean Whitton > Date: Sun, 27 Apr 2025 13:12:49 +0800 > > > +@node VC-Aware Project Backend > > + > > +This backend is used by default. It determines the contents of the > > +project based on the VCS repository's configuration (if any), excluding > > +the ``ignored'' files from the output. > > I'd prefer to avoid the scare quotes around both 'ignored' and > 'untracked' (I dislike scare quotes almost as much as Eli dislikes the > passive voice ;)). Then please get used to them: that's how we introduce terminology in Texinfo. (In HTML and printed output, there's no quotes; instead, the term has slanted typeface. But that cannot be used in Info output.) There's nothing scary about introducing new terminology. > I think you can just say > > ... excluding files the VCS has been configured to ignore from its > output. I see no reason to avoid accepted terminology, because that makes the text less clear and potentially more confusing. Anyone who uses a VCS knows what are ignored and untracked files; by contrast, "files the VCS has been configured to ignore from its output" is both wordier and less definitive. From unknown Tue Jun 17 01:34:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#77974: Manual updates for the VC-aware project backend Resent-From: Sean Whitton Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 27 Apr 2025 07:49:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 77974 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Eli Zaretskii Cc: dmitry@gutov.dev, 77974@debbugs.gnu.org Received: via spool by 77974-submit@debbugs.gnu.org id=B77974.174574013021342 (code B ref 77974); Sun, 27 Apr 2025 07:49:02 +0000 Received: (at 77974) by debbugs.gnu.org; 27 Apr 2025 07:48:50 +0000 Received: from localhost ([127.0.0.1]:38647 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u8wkr-0005YA-NH for submit@debbugs.gnu.org; Sun, 27 Apr 2025 03:48:50 -0400 Received: from sendmail.purelymail.com ([34.202.193.197]:55810) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u8wko-0005Xh-3i for 77974@debbugs.gnu.org; Sun, 27 Apr 2025 03:48:47 -0400 DKIM-Signature: a=rsa-sha256; b=RfHsmU/RmDUJsZIMT90gtk3GTZ3LHpQIjOncQmFlcSaCD8rZtwXijrkjUu7oDtC8SneGo4ru4VCUO2HX4Fsq6qMXFXrbyl/oms7wfL2rsUxi3FyoW35nq99OseKXxcLaVr4qI1Xj17b+4+fJ9i0Dz44TE4QyMZwmw/VDnYc2TCaN1kx97boA8ztOkQzYiatFEkVu3fEdGKMfr+xZUnhXdDeCLZoA2xlX1XcZXZeM3cdInzswsbs/5IqFbM50yulOI/ctr5YplMoTXMSwEbIx160yTxeBAVycUW6goa4dvJfn0fAFVMUxy6tHYuZTBZWHPGzAgUv8LkdN2CljfmOWGQ==; s=purelymail1; d=spwhitton.name; v=1; bh=sg+53A4lZXWC33uGNnsYGJ18BTw/tjWfDLH1AGZN1po=; h=Received:Received:From:To:Subject:Date; DKIM-Signature: a=rsa-sha256; b=lL1SpvQ6dXnbfCvvMaiUl2naLtbE7ZjWFWozIgGCTRnJdd0Dyp1XbM4qtZ9OwaRx0OfqRGwNpv7sUA8YOTKg5AWEyOiTMKn8ggbyOjuNZzH78tmz9FVXNkYwio4XPsOvnGDQIJT/BoRMbP8sTEMJUqT/7Ypj8KdZKujRlPs0sj9QaqjS3atyh7MC/cdyeC7KCJ2mur/7bGv1ATrURctSPShiF4hZCBuqyAFawhyLNdK3sdsNC4HbQzRAHkf4htDcXPAlhh5Gf5jFQpbvVzoiZsJJd+RsWhXRXux/hQjvbx03VqNwgV3uXO4d6wdsw+cH9p/WLopE02ZrxN/hpRFrcA==; s=purelymail1; d=purelymail.com; v=1; bh=sg+53A4lZXWC33uGNnsYGJ18BTw/tjWfDLH1AGZN1po=; h=Feedback-ID:Received:Received:From:To:Subject:Date; Feedback-ID: 20115:3760:null:purelymail X-Pm-Original-To: 77974@debbugs.gnu.org Received: by smtp.purelymail.com (Purelymail SMTP) with ESMTPSA id -836179881; (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384); Sun, 27 Apr 2025 07:48:38 +0000 (UTC) Received: by melete.silentflame.com (Postfix, from userid 1000) id C52EB7F3567; Sun, 27 Apr 2025 15:48:32 +0800 (CST) From: Sean Whitton In-Reply-To: <86ecxeruap.fsf@gnu.org> References: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> <87ldrmi3vy.fsf@melete.silentflame.com> <86ecxeruap.fsf@gnu.org> Date: Sun, 27 Apr 2025 15:48:32 +0800 Message-ID: <87bjsihwof.fsf@melete.silentflame.com> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hello, On Sun 27 Apr 2025 at 09:29am +03, Eli Zaretskii wrote: > Then please get used to them: that's how we introduce terminology in > Texinfo. (In HTML and printed output, there's no quotes; instead, the > term has slanted typeface. But that cannot be used in Info output.) TIL. Thanks. They are not scare quotes if they are replaced with slanted text. It can be used in *Info* on graphical frames just like how Gnus already displays italics sometimes; I will see about enabling that for Info too. >> I think you can just say >> >> ... excluding files the VCS has been configured to ignore from its >> output. > > I see no reason to avoid accepted terminology, because that makes the > text less clear and potentially more confusing. Anyone who uses a VCS > knows what are ignored and untracked files; by contrast, "files the > VCS has been configured to ignore from its output" is both wordier and > less definitive. "files the VCS has been configured to ignore", not "files the VCS has been configured to ignore from its output", to be clear. I was just thinking that an untracked file is one the VCS is ignoring, in a sense, but it has not been configured to ignore. If we don't think we are going to confuse anyone by using the VC terms, that's fine with me. -- Sean Whitton From unknown Tue Jun 17 01:34:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#77974: Manual updates for the VC-aware project backend Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 27 Apr 2025 22:40:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 77974 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Sean Whitton Cc: 77974@debbugs.gnu.org Received: via spool by 77974-submit@debbugs.gnu.org id=B77974.17457935586999 (code B ref 77974); Sun, 27 Apr 2025 22:40:03 +0000 Received: (at 77974) by debbugs.gnu.org; 27 Apr 2025 22:39:18 +0000 Received: from localhost ([127.0.0.1]:45705 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u9AeZ-0001ob-PS for submit@debbugs.gnu.org; Sun, 27 Apr 2025 18:39:17 -0400 Received: from fout-b3-smtp.messagingengine.com ([202.12.124.146]:39757) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u9AeU-0001nW-KO for 77974@debbugs.gnu.org; Sun, 27 Apr 2025 18:39:12 -0400 Received: from phl-compute-11.internal (phl-compute-11.phl.internal [10.202.2.51]) by mailfout.stl.internal (Postfix) with ESMTP id 50901114017B; Sun, 27 Apr 2025 18:39:04 -0400 (EDT) Received: from phl-mailfrontend-02 ([10.202.2.163]) by phl-compute-11.internal (MEProxy); Sun, 27 Apr 2025 18:39:04 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gutov.dev; h=cc :cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm1; t=1745793544; x=1745879944; bh=bWcaauu3bVqz9lQH94rt1IcunR/phPGrYl6+AKTOWIY=; b= IwisQf2jyKSAJr1qSslBcTU8eISF67W/6a17d5h5po9OdZtNKtHQQ+3I0LoJvpRF LaFuTwNQirFuvdOPa1m28EaE7JAUOoUP82UstAIFuqPKnYyYyBfSDyPeJWNrtloe S8oUvijnPMsAeese3Y3D3bRb8ZewhzfO8SW+0kDUAktYl8Jl3YP+yQzvIkDpWkTj VmL9FCX04E46yjgSstEJ098JvEZeyXVrxWimqYmufzBZnhadV8X7YEQFC7GfDz7o Ik0VaO7uuaw6xdxPLwKxMqnSnxoioRZgRLkaY2qalarUcZtobzwb1LcX5y9B4hor qj4ojge4pxvQe1FBDwjv3Q== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1745793544; x= 1745879944; bh=bWcaauu3bVqz9lQH94rt1IcunR/phPGrYl6+AKTOWIY=; b=D QNl4lFrDUZ3enqYZOAKC4Uxv4/a46ngLB2sGluYoUF6sEOrEm3tgxMHzpdVYYDht rw07U7JjS9MV+p/bcUlyvx3L7TNDWWTyLxvqMXfBnl3/1JFah8Cv9rOlXMTNzwka I1AGbnI+VkTfsDusKbe3TW82oYXN4z4LugaEhwzVDWmIcnQlhVFsgNG4iLa9juHN 9DI+7JvJDiHvSCcXQNlvD5iWO3fQDQXfIt1DSMo5vb33+UdBpiJ0CiNDEuZcM8pX bi0cb8gsxmQzx4ZUp2wU9CMHt4HDFBMQpNaZAN1qOKsNAaDcmmDIVAuROKcWexpn Up+SyWLMjSLiqqpqB6YHw== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefvddrtddtgddvheelvdelucetufdoteggodetrf dotffvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdggtfgfnhhsuhgsshgtrhhisggv pdfurfetoffkrfgpnffqhgenuceurghilhhouhhtmecufedttdenucesvcftvggtihhpih gvnhhtshculddquddttddmnecujfgurhepkfffgggfuffvvehfhfgjtgfgsehtjeertddt vdejnecuhfhrohhmpeffmhhithhrhicuifhuthhovhcuoegumhhithhrhiesghhuthhovh druggvvheqnecuggftrfgrthhtvghrnhepteduleejgeehtefgheegjeekueehvdevieek ueeftddvtdevfefhvdevgedujeehnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrg hmpehmrghilhhfrhhomhepughmihhtrhihsehguhhtohhvrdguvghvpdhnsggprhgtphht thhopedvpdhmohguvgepshhmthhpohhuthdprhgtphhtthhopehsphifhhhithhtohhnse hsphifhhhithhtohhnrdhnrghmvgdprhgtphhtthhopeejjeeljeegseguvggssghughhs rdhgnhhurdhorhhg X-ME-Proxy: Feedback-ID: i07de48aa:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sun, 27 Apr 2025 18:39:02 -0400 (EDT) Message-ID: Date: Mon, 28 Apr 2025 01:39:00 +0300 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird References: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> <87ldrmi3vy.fsf@melete.silentflame.com> Content-Language: en-US From: Dmitry Gutov In-Reply-To: <87ldrmi3vy.fsf@melete.silentflame.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) Hi! On 27/04/2025 08:12, Sean Whitton wrote: > On Tue 22 Apr 2025 at 12:51am +03, Dmitry Gutov wrote: > >> @menu >> +* VC-Aware Project Backend:: Default project backend. >> * Project File Commands:: Commands for handling project files. >> * Project Buffer Commands:: Commands for handling project buffers. >> * Switching Projects:: Switching between projects. >> * Managing Projects:: Managing the project list file. >> @end menu > > I agree with Eli that it should probably go last, not just because the > other parts are backend-agnostic, but also because it is probably less > useful information to a new user than what comes before. This makes sense to me indeed, even though the backend itself will probably be relevant for >90% of the users who read that text. >> +It has some performance optimizations for listing the files with some of >> +the popular VCS systems (currently Git and Mercurial). >> + >> +@defopt project-vc-include-untracked >> +``untracked'' files are considered to be part of the project. To change >> +that, you can customize this variable to nil. >> +@end defopt > > We already have the "unregistered" state in VC. How about using that? > > By default, files which are neither registered nor ignored are > considered part of this proejct. Customize this variable to nil to > change that. "Neither registered nor ignored" sounds like the definition for "unregistered", actually. Sounds good to me as a phrasing (might even be more accurate than the Git definition I quoted previously). > ... possibly with a cross-reference to the definitions of the VC terms. If there is a node to reference, happy to. > (And maybe we should rename the variable?) Doesn't seem worth the hassle for us and existing users, TBH. From unknown Tue Jun 17 01:34:41 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Dmitry Gutov Subject: bug#77974: closed (Re: bug#77974: Manual updates for the VC-aware project backend) Message-ID: References: <4588b4df-528c-4b02-9366-f194689348e1@gutov.dev> <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> X-Gnu-PR-Message: they-closed 77974 X-Gnu-PR-Package: emacs X-Gnu-PR-Keywords: patch Reply-To: 77974@debbugs.gnu.org Date: Sun, 27 Apr 2025 22:54:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1745794442-10812-1" This is a multi-part message in MIME format... ------------=_1745794442-10812-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #77974: Manual updates for the VC-aware project backend which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 77974@debbugs.gnu.org. --=20 77974: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D77974 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1745794442-10812-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 77974-done) by debbugs.gnu.org; 27 Apr 2025 22:53:47 +0000 Received: from localhost ([127.0.0.1]:45794 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u9Asc-0002np-CR for submit@debbugs.gnu.org; Sun, 27 Apr 2025 18:53:46 -0400 Received: from fhigh-b2-smtp.messagingengine.com ([202.12.124.153]:59857) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u9AsW-0002nI-IH for 77974-done@debbugs.gnu.org; Sun, 27 Apr 2025 18:53:41 -0400 Received: from phl-compute-11.internal (phl-compute-11.phl.internal [10.202.2.51]) by mailfhigh.stl.internal (Postfix) with ESMTP id 5D60D25401B0; Sun, 27 Apr 2025 18:53:34 -0400 (EDT) Received: from phl-mailfrontend-02 ([10.202.2.163]) by phl-compute-11.internal (MEProxy); Sun, 27 Apr 2025 18:53:34 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gutov.dev; h=cc :cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm1; t=1745794414; x=1745880814; bh=KWbo0PzeAvbgKjmeSCFxT9XOLHfy/Erd4mPd1ewlVbg=; b= fVUmXEryTbFYEGGrpaj4Rway4ztjcSXKja3zm9gKj+9ONfcDQRMu0gP5n0hz7Rqq qQSNjvVQ3AE3jODi8lRoH4OcPwLlA42gu3B6Gp1jda1T2kMqFTMKVMPYOJXFbOIJ z1Vc+8pu8sCz8MPHV8gDA0SQCK3VLuXjl4nPAcSlpyC2EcT/2a/GPYMXoQuO8NsC +UleEH6IFOzQXZvZ/at5o7dUUUemIHdX/FDd2bi8tJkYJSTe9BLbY643ceTT3tr4 Za6/vUgTCLOZXePlaxwnTU6rP1jo6AGcbK6VTNRDdxYUKnD7AkT0e2v4+cCsntPz dgvuIspCYWHUDI7xuZl0EA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1745794414; x= 1745880814; bh=KWbo0PzeAvbgKjmeSCFxT9XOLHfy/Erd4mPd1ewlVbg=; b=I SU6GFN2rfi0buojlvIRsrQK95FRCpvuyMFbN4joVaImNaphtwqtapoEsUAloqOJx YKJ0jpYvy+Srii+6J+P7khNTUeFARFQvn2+TT+GD/MNxsdcCKaLndUHwve3fU2UC CTEn9ztZ5SKdjHE+X03Zmr9KyxeK6qfP4O4PQFFd5m1r/rJeOjYOoR2bVm+jOe6R UgZtCF5wATvETIOJM/F1IxwlUdI0HX+UDVJI9LCjIMGfViQrctiY64pwiFGS6zPL cLQKWv8Ar4vmP+qWVahzjot6LahBPlgmFs3AeaATQ9UyASslh0lu0k6KVfYOrf2D gAAHZnF6L6NOiP97ar1/Q== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefvddrtddtgddvheelfedvucetufdoteggodetrf dotffvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdggtfgfnhhsuhgsshgtrhhisggv pdfurfetoffkrfgpnffqhgenuceurghilhhouhhtmecufedttdenucesvcftvggtihhpih gvnhhtshculddquddttddmnecujfgurhepkfffgggfuffvvehfhfgjtgfgsehtjeertddt vdejnecuhfhrohhmpeffmhhithhrhicuifhuthhovhcuoegumhhithhrhiesghhuthhovh druggvvheqnecuggftrfgrthhtvghrnhepteduleejgeehtefgheegjeekueehvdevieek ueeftddvtdevfefhvdevgedujeehnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrg hmpehmrghilhhfrhhomhepughmihhtrhihsehguhhtohhvrdguvghvpdhnsggprhgtphht thhopedvpdhmohguvgepshhmthhpohhuthdprhgtphhtthhopegvlhhiiiesghhnuhdroh hrghdprhgtphhtthhopeejjeeljeegqdguohhnvgesuggvsggsuhhgshdrghhnuhdrohhr gh X-ME-Proxy: Feedback-ID: i07de48aa:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sun, 27 Apr 2025 18:53:32 -0400 (EDT) Message-ID: <4588b4df-528c-4b02-9366-f194689348e1@gutov.dev> Date: Mon, 28 Apr 2025 01:53:31 +0300 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: bug#77974: Manual updates for the VC-aware project backend To: Eli Zaretskii References: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> <86msc82ysw.fsf@gnu.org> <86tt6f1608.fsf@gnu.org> <86a584yaaa.fsf@gnu.org> Content-Language: en-US From: Dmitry Gutov In-Reply-To: <86a584yaaa.fsf@gnu.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -1.7 (-) X-Debbugs-Envelope-To: 77974-done Cc: 77974-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.7 (--) Version: 31.1 On 25/04/2025 10:23, Eli Zaretskii wrote: >> Date: Fri, 25 Apr 2025 03:27:29 +0300 >> Cc:77974@debbugs.gnu.org >> From: Dmitry Gutov >> >>>>> Also, when you introduce new terminology, it is best to use @dfn >>>>> instead of literal quotes, and also have an indexing command for that >>>>> terminology. >>>> "Untracked" is a fairly common term to the VC subsystem and VC systems >>>> in general. >>> That's beside the point (you don't explain what it means, presumably >>> because that is known well enough). The important part is that this >>> is the first (or only) place where it is mentioned in the Emacs >>> manual. >> Okay. Do we provide a definition inline? Or link to another node? Here's >> what Git says about it: >> >> Untracked files in Git are files that exist in your working directory >> but are not being tracked by Git, meaning they haven't been added to >> version control. > If you want to explain what "untracked" mean, I think in this case I'd > go with a @footnote, and tell there what you quote from Git, but > without mentioning Git (because I believe all VCSes handle untracked > files the same). Thank you, though it seems Sean's suggestion helped avoid using the footnote in that paragraph. Other than that, pushed the patch in revision 568a4894a8d7cc61. I think it contains all the other improvements, but LMK is anything is amiss. ------------=_1745794442-10812-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 21 Apr 2025 21:51:50 +0000 Received: from localhost ([127.0.0.1]:40014 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u6z3N-0001fW-Gy for submit@debbugs.gnu.org; Mon, 21 Apr 2025 17:51:50 -0400 Received: from lists.gnu.org ([2001:470:142::17]:32876) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u6z3J-0001fF-7r for submit@debbugs.gnu.org; Mon, 21 Apr 2025 17:51:46 -0400 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 1u6z3D-00017n-EU for bug-gnu-emacs@gnu.org; Mon, 21 Apr 2025 17:51:39 -0400 Received: from fout-a3-smtp.messagingengine.com ([103.168.172.146]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1u6z3A-0002TX-NQ for bug-gnu-emacs@gnu.org; Mon, 21 Apr 2025 17:51:39 -0400 Received: from phl-compute-04.internal (phl-compute-04.phl.internal [10.202.2.44]) by mailfout.phl.internal (Postfix) with ESMTP id D51051380185 for ; Mon, 21 Apr 2025 17:51:33 -0400 (EDT) Received: from phl-mailfrontend-02 ([10.202.2.163]) by phl-compute-04.internal (MEProxy); Mon, 21 Apr 2025 17:51:33 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gutov.dev; h=cc :content-type:content-type:date:date:from:from:in-reply-to :message-id:mime-version:reply-to:subject:subject:to:to; s=fm1; t=1745272293; x=1745358693; bh=L4bVkhZSBggv3d8j5suF16iNMg0UqznH 6gPRZs4UR8s=; b=QZMzNvmeqzl7ktexcDVG5sRkjWJzbWw4WBOwkj63XLYB2fsg 6jVImRFYws4tPP+V5OQzeb2+nhUT7nLAXLAVAqKSYf2dqQrUBcgTGuD3KQcTKqZM 4PpE/YqHWTFECNqfp+D5UTvaEUF7EScrs8xxMiKBlpCiIV/536uLLZtN7pzE8UoF goBO+3ye7POHLqhWoThBAFnEznb4H4MQUxXgnLmehdSAL77CiRB2qMtZ1TkKzga5 OZQiDV6fraY6GCnbZWHj0BSuxLDt+Y/8PBPWcIbgXJ4tewH7lPX3YsVRrPLgPM1c qRLd89nX6wkDAZZeZvUb1N4AaVxz/vOWKSIADA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:content-type:date:date :feedback-id:feedback-id:from:from:in-reply-to:message-id :mime-version:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm2; t=1745272293; x= 1745358693; bh=L4bVkhZSBggv3d8j5suF16iNMg0UqznH6gPRZs4UR8s=; b=h RPUeuTL+1Eu040tqH+p8vfl6tiCANGbSLIV6vaU1fZJi2WsOO2QXvvasxYujhqC5 zWoY0XtB2UntCSteqjstnnDCc6SGqGWHkMaN61r3XzrDoOZ8G2muyTRNr33vqSrg ZWvDugmeuW7qoUD3G1pK4Bc0QTUBEGOdB/r1egAmySQCUke3ND8ztnVtmnu/ptH2 8MygpQoHrWUkKMNk+MNnyP+Y07F0W9uWyFAQ8CIoRO5WlE42QAXeqa8nDvYL7wxE gRE+xJdYevxZvH/SbT3kSjpu5fRPL+7lM21Xh680OtXpm94Mn4hcAahXqDssyWWf sNfAP4rIwGWqVMTqX/kRQ== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefvddrtddtgddvgeduleejucetufdoteggodetrf dotffvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdggtfgfnhhsuhgsshgtrhhisggv pdfurfetoffkrfgpnffqhgenuceurghilhhouhhtmecufedttdenucenucfjughrpegtkf ffgggfvffhufesmhdtreertddvjeenucfhrhhomhepffhmihhtrhihucfiuhhtohhvuceo ughmihhtrhihsehguhhtohhvrdguvghvqeenucggtffrrghtthgvrhhnpeehvdffheeige fftdelgfeugfelgfduueehfeeljeduueekieetiefhhefhheeuheenucevlhhushhtvghr ufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpegumhhithhrhiesghhuthhovh druggvvhdpnhgspghrtghpthhtohepuddpmhhouggvpehsmhhtphhouhhtpdhrtghpthht ohepsghughdqghhnuhdqvghmrggtshesghhnuhdrohhrgh X-ME-Proxy: Feedback-ID: i07de48aa:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Mon, 21 Apr 2025 17:51:33 -0400 (EDT) Content-Type: multipart/mixed; boundary="------------5Awgzls6RR1nHkYiefXMKJ8r" Message-ID: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> Date: Tue, 22 Apr 2025 00:51:30 +0300 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Content-Language: en-US To: bug-gnu-emacs@gnu.org From: Dmitry Gutov Subject: Manual updates for the VC-aware project backend Received-SPF: pass client-ip=103.168.172.146; envelope-from=dmitry@gutov.dev; helo=fout-a3-smtp.messagingengine.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_H2=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 0.7 (/) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.3 (/) This is a multi-part message in MIME format. --------------5Awgzls6RR1nHkYiefXMKJ8r Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Tags: patch Here are some proposed updates, which create a new node for this backend and list some of the options that were until now not mentioned in the manual. Feedback welcome on the general structure (do we want the new node in that place?) and the phrasing of the new text as well. --------------5Awgzls6RR1nHkYiefXMKJ8r Content-Type: text/x-patch; charset=UTF-8; name="project-vc-manual-updates.diff" Content-Disposition: attachment; filename="project-vc-manual-updates.diff" Content-Transfer-Encoding: base64 ZGlmZiAtLWdpdCBhL2RvYy9lbWFjcy9tYWludGFpbmluZy50ZXhpIGIvZG9jL2VtYWNzL21h aW50YWluaW5nLnRleGkKaW5kZXggYzc2MWRjMzNjODYuLmY2YzBjZDcxZGM0IDEwMDY0NAot LS0gYS9kb2MvZW1hY3MvbWFpbnRhaW5pbmcudGV4aQorKysgYi9kb2MvZW1hY3MvbWFpbnRh aW5pbmcudGV4aQpAQCAtMTc4MiwyMCArMTc4MiwxOCBAQCBQcm9qZWN0cwogYSBoaWVyYXJj aHkgb2YgZGlyZWN0b3JpZXM7IHRoZSB0b3AtbGV2ZWwgZGlyZWN0b3J5IG9mIHRoZSBoaWVy YXJjaHkKIGlzIGtub3duIGFzIHRoZSBAZGZue3Byb2plY3Qgcm9vdH0uCiAKLUBjaW5kZXgg cHJvamVjdCBiYWNrLWVuZAorQGNpbmRleCBwcm9qZWN0IGJhY2tlbmQKICAgV2hldGhlciBh IGdpdmVuIGRpcmVjdG9yeSBpcyBhIHJvb3Qgb2Ygc29tZSBwcm9qZWN0IGlzIGRldGVybWlu ZWQgYnkKLXRoZSBwcm9qZWN0LXNwZWNpZmljIGluZnJhc3RydWN0dXJlLCBrbm93biBhcyBA ZGZue3Byb2plY3QgYmFjay1lbmR9LgotRW1hY3MgY3VycmVudGx5IHN1cHBvcnRzIHR3byBz dWNoIGJhY2stZW5kczogVkMtYXdhcmUgKEBweHJlZntWZXJzaW9uCit0aGUgcHJvamVjdC1z cGVjaWZpYyBpbmZyYXN0cnVjdHVyZSwga25vd24gYXMgQGRmbntwcm9qZWN0IGJhY2tlbmR9 LgorRW1hY3MgY3VycmVudGx5IHN1cHBvcnRzIHR3byBzdWNoIGJhY2tlbmRzOiBWQy1hd2Fy ZSAoQHB4cmVme1ZlcnNpb24KIENvbnRyb2x9KSwgd2hlcmVieSBhIFZDUyByZXBvc2l0b3J5 IGlzIGNvbnNpZGVyZWQgYSBwcm9qZWN0OyBhbmQgRURFCiAoQHB4cmVme0VERX0pLiAgVGhp cyBpcyBleHBlY3RlZCB0byBiZSBleHRlbmRlZCBpbiB0aGUgZnV0dXJlIHRvCiBzdXBwb3J0 IGFkZGl0aW9uYWwgdHlwZXMgb2YgcHJvamVjdHMuCiAKICAgV2hpY2ggZmlsZXMgZG8gb3Ig ZG9uJ3QgYmVsb25nIHRvIGEgcHJvamVjdCBpcyBhbHNvIGRldGVybWluZWQgYnkKLXRoZSBw cm9qZWN0IGJhY2stZW5kLiAgRm9yIGV4YW1wbGUsIHRoZSBWQy1hd2FyZSBiYWNrLWVuZCBk b2Vzbid0Cit0aGUgcHJvamVjdCBiYWNrZW5kLiAgRm9yIGV4YW1wbGUsIHRoZSBWQy1hd2Fy ZSBiYWNrZW5kIGRvZXNuJ3QKIGNvbnNpZGVyIGBgaWdub3JlZCcnIGZpbGVzIChAcHhyZWZ7 VkMgSWdub3JlfSkgdG8gYmUgcGFydCBvZiB0aGUKLXByb2plY3QuICBBbHNvLCB0aGUgVkMt YXdhcmUgUHJvamVjdCBiYWNrLWVuZCBjb25zaWRlcnMgYGB1bnRyYWNrZWQnJwotZmlsZXMg YnkgZGVmYXVsdC4gIFRoYXQgYmVoYXZpb3IgaXMgY29udHJvbGxhYmxlIHdpdGggdGhlIHZh cmlhYmxlCi1AY29kZXtwcm9qZWN0LXZjLWluY2x1ZGUtdW50cmFja2VkfS4KK3Byb2plY3Qu ICBTZWUgaXRzIGVudHJ5IGJlbG93IGZvciBkZXNjcmlwdGlvbiBhbmQgcmVsYXRlZCBvcHRp b25zLgogCiBAY2luZGV4IGN1cnJlbnQgcHJvamVjdCBuYW1lIG9uIG1vZGUgbGluZQogQGRl Zm9wdCBwcm9qZWN0LW1vZGUtbGluZQpAQCAtMTgwNiwxMiArMTgwNCw1OCBAQCBQcm9qZWN0 cwogQGVuZCBkZWZvcHQKIAogQG1lbnUKKyogVkMtQXdhcmUgUHJvamVjdCBCYWNrZW5kOjog RGVmYXVsdCBwcm9qZWN0IGJhY2tlbmQuCiAqIFByb2plY3QgRmlsZSBDb21tYW5kczo6ICAg Q29tbWFuZHMgZm9yIGhhbmRsaW5nIHByb2plY3QgZmlsZXMuCiAqIFByb2plY3QgQnVmZmVy IENvbW1hbmRzOjogQ29tbWFuZHMgZm9yIGhhbmRsaW5nIHByb2plY3QgYnVmZmVycy4KICog U3dpdGNoaW5nIFByb2plY3RzOjogICAgICBTd2l0Y2hpbmcgYmV0d2VlbiBwcm9qZWN0cy4K ICogTWFuYWdpbmcgUHJvamVjdHM6OiAgICAgICBNYW5hZ2luZyB0aGUgcHJvamVjdCBsaXN0 IGZpbGUuCiBAZW5kIG1lbnUKIAorQG5vZGUgVkMtQXdhcmUgUHJvamVjdCBCYWNrZW5kCisK K1RoaXMgYmFja2VuZCBpcyB1c2VkIGJ5IGRlZmF1bHQuICBJdCBkZXRlcm1pbmVzIHRoZSBj b250ZW50cyBvZiB0aGUKK3Byb2plY3QgYmFzZWQgb24gdGhlIFZDUyByZXBvc2l0b3J5J3Mg Y29uZmlndXJhdGlvbiAoaWYgYW55KSwgZXhjbHVkaW5nCit0aGUgYGBpZ25vcmVkJycgZmls ZXMgZnJvbSB0aGUgb3V0cHV0LgorCitJdCBoYXMgc29tZSBwZXJmb3JtYW5jZSBvcHRpbWl6 YXRpb25zIGZvciBsaXN0aW5nIHRoZSBmaWxlcyB3aXRoIHNvbWUgb2YKK3RoZSBwb3B1bGFy IFZDUyBzeXN0ZW1zIChjdXJyZW50bHkgR2l0IGFuZCBNZXJjdXJpYWwpLgorCitAZGVmb3B0 IHByb2plY3QtdmMtaW5jbHVkZS11bnRyYWNrZWQKK2BgdW50cmFja2VkJycgZmlsZXMgYXJl IGNvbnNpZGVyZWQgdG8gYmUgcGFydCBvZiB0aGUgcHJvamVjdC4gIFRvIGNoYW5nZQordGhh dCwgeW91IGNhbiBjdXN0b21pemUgdGhpcyB2YXJpYWJsZSB0byBuaWwuCitAZW5kIGRlZm9w dAorCitAZGVmb3B0IHByb2plY3QtdmMtaWdub3JlcworVXNpbmcgdGhpcyB2YXJpYWJsZSB5 b3UgY2FuIGFkZCBtb3JlIGlnbm9yZSBwYXR0ZXJucyB0byB0aGUgcHJvamVjdCwgdG8KK2V4 Y2x1ZGUgbW9yZSBmaWxlcyBmcm9tIHRoZSBwcm9qZWN0J3MgZmlsZSBsaXN0aW5nLiAgVGhl IHZhbHVlIGlzIGEgbGlzdAorb2YgZ2xvYiBzdHJpbmdzLiAgVGhleSBjYW4gbWF0Y2ggYm90 aCByZWd1bGFyIGZpbGVzIGFuZCBkaXJlY3Rvcmllcy4gIFRvCithbmNob3IgYW4gZW50cnkg dG8gdGhlIHByb2plY3Qgcm9vdCwgc3RhcnQgaXQgd2l0aCBAY29kZXsuL30uICBUbyBtYXRj aAorZGlyZWN0b3JpZXMgb25seSwgZW5kIGl0IHdpdGggQGNvZGV7L30uCitAZW5kIGRlZm9w dAorCitAZGVmb3B0IHByb2plY3QtdmMtbWVyZ2Utc3VibW9kdWxlcworQnkgZGVmYXVsdCBh bGwgc3VibW9kdWxlcyBpbnNpZGUgYSBHaXQgcHJvamVjdCBhcmUgY29uc2lkZXJlZCB0byBi ZSBwYXJ0CitvZiB0aGUgcGFyZW50IHJlcG9zaXRvcnkncyBwcm9qZWN0LiAgQ3VzdG9taXpl IHRoaXMgdG8gbmlsIHRvIG1ha2UgdGhlbQorc2VwYXJhdGUgcHJvamVjdHMuCitAZW5kIGRl Zm9wdAorCitAZGVmb3B0IHByb2plY3QtdmMtbmFtZQorVGhpcyB2YXJpYWJsZSBhbGxvd3Mg eW91IHRvIGNoYW5nZSB0aGUgYXV0b21hdGljYWxseSBkZXRlY3RlZCBuYW1lIG9mCit0aGUg cHJvamVjdCB0byBhIHN0cmluZyBvZiB5b3VyIGNob2ljZS4gIEJ5IGRlZmF1bHQgdGhlIG5h bWUgaXMgdGhlIGJhc2UKK25hbWUgb2YgaXRzIHJvb3QgZGlyZWN0b3J5LgorQGVuZCBkZWZv cHQKKworQGRlZm9wdCBwcm9qZWN0LXZjLWV4dHJhLXJvb3QtbWFya2VycworVGhpcyB2YXJp YWJsZSBhbGxvd3MgeW91IHRvIHNldCB1cCBkZXRlY3Rpb24gb2Ygbm9uLVZDIHByb2plY3Rz IGluIHRoaXMKK2JhY2tlbmQsIGFuZCBhbHNvIHRvIGhhdmUgc29tZSBzdWJkaXJlY3Rvcmll cyBkZXRlY3RlZCBhcyBzZXBhcmF0ZQorcHJvamVjdHMuICBUaGUgdmFsdWUgaXMgYSBsaXN0 LgorCitFYWNoIGVsZW1lbnQgaXMgZWl0aGVyIGEgYmFzZSBmaWxlIG5hbWUgb3IgYSBnbG9i IHBhdHRlcm4gZm9yIHN1Y2guCisKK0V4YW1wbGUgdmFsdWVzOiBAc2FtcHsiLmRpci1sb2Nh bHMuZWwifSwgQHNhbXB7InBhY2thZ2UuanNvbiJ9LAorQHNhbXB7InJlcXVpcmVtZW50cy50 eHR9LCBAc2FtcHsiKi5nZW1zcGVjIn0uCitAZW5kIGRlZm9wdAorCiBAbm9kZSBQcm9qZWN0 IEZpbGUgQ29tbWFuZHMKIEBzdWJzZWN0aW9uIFByb2plY3QgQ29tbWFuZHMgVGhhdCBPcGVy YXRlIG9uIEZpbGVzCiAK --------------5Awgzls6RR1nHkYiefXMKJ8r-- ------------=_1745794442-10812-1-- From unknown Tue Jun 17 01:34:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#77974: Manual updates for the VC-aware project backend Resent-From: Sean Whitton Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 28 Apr 2025 02:49:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 77974 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Dmitry Gutov Cc: 77974@debbugs.gnu.org Received: via spool by 77974-submit@debbugs.gnu.org id=B77974.17458085262078 (code B ref 77974); Mon, 28 Apr 2025 02:49:02 +0000 Received: (at 77974) by debbugs.gnu.org; 28 Apr 2025 02:48:46 +0000 Received: from localhost ([127.0.0.1]:47845 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u9EY2-0000XQ-1L for submit@debbugs.gnu.org; Sun, 27 Apr 2025 22:48:46 -0400 Received: from sendmail.purelymail.com ([34.202.193.197]:36658) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u9EXs-0000Vi-T4 for 77974@debbugs.gnu.org; Sun, 27 Apr 2025 22:48:42 -0400 DKIM-Signature: a=rsa-sha256; b=hzGUz359z0fmh1YEXVdz+FKGhsIDe/3kMpC71dW9o8vNxh+xKJHqqVvze8H22sjY2VVknb6jNDy+9Z35hhS53ib5cB+W5gKL0US8UdHE2jcP9J2mphEJv3rvVF8d4I/Er+ysTB2Ka/uunYnnxsveC/4UwfiihRdTSA/M5o3bNEAJfZPpHvQldw2s1czI67Qn1hLILGJXHdtVcQzr4UE9gou1++31avxgYdiKK4V7VvnHq4H5KqwRLLNkS0tt4VlqZPl3sspuiWZEVnOQ+aGRUt0zrliiKYhTW90mOUdvWvZce69c0EG2Y+DfzJ5AJGscttAJp9eJX397Us7tgyLT4w==; s=purelymail1; d=spwhitton.name; v=1; bh=5h3oXFvpvxEihG4MDEA+0HDLFTFL4wf8WAeu1ua/lWY=; h=Received:Received:From:To:Subject:Date; DKIM-Signature: a=rsa-sha256; b=HP/8kubNUMHQh3wUW2JNw+4nIlPEXol9vexHri09w8PgqW/EkXkXz2xYzCGRhAfE5ScrWVQFhceY2+QmAh9wHJ3OOXKW68Nx7A7sGAgrqguj5q02UWY0InH3ibSAfYSELH1tQk1Ak/vyrEIas2c95dJKaYpYpXOBz8WG5pNVKuaBeLm+oM6CGdifaFMqX/FYm33WRjzGMmVmh8CckP1qV3jWjVsyM5YWOp2Ifl50ZXOfk936oQKxQoin9Hu6i8KJ8gMO0Heg1IcJWgKng0gGJiTfq4Gq9ymiX6Z0Defv0LCuKt9/gYTc9ewqsIC3Xv+/pxaE+zOIondVBfvMd/uBxw==; s=purelymail1; d=purelymail.com; v=1; bh=5h3oXFvpvxEihG4MDEA+0HDLFTFL4wf8WAeu1ua/lWY=; h=Feedback-ID:Received:Received:From:To:Subject:Date; Feedback-ID: 20115:3760:null:purelymail X-Pm-Original-To: 77974@debbugs.gnu.org Received: by smtp.purelymail.com (Purelymail SMTP) with ESMTPSA id 642546396; (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384); Mon, 28 Apr 2025 02:48:30 +0000 (UTC) Received: by melete.silentflame.com (Postfix, from userid 1000) id 422577E0252; Mon, 28 Apr 2025 10:48:28 +0800 (CST) From: Sean Whitton In-Reply-To: References: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> <87ldrmi3vy.fsf@melete.silentflame.com> Date: Mon, 28 Apr 2025 10:48:28 +0800 Message-ID: <87seltf1c3.fsf@melete.silentflame.com> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hello, On Mon 28 Apr 2025 at 01:39am +03, Dmitry Gutov wrote: > "Neither registered nor ignored" sounds like the definition for > "unregistered", actually. > > Sounds good to me as a phrasing (might even be more accurate than the Git > definition I quoted previously). Thanks. I've tweaked the phrasing slightly. >> ... possibly with a cross-reference to the definitions of the VC terms. > > If there is a node to reference, happy to. Turns out there is not. Hrm. >> (And maybe we should rename the variable?) > > Doesn't seem worth the hassle for us and existing users, TBH. I've added a FIXME to keep thinking about it (hope it's okay with you for me to go ahead and add such a thing to project.el, let me know if not). My thinking is: if we have another very popular VCS in the future which doesn't use the name "untracked", then falling back on our own existing "unregistered" terminology to unify things would be better than using Git and Hg's "untracked" in this one place. -- Sean Whitton From unknown Tue Jun 17 01:34:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#77974: Manual updates for the VC-aware project backend Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 28 Apr 2025 13:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 77974 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Sean Whitton Cc: 77974@debbugs.gnu.org Received: via spool by 77974-submit@debbugs.gnu.org id=B77974.174584585124080 (code B ref 77974); Mon, 28 Apr 2025 13:11:02 +0000 Received: (at 77974) by debbugs.gnu.org; 28 Apr 2025 13:10:51 +0000 Received: from localhost ([127.0.0.1]:55121 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u9OG3-0006GI-7F for submit@debbugs.gnu.org; Mon, 28 Apr 2025 09:10:51 -0400 Received: from fout-a5-smtp.messagingengine.com ([103.168.172.148]:36871) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u9OFy-0006Ey-Gh for 77974@debbugs.gnu.org; Mon, 28 Apr 2025 09:10:48 -0400 Received: from phl-compute-11.internal (phl-compute-11.phl.internal [10.202.2.51]) by mailfout.phl.internal (Postfix) with ESMTP id 23ECD1380885; Mon, 28 Apr 2025 09:10:41 -0400 (EDT) Received: from phl-mailfrontend-02 ([10.202.2.163]) by phl-compute-11.internal (MEProxy); Mon, 28 Apr 2025 09:10:41 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gutov.dev; h=cc :cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm1; t=1745845841; x=1745932241; bh=87VdCsRaP5f1peeEj59BxRdp9Pt4vQbu1TcTR0Tz4iY=; b= XQGYyODBadYLVidObN9TRI47dHuXGIjRYyJNGRYrRRDgt2wx3NVxJ/48GSL3alBb FGApCjirNiYyA5m83aMvPH6R28WZO0qtMie6xtNofw9jJtOELzm2acXXf8Ub9Jbl JnyskS7DM+w2+AqAUFxivMuN4H8pBg+kFjAnu/YVRCm4Lf8kTOM8rZxKyu7EcVJC I/WIEM9n9HTSANQ+106YnaIJwFlP37ug5LAq8Y/Fr7PNtZ3lzFl3stZLoUs2CbcT EvtGCmdo+aGOtmL01MxnyYBdMwAFhwkshUNDsuHrC4KcXiidP2dNRrKw1EHiKtwM tiTkTMILLc07MeXNWnPFNg== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1745845841; x= 1745932241; bh=87VdCsRaP5f1peeEj59BxRdp9Pt4vQbu1TcTR0Tz4iY=; b=K U2zDHA5aT+amIf7BhcWTvscwagx80rfAn5OKn5wQo5kDYuc8wNBLsMH03aQrKm1F zkDpxJeEZfsCaobR8Moz6iaTVL+O3UW1x+vtk3OFjg9sWQkVxBshkPQ+ZIQndDkt m84ye2nfr7YgsECtQrYUg2GnfrJdgcGbufcHH4zGR3gfdNc+8FyvBL6VD+E1MDRj w9dti20p0EEKNqbwaAbbBhjBmqzj3QOFQaZPKcOOz6xvY1AjCxiVhFy5XApqOLIS 4vfFgWYUKQfcrYdh+xLXsyFE7553S2Ho67sF9IyXBQm6pMU4NzqGYPJZISFj/RVz gpiKZMtRsMgtjD+STarTA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefvddrtddtgddviedutdefucetufdoteggodetrf dotffvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdggtfgfnhhsuhgsshgtrhhisggv pdfurfetoffkrfgpnffqhgenuceurghilhhouhhtmecufedttdenucesvcftvggtihhpih gvnhhtshculddquddttddmnecujfgurhepkfffgggfuffvvehfhfgjtgfgsehtjeertddt vdejnecuhfhrohhmpeffmhhithhrhicuifhuthhovhcuoegumhhithhrhiesghhuthhovh druggvvheqnecuggftrfgrthhtvghrnhepteduleejgeehtefgheegjeekueehvdevieek ueeftddvtdevfefhvdevgedujeehnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrg hmpehmrghilhhfrhhomhepughmihhtrhihsehguhhtohhvrdguvghvpdhnsggprhgtphht thhopedvpdhmohguvgepshhmthhpohhuthdprhgtphhtthhopehsphifhhhithhtohhnse hsphifhhhithhtohhnrdhnrghmvgdprhgtphhtthhopeejjeeljeegseguvggssghughhs rdhgnhhurdhorhhg X-ME-Proxy: Feedback-ID: i07de48aa:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Mon, 28 Apr 2025 09:10:39 -0400 (EDT) Message-ID: Date: Mon, 28 Apr 2025 16:10:37 +0300 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird References: <8822f72a-bca8-438b-b7b1-e6c03f03f53c@gutov.dev> <87ldrmi3vy.fsf@melete.silentflame.com> <87seltf1c3.fsf@melete.silentflame.com> Content-Language: en-US From: Dmitry Gutov In-Reply-To: <87seltf1c3.fsf@melete.silentflame.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) On 28/04/2025 05:48, Sean Whitton wrote: > Hello, > > On Mon 28 Apr 2025 at 01:39am +03, Dmitry Gutov wrote: > >> "Neither registered nor ignored" sounds like the definition for >> "unregistered", actually. >> >> Sounds good to me as a phrasing (might even be more accurate than the Git >> definition I quoted previously). > > Thanks. I've tweaked the phrasing slightly. Thank you. >>> (And maybe we should rename the variable?) >> >> Doesn't seem worth the hassle for us and existing users, TBH. > > I've added a FIXME to keep thinking about it > (hope it's okay with you for me to go ahead and add such a thing to > project.el, let me know if not). > > My thinking is: if we have another very popular VCS in the future which > doesn't use the name "untracked", then falling back on our own existing > "unregistered" terminology to unify things would be better than using > Git and Hg's "untracked" in this one place. Sure. That seems like a pretty distant future, though.