9adf0579aecd318ca6284c27ab92f78dbaec8e12 — Theodor Thornhill 4 months ago 667e002 rem-known-project
Add command project-remove-known-project

* etc/NEWS: Mention the new command.

* lisp/progmodes/project.el (project--remove-from-project-list): Add
new argument, report-message, used to signal various messages when
removal has happened.

* lisp/progmodes/project.el (project-remove-known-project): New
command that removes the selected directory from the project-list-file.

* lisp/progmodes/project.el (project-current): Add the report message.

* doc/emacs/maintaining.text: Add information about the new command to
the manual.
3 files changed, 38 insertions(+), 6 deletions(-)

M doc/emacs/maintaining.texi
M etc/NEWS
M lisp/progmodes/project.el
M doc/emacs/maintaining.texi => doc/emacs/maintaining.texi +16 -0
@@ 1843,6 1843,22 @@ in the menu, and which key invokes each command.
records the list of known projects.  It defaults to the file
@file{projects} in @code{user-emacs-directory} (@pxref{Find Init}).

@node Managing project list file
@subsection Managing Projects

@table @kbd
@item M-x project-remove-known-project
Remove a known project from the (@code{project-list-file}).
@end table

@findex project-remove-known-project
  Normally Emacs handle adding and removing projects to the
(@code{project-list-file}) automatically.  Sometimes you still want to
manually edit the available
projects. @kbd{M-x project-remove-known-project} will prompt you for the
available projects, and upon selecting one, it will disappear from the

@node Change Log
@section Change Logs

M etc/NEWS => etc/NEWS +5 -0
@@ 1573,6 1573,11 @@ project's root directory, respectively.
*** New user option 'project-list-file'.

*** New command 'project-remove-known-project'.
This command lets you interactively remove an entry from the list of projects
in 'project-list-file'

** xref


M lisp/progmodes/project.el => lisp/progmodes/project.el +17 -6
@@ 201,7 201,8 @@ of the project instance object."
    (when maybe-prompt
      (if pr
          (project-remember-project pr)
        (project--remove-from-project-list directory)
         directory "Project `%s' not found; removed from list")
        (setq pr (cons 'transient directory))))

@@ 1217,17 1218,27 @@ Save the result in `project-list-file' if the list of projects has changed."
      (push (list dir) project--list)

(defun project--remove-from-project-list (pr-dir)
  "Remove directory PR-DIR of a missing project from the project list.
(defun project--remove-from-project-list (project-root report-message)
  "Remove directory PROJECT-ROOT of a missing project from the project list.
If the directory was in the list before the removal, save the
result in `project-list-file'.  Announce the project's removal
from the list."
from the list using REPORT-MESSAGE, which is a format string
passed to `message' as its first argument."
  (when-let ((ent (assoc pr-dir project--list)))
  (when-let ((ent (assoc project-root project--list)))
    (setq project--list (delq ent project--list))
    (message "Project `%s' not found; removed from list" pr-dir)
    (message report-message project-root)

(defun project-remove-known-project (project-root)
  "Remove directory PROJECT-ROOT from the project list.
PROJECT-ROOT is the root directory of a known project listed in
the project list."
  (interactive (list (project-prompt-project-dir)))
   dir "Project `%s' removed from known projects"))

(defun project-prompt-project-dir ()
  "Prompt the user for a directory that is one of the known project roots.
The project is chosen among projects known from the project list,