Doc fixes.

* lisp/filenotify.el (file-notify-add-watch): Refine doc string.

* doc/lispref/os.texi (File Notifications): Add an index.

* doc/lispref/loading.texi (Loading): Add an cross-reference.

6 files changed, 16 insertions, 1 deletions

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index b35358366e3..e298f79d1c0 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,9 @@
+2013-11-19  Xue Fuqiao  <xfq.free@gmail.com>
+
+        * os.texi (File Notifications): Add an index.
+
+        * loading.texi (Loading): Add an cross-reference.
+
 2013-11-18  Xue Fuqiao  <xfq.free@gmail.com>
 
         * os.texi (Session Management, Desktop Notifications): Add some
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index 944a1e37cc4..36c6aa5e5ee 100644
--- a/doc/lispref/files.texi
+++ b/doc/lispref/files.texi
@@ -1663,6 +1663,8 @@ version of an existing file; saving a file preserves its existing
 permissions.
 @end defun
 
+@c FIXME: The return value is decimal?  Octal?  We should explain it
+@c further.  --xfq
 @defun default-file-modes
 This function returns the default file permissions, as an integer.
 @end defun
diff --git a/doc/lispref/loading.texi b/doc/lispref/loading.texi
index 637057c99b0..07dbce21cb2 100644
--- a/doc/lispref/loading.texi
+++ b/doc/lispref/loading.texi
@@ -29,6 +29,8 @@ into a buffer and evaluated there.  (Indeed, most code is tested this
 way.)  Most often, the forms are function definitions and variable
 definitions.
 
+For on-demand loading of external libraries, @pxref{Dynamic Libraries}.
+
 @menu
 * How Programs Do Loading:: The @code{load} function and others.
 * Load Suffixes::           Details about the suffixes that @code{load} tries.
diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
index c0e029be912..ed9b8b93a89 100644
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -2526,6 +2526,7 @@ specification prior to @samp{"1.0"}.
 @node File Notifications
 @section Notifications on File Changes
 @cindex file notifications
+@cindex watch, for filesystem events
 
 Several operating systems support watching of filesystems for changes
 of files.  If configured properly, Emacs links a respective library
diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 2efec7efe99..9ad7e8a7d79 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,7 @@
+2013-11-19  Xue Fuqiao  <xfq.free@gmail.com>
+
+        * filenotify.el (file-notify-add-watch): Doc fix.
+
 2013-11-19  Leo Liu  <sdl.web@gmail.com>
 
         * obsolete/rcompile.el: Mark obsolete.
diff --git a/lisp/filenotify.el b/lisp/filenotify.el
index 5a5435bb4cb..c980d720714 100644
--- a/lisp/filenotify.el
+++ b/lisp/filenotify.el
@@ -207,7 +207,7 @@ include the following symbols:
                         permissions or modification time
 
 If FILE is a directory, 'change' watches for file creation or
-deletion in that directory.
+deletion in that directory.  This does not work recursively.
 
 When any event happens, Emacs will call the CALLBACK function passing
 it a single argument EVENT, which is of the form