* etc/NEWS: Mention it.

Add project-find-file-in-root (bug#73044)

Several users have asked me for a command which is just
find-file, but starting from the project root.  In large
projects, where project-files is expensive, this will have
substantially better performance than project-find-file.

Also, it allows opening files which aren't included in
project-files without paying the further cost of running
project--files-in-directory (which is what happens when passing
INCLUDE-ALL=t to project-find-file).

Also, it may help with user confusion about why
project-find-file doesn't behave like find-file (which I've
encountered a few times).

This command is equivalent to C-x p o C-x C-f, but it's nice to
be able to bind it to a specific key.

Overall, this is easy enough to provide, so let's just do that.

* lisp/progmodes/project.el (project-find-file-in-root): Add.

* etc/NEWS: Mention it.

(cherry picked from commit d879c40f68c078bdba15122e4e886a2052fbddf4)

diff --git a/etc/NEWS b/etc/NEWS
index 2360807327093aa4ad0c09fbd0075a2f39cf4ef3..4726ee54674e9560af275b8a7bf40b2b00a47230 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -81,6 +81,11 @@ latter throws an error when the argument FRAME cannot be deleted.
 *** New abnormal hook 'tab-bar-auto-width-functions'.
 This hook allows you to control which tab-bar tabs are auto-resized.
 
+** Project
+
+New command `project-find-file-in-root` which is equivalent to running
+‘project-any-command’ with ‘find-file’.
+
 \f
 * Editing Changes in Emacs 31.1
 

diff --git a/lisp/progmodes/project.el b/lisp/progmodes/project.el
index b567b8afc2d0022dfa8870e44248611b3c741df5..9c87b1872bfb2abb5868046dfc1c7fb2d22c744b 100644 (file)
--- a/lisp/progmodes/project.el
+++ b/lisp/progmodes/project.el
@@ -1072,6 +1072,19 @@ using a command like `project-find-file'."
               (file-relative-name filename (project-root filename-proj)))
     filename))
 
+;;;###autoload
+(defun project-find-file-in-root ()
+  "Call `find-file' in the current project root.
+
+Unlike `project-find-file', this doesn't provide completion over the
+entire file tree.
+
+This is equivalent to running `project-any-command' with `find-file'."
+  (interactive)
+  (let* ((pr (project-current t))
+         (default-directory (project-root pr)))
+    (call-interactively #'find-file)))
+
 ;;;###autoload
 (defun project-find-file (&optional include-all)
   "Visit a file (with completion) in the current project.