* 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.

2 files changed, 18 insertions, 0 deletions

diff --git a/etc/NEWS b/etc/NEWS
index 1e66f084117..e257721f5b4 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -108,6 +108,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’.
+
 
 * Editing Changes in Emacs 31.1
 
diff --git a/lisp/progmodes/project.el b/lisp/progmodes/project.el
index 983242628f0..ddaa58fbcf1 100644
--- a/lisp/progmodes/project.el
+++ b/lisp/progmodes/project.el
@@ -1070,6 +1070,19 @@ using a command like `project-find-file'."
     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.