Improve documentation of 'project-mode-line'

* etc/NEWS:
* doc/emacs/maintaining.texi (Projects):
* lisp/progmodes/project.el (project-mode-line): Improve the
documentation of 'project-mode-line'.  (Bug#66317)

diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index 5f9a5d89bf331c65ca352acbaff2f4b98e6c0045..d37cefebb017f246b6f69dd4c400e74f9655ad81 100644 (file)
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -1743,6 +1743,14 @@ project.  Also, the VC-aware Project back-end considers ``untracked''
 files by default.  That behavior is controllable with the variable
 @code{project-vc-include-untracked}.
 
+@cindex current project name on mode line
+@defopt project-mode-line
+If this user option is non-@code{nil}, Emacs displays the name of the
+current project (if any) on the mode line; clicking @kbd{mouse-1} on
+the project name pops up the menu with the project-related commands.
+The default value is @code{nil}.
+@end defopt
+
 @menu
 * Project File Commands::   Commands for handling project files.
 * Project Buffer Commands:: Commands for handling project buffers.

diff --git a/etc/NEWS b/etc/NEWS
index 934521ec1b0622b68f650869a253e2ba6b32dd20..70110768c9717853efb32d870cae80f517e19bc5 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -890,8 +890,9 @@ showcases all their customization options.
 ** Project
 
 *** New user option 'project-mode-line'.
-When non-nil, display the name of the current project on
-the mode line.  Clicking mouse-1 pops up the project menu.
+When non-nil, display the name of the current project on the mode
+line.  Clicking 'mouse-1' on the project name pops up the project
+menu.  The default value is nil.
 
 *** New user option 'project-file-history-behavior'.
 Customizing it to 'relativize' makes commands like 'project-find-file'

diff --git a/lisp/progmodes/project.el b/lisp/progmodes/project.el
index 9997833ceb1ccb2b38236b4edaf676a5dd7bcd3a..3c469d0e51fdc29c22d42c15c7175b2b49c263a8 100644 (file)
--- a/lisp/progmodes/project.el
+++ b/lisp/progmodes/project.el
@@ -2014,9 +2014,10 @@ would otherwise have the same name."
 
 ;;;###autoload
 (defcustom project-mode-line nil
-  "Show the current project name with the menu on the mode line.
+  "Whether to show current project name and Project menu on the mode line.
 This feature requires the presence of the following item in
-`mode-line-format': `(project-mode-line project-mode-line-format)'."
+`mode-line-format': `(project-mode-line project-mode-line-format)'; it
+is part of the default mode line beginning with Emacs 30."
   :type 'boolean
   :group 'project
   :version "30.1")