From a6e3a5d5d5f56c5f523f65e42fa76aa22e0adcf1 Mon Sep 17 00:00:00 2001 From: Xue Fuqiao Date: Tue, 19 Nov 2013 17:47:02 +0800 Subject: [PATCH] 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. --- doc/lispref/ChangeLog | 6 ++++++ doc/lispref/files.texi | 2 ++ doc/lispref/loading.texi | 2 ++ doc/lispref/os.texi | 1 + lisp/ChangeLog | 4 ++++ lisp/filenotify.el | 2 +- 6 files changed, 16 insertions(+), 1 deletion(-) 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 + + * os.texi (File Notifications): Add an index. + + * loading.texi (Loading): Add an cross-reference. + 2013-11-18 Xue Fuqiao * 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 + + * filenotify.el (file-notify-add-watch): Doc fix. + 2013-11-19 Leo Liu * 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 -- 2.39.2