Fix documentation of 'unprintable' stuff

* src/print.c (syms_of_print) <print-unreadable-function>:
* doc/lispref/streams.texi (Input Functions, Output Variables):
Improve the documentation of 'print-unreadable-function' and
'readablep'.  Add indexing and cross-references.

1 files changed, 5 insertions, 5 deletions

diff --git a/src/print.c b/src/print.c
index 4d9feb55ac2..e9a83d6d5dc 100644
--- a/src/print.c
+++ b/src/print.c
@@ -2498,15 +2498,15 @@ priorities.  Values other than nil or t are also treated as
   staticpro (&print_prune_charset_plist);
 
   DEFVAR_LISP ("print-unreadable-function", Vprint_unreadable_function,
-               doc: /* Function called when printing unreadable objects.
+               doc: /* If non-nil, a function to call when printing unreadable objects.
 By default, Emacs printing functions (like `prin1') print unreadable
-objects like \"#<...>\", where \"...\" describes the object (for
+objects as \"#<...>\", where \"...\" describes the object (for
 instance, \"#<marker in no buffer>\").  If this variable is non-nil,
 it should be a function which will be called to print the object instead.
 
-It will be called with two arguments: The object to be printed, and
-noescape (see `prin1-to-string').  If this function returns nil, the
-object will be printed as normal.  If it returns a string, that string
+The function will be called with two arguments: the object to be printed, and
+the NOESCAPE flag (see `prin1-to-string').  If this function returns nil, the
+object will be printed as usual.  If it returns a string, that string
 will then be printed.  If the function returns anything else, the
 object will not be printed.  */);
   Vprint_unreadable_function = Qnil;