GNU bug report logs -
#55632
[PATCH] Add new user option project-vc-find-tracked-only
Previous Next
Reported by: Jan Synáček <jan.synacek <at> posteo.org>
Date: Wed, 25 May 2022 14:04:02 UTC
Severity: normal
Tags: patch
Fixed in version 29.1
Done: Dmitry Gutov <dgutov <at> yandex.ru>
Bug is archived. No further changes may be made.
Full log
View this message in rfc822 format
[Message part 1 (text/plain, inline)]
Your bug report
#55632: [PATCH] Add new user option project-vc-find-tracked-only
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 55632 <at> debbugs.gnu.org.
--
55632: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=55632
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
Version: 29.1
On 03.06.2022 08:44, Eli Zaretskii wrote:
>> Date: Fri, 3 Jun 2022 02:45:19 +0300
>> Cc: 55632 <at> debbugs.gnu.org, raaahh <at> gmail.com
>> From: Dmitry Gutov <dgutov <at> yandex.ru>
>>
>> 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.
[Message part 3 (message/rfc822, inline)]
[Message part 4 (text/plain, inline)]
Tags: patch
Tags: patch
Currently, `project-find-file' always includes untracked files, which is
not always the desired behavior. This patch adds a new user option to
make only find the actual project files. By default, the variable is set
to nil, which means the behavior is not changed.
In GNU Emacs 28.1.50 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.24.33, cairo version 1.17.6)
of 2022-05-21 built on jsynacek-home
Repository revision: 9e7c0cf57d522b50423880f3a846c52c5509fef9
Repository branch: emacs-28
Windowing system distributor 'The X.Org Foundation', version 11.0.12101003
System Description: Arch Linux
Configured using:
'configure --with-imagemagick --with-json --with-native-compilation
--prefix=/home/jsynacek/emacs'
[0001-Add-new-user-option-project-vc-find-tracked-only.patch (text/patch, attachment)]
This bug report was last modified 2 years and 352 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.