From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.bugs Subject: bug#55632: [PATCH] Add new user option project-vc-find-tracked-only Date: Sat, 4 Jun 2022 03:37:21 +0300 Message-ID: References: <87leuqkmhl.fsf@posteo.org> <9e283838-aaa1-345e-bce8-21ee863dbc31@yandex.ru> <43b5eada954e592cc0c747368a3dbdb7@posteo.de> <437b78f7-f4a9-670d-9b74-69ae8a565767@yandex.ru> <83ee06euv7.fsf@gnu.org> <859e155c-c71c-87f0-0363-f5682fe3d697@yandex.ru> <83a6aue1y2.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="31890"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.9.1 Cc: jan.synacek@posteo.org, 55632-done@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Jun 04 02:38:36 2022 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 1nxHoJ-00088t-Mo for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 04 Jun 2022 02:38:35 +0200 Original-Received: from localhost ([::1]:47214 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nxHoI-00077v-8i for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 03 Jun 2022 20:38:34 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:43164) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nxHnn-00077S-MK for bug-gnu-emacs@gnu.org; Fri, 03 Jun 2022 20:38:05 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:35120) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nxHnm-0000Yd-Mw for bug-gnu-emacs@gnu.org; Fri, 03 Jun 2022 20:38:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nxHnm-0003Am-Jx for bug-gnu-emacs@gnu.org; Fri, 03 Jun 2022 20:38:02 -0400 Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Sat, 04 Jun 2022 00:38:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 55632 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Mail-Followup-To: 55632@debbugs.gnu.org, dgutov@yandex.ru, jan.synacek@posteo.org Original-Received: via spool by 55632-done@debbugs.gnu.org id=D55632.165430305212155 (code D ref 55632); Sat, 04 Jun 2022 00:38:02 +0000 Original-Received: (at 55632-done) by debbugs.gnu.org; 4 Jun 2022 00:37:32 +0000 Original-Received: from localhost ([127.0.0.1]:57250 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nxHnI-00039z-6K for submit@debbugs.gnu.org; Fri, 03 Jun 2022 20:37:32 -0400 Original-Received: from mail-wr1-f50.google.com ([209.85.221.50]:36385) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nxHnF-00039l-RO for 55632-done@debbugs.gnu.org; Fri, 03 Jun 2022 20:37:30 -0400 Original-Received: by mail-wr1-f50.google.com with SMTP id u3so12289227wrg.3 for <55632-done@debbugs.gnu.org>; Fri, 03 Jun 2022 17:37:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=sender:message-id:date:mime-version:user-agent:subject :content-language:to:cc:references:from:in-reply-to :content-transfer-encoding; bh=fCxwz2+FD7e2pXAPiB2SrVRbGhXHUprcirLibr1I6gI=; b=ojaLpo5n3VfVSHmB1zwl45egKtJ5o6a7KczZBDcJdWWAfJmUrie181tEifqL2rR0re MwcyRySk2GHFTi6bImdTVxs737qNovohvqw2PfQI3Z/APW1MltEpq2OwOHJu2gT4OHZg 3LwbZ3VNlikNsQAp26RdWGE2FwPzpdixaKjmVShaWNzZBleuMFzR4uilJXHKvglncwMW QIEWCt0jtXpuGSzNDFvsTRFt9iZE2V+i0A4eQvumLBcu92o7FmmWrOuMBVDv13tCVGUH UHU7fU+TT3uQZh932uLjl5gw2Nxk4+MqrDaj6VmaiqTZkHlPoB0b9QTXlPKFaOBjlji9 v6qw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:sender:message-id:date:mime-version:user-agent :subject:content-language:to:cc:references:from:in-reply-to :content-transfer-encoding; bh=fCxwz2+FD7e2pXAPiB2SrVRbGhXHUprcirLibr1I6gI=; b=TGc7T3g+CgQDkPzkkxfLtZ5mjeSGHZ0sVhs+T8U5aCivU6QpIAWE1ME/U1lY4b5n0T ljPl4SmMliaxu3nzXu+8Wrj9bzTI3g+wsuqLFkqkdFZpqBni5Caxno5UcezBuy0XufcI K1SKOAAd4rAdMT+SdptAjBWRBR8c9b1B8UOi/JaOyWfEqtGWdEwT/DwvxPMtF76tTqm9 ilJlj5LB1a+n7n4WkjqHFyeV49+NorEDhyYibM+TugUcM9/Y4W3fkJQeXXZYEsAxOyOv cy6cdttOqHXZ/snaDJMDYxeQrjYTEJpcIZ9+OwNMwxJga+oXYHWdqFSaBJZHhKMcFd+N d0Jw== X-Gm-Message-State: AOAM532DH4vs+d9DD2eJX5IX9oHXgnQzBCCZGE/bqVGPPSeicKKizqBk CTftna+P0LqmVg2MDrqQCF8= X-Google-Smtp-Source: ABdhPJyDB2y4NA206hfFPIRBkQacCNHKTdM2p+gaqxeLydfeWf/+8FaE7/MPeXSBnAKjNJNuOWTxTA== X-Received: by 2002:a05:6000:1c2:b0:213:3b79:bd7 with SMTP id t2-20020a05600001c200b002133b790bd7mr8710468wrx.634.1654303044009; Fri, 03 Jun 2022 17:37:24 -0700 (PDT) Original-Received: from [192.168.0.6] ([46.251.119.176]) by smtp.googlemail.com with ESMTPSA id t15-20020a05600c198f00b003942a244f40sm15045054wmq.25.2022.06.03.17.37.22 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 03 Jun 2022 17:37:23 -0700 (PDT) Content-Language: en-US In-Reply-To: <83a6aue1y2.fsf@gnu.org> 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" Xref: news.gmane.io gmane.emacs.bugs:233628 Archived-At: Version: 29.1 On 03.06.2022 08:44, Eli Zaretskii wrote: >> Date: Fri, 3 Jun 2022 02:45:19 +0300 >> Cc: 55632@debbugs.gnu.org, raaahh@gmail.com >> From: Dmitry Gutov >> >> On 02.06.2022 22:19, Eli Zaretskii wrote: >>> Can we please tell more about what does "include untracked files" >>> mean? Include where and in what sense? >> >> Has them considered to be part of the project. Which in practice means >> including them in a project's list of files. For the purposes for >> project-find-file, project-find-regexp, and all other commands that >> build on top of 'project-files'. >> >> How would you phrase that better? > > Something like this: > > If non-nil, files untracked by a VCS are considered to be part of > the project by a VC project based on that VCS. A bit unwieldy IMHO, but I don't mind. As long as you only objected to the NEWS entry. The addition to the manual, which is also usually considered user-level text, only continues the style of the preceding sentence. And the docstring has to be precise either way. >>> Bonus points for explaining >>> this without ever alluding to "backend", as that is not necessarily a >>> user-level concept in this case. >> >> The variable only affects a particular backend. It's only meaningful >> when there is a VCS anyway. > > I understand. My point was to avoid using the word "backend" in > user-level documentation, as much as possible. > >>> Also, is it "VC project backend" or "Project's VC backend"? >> >> I would say both mean the same thing, but the latter seems to be more >> unambiguous. > > Well, if you are okay with my alternative wording above, it solves > this problem as well. Amended and pushed, thank you both.