scratch/project-switching 47eac3f: Update the Emacs manual with recent project.el changes

[Simen Heggestøyl]

branch: scratch/project-switching
commit 47eac3f87ef153147b2aa7e63153aa02f68d4a62
Author: Simen Heggestøyl <address@hidden>
Commit: Simen Heggestøyl <address@hidden>

    Update the Emacs manual with recent project.el changes
    
    * doc/emacs/maintaining.texi (Projects): Add a menu.
    (Project File Commands): New subsection describing project file
    commands (moved here from 'Working with Projects').  Describe the new
    commands 'project-dired' and 'project-eshell'.
    (Switching Projects): New subsection.
    
    * etc/NEWS: Mention project.el changes.
---
 doc/emacs/maintaining.texi | 34 +++++++++++++++++++++++++++++++++-
 etc/NEWS                   | 15 +++++++++++++++
 2 files changed, 48 insertions(+), 1 deletion(-)

diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index ebcdddf..adaafdb 100644
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -1656,8 +1656,16 @@ support additional types of projects.
 the project back-end.  For example, the VC back-end doesn't consider
 ``ignored'' files (@pxref{VC Ignore}) to be part of the project.
 
+@menu
+* Project File Commands:: Commands for handling project files.
+* Switching Projects::    Switching between projects.
+@end menu
+
+@node Project File Commands
+@subsection Project File Commands
+
   Emacs provides commands for handling project files conveniently.
-This section describes these commands.
+This subsection describes these commands.
 
 @cindex current project
   All of the commands described here share the notion of the
@@ -1705,6 +1713,30 @@ Replace}), and continues to the next match after you 
respond.  If your
 response causes Emacs to exit the query-replace loop, you can later
 continue with @w{@kbd{M-x fileloop-continue @key{RET}}}.
 
+@findex project-dired
+  The command @code{project-dired} opens a Dired buffer
+(@pxref{Dired}) listing the files in the current project's root
+directory.
+
+@findex project-eshell
+   The command @code{project-eshell} starts an Eshell session in a new
+buffer with the current project's root as the working directory.
+@xref{Top,Eshell,Eshell, eshell, Eshell: The Emacs Shell}.
+
+@node Switching Projects
+@subsection Switching Projects
+
+    Commands that operate on project files (@pxref{Project File
+Commands}) will conveniently prompt you for a project directory when
+no project is current.  When a project is current but you want to
+operate on a different project, the command
+@code{project-switch-project} can be used.
+
+  This command prompts you for a new project directory, and then
+displays a menu of commands avilable for operating on the chosen
+project.  The variable @code{project-switch-commands} controls which
+commands are avilable in the menu, and by which keys they are invoked.
+
 @node Change Log
 @section Change Logs
 
diff --git a/etc/NEWS b/etc/NEWS
index 12406ee..336520d 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -221,6 +221,21 @@ key             binding
 / v             package-menu-filter-by-version
 / /             package-menu-filter-clear
 
+** Project
+
+*** Previously used project directories are now are now completed by
+all commands that prompt for a project directory.
+
++++
+*** New commands 'project-dired' and 'project-eshell'.
+These commands run Dired and Eshell in a project's root directory,
+respectively.
+
++++
+*** New command 'project-switch-project'.
+This command lets you "switch" to another project by running a project
+command chosen from a dispatch menu.
+
 ** gdb-mi
 
 +++