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.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index b35358366e3ffafa359af871606a61ef786f38e8..e298f79d1c034f864aa948e6c3e93bb69d452d46 100644 (file)
--- 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 944a1e37cc4c4f88aea6e3257325994f45cf85c9..36c6aa5e5eee3eada719bcf86efdbca162daa797 100644 (file)
--- 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 637057c99b0348653a539ed376d2d771acc79e3a..07dbce21cb2856977719768cd4f00ec2514b1d6b 100644 (file)
--- 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 c0e029be912f2ed350c43a5546b7e9b7a0a7cfd4..ed9b8b93a8930abd757e594df541604287917b42 100644 (file)
--- 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 2efec7efe990c2a13fe39147144b8a78d5925cb0..9ad7e8a7d79ebe132280e6013bda936fabd9634e 100644 (file)
--- 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 5a5435bb4cb474f692edfd2ed1c4f67801148408..c980d7207147f95a27998d014260161059b0c961 100644 (file)
--- 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