From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 9 Jan 2016 19:45:33 +0000 (+0200)
Subject: Document user-level functions in project.el
X-Git-Tag: emacs-25.0.90~222
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=cc140bcec665163790a8a15845f16dca39525425;p=emacs.git

Document user-level functions in project.el

* lisp/progmodes/project.el (project-find-file)
(project-or-external-find-file): Add doc strings.
---

diff --git a/etc/NEWS b/etc/NEWS
index 407d13b31b3..3ad2fb3253f 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -964,13 +964,14 @@ As a result of this, the following commands are now obsolete:
 The framework's Lisp API is still experimental and can change in major,
 backward-incompatible ways.
 
+---
 ** New package Project
 
 The new package Project provides generic infrastructure for dealing
 with projects.  The main commands included in it are
 `project-find-file' and `project-find-regexp'.
 
-Like Xref, the project API is still experimental.
+The Lisp API of this package is still experimental.
 
 *** New variables
 
diff --git a/lisp/progmodes/project.el b/lisp/progmodes/project.el
index 5070bb0c8ac..fe28ed776b2 100644
--- a/lisp/progmodes/project.el
+++ b/lisp/progmodes/project.el
@@ -313,6 +313,10 @@ pattern to search for."
 
 ;;;###autoload
 (defun project-find-file ()
+  "Visit a file in the current project's roots.
+
+This is like `find-file', but it limits the file-name completion
+candidates to the files within the current project roots."
   (interactive)
   (let* ((pr (project-current t))
          (dirs (project-roots pr)))
@@ -320,6 +324,10 @@ pattern to search for."
 
 ;;;###autoload
 (defun project-or-external-find-file ()
+  "Visit a file in the current project's roots or external roots.
+
+This is like `find-file', but it limits the file-name completion
+candidates to the files within the current project roots and external roots."
   (interactive)
   (let* ((pr (project-current t))
          (dirs (append