More doc fixes.

* lisp/minibuffer.el (read-file-name): Doc fix.

* character.c (Fcharacterp): Doc fix (Bug#12076).

* data.c (Findirect_variable): Doc fix (Bug#11040).

* editfns.c (Fsave_current_buffer): Doc fix (Bug#11542).

Fixes: debbugs:11542 debbugs:11040 debbugs:12076 debbugs:10881

4 files changed, 16 insertions, 6 deletions

diff --git a/src/ChangeLog b/src/ChangeLog
index 22f2ca18775..956d6922d2e 100644
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,8 +1,13 @@
 2012-08-14  Chong Yidong  <cyd@gnu.org>
 
+        * character.c (Fcharacterp): Doc fix (Bug#12076).
+
+        * data.c (Findirect_variable): Doc fix (Bug#11040).
+
         * chartab.c (Fmap_char_table): Doc fix (Bug#12061).
 
         * editfns.c (Fformat): Doc fix (Bug#12059).
+        (Fsave_current_buffer): Doc fix (Bug#11542).
 
 2012-08-14  Barry OReilly  <gundaetiapo@gmail.com>  (tiny change)
 
diff --git a/src/character.c b/src/character.c
index bdb0eead740..b2acf36ec15 100644
--- a/src/character.c
+++ b/src/character.c
@@ -258,6 +258,9 @@ multibyte_char_to_unibyte_safe (int c)
 
 DEFUN ("characterp", Fcharacterp, Scharacterp, 1, 2, 0,
        doc: /* Return non-nil if OBJECT is a character.
+In Emacs Lisp, characters are represented by character codes, which
+are non-negative integers.  The function `max-char' returns the
+maximum character code.
 usage: (characterp OBJECT)  */)
   (Lisp_Object object, Lisp_Object ignore)
 {
diff --git a/src/data.c b/src/data.c
index 3e278e8bac3..d0ef5734abc 100644
--- a/src/data.c
+++ b/src/data.c
@@ -808,10 +808,12 @@ indirect_variable (struct Lisp_Symbol *symbol)
 
 DEFUN ("indirect-variable", Findirect_variable, Sindirect_variable, 1, 1, 0,
        doc: /* Return the variable at the end of OBJECT's variable chain.
-If OBJECT is a symbol, follow all variable indirections and return the final
-variable.  If OBJECT is not a symbol, just return it.
-Signal a cyclic-variable-indirection error if there is a loop in the
-variable chain of symbols.  */)
+If OBJECT is a symbol, follow its variable indirections (if any), and
+return the variable at the end of the chain of aliases.  See Info node
+`(elisp)Variable Aliases'.
+
+If OBJECT is not a symbol, just return it.  If there is a loop in the
+chain of aliases, signal a `cyclic-variable-indirection' error.  */)
   (Lisp_Object object)
 {
   if (SYMBOLP (object))
diff --git a/src/editfns.c b/src/editfns.c
index 806c80c1936..5ac012c8378 100644
--- a/src/editfns.c
+++ b/src/editfns.c
@@ -946,8 +946,8 @@ usage: (save-excursion &rest BODY)  */)
 }
 
 DEFUN ("save-current-buffer", Fsave_current_buffer, Ssave_current_buffer, 0, UNEVALLED, 0,
-       doc: /* Save the current buffer; execute BODY; restore the current buffer.
-Executes BODY just like `progn'.
+       doc: /* Record which buffer is current; execute BODY; make that buffer current.
+BODY is executed just like `progn'.
 usage: (save-current-buffer &rest BODY)  */)
   (Lisp_Object args)
 {