X-Git-Url: https://git.hcoop.net/bpt/emacs.git/blobdiff_plain/1259009aa17da6dc038afff96963f6d9bbd3b8e1..a4b0cca119b01dc55bad802ef696c857fe014482:/doc/lispref/streams.texi diff --git a/doc/lispref/streams.texi b/doc/lispref/streams.texi index 3669162440..f9fe787dfa 100644 --- a/doc/lispref/streams.texi +++ b/doc/lispref/streams.texi @@ -1,10 +1,8 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1994, 1998-1999, 2001-2012 Free Software Foundation, Inc. +@c Copyright (C) 1990-1994, 1998-1999, 2001-2012 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. -@setfilename ../../info/streams -@node Read and Print, Minibuffers, Debugging, Top -@comment node-name, next, previous, up +@node Read and Print @chapter Reading and Printing Lisp Objects @dfn{Printing} and @dfn{reading} are the operations of converting Lisp @@ -115,7 +113,7 @@ When it is called with one argument (always a character), @var{function} should save the argument and arrange to return it on the next call. This is called @dfn{unreading} the character; it happens when the Lisp reader reads one character too many and wants to ``put it back where it -came from.'' In this case, it makes no difference what value +came from''. In this case, it makes no difference what value @var{function} returns. @end itemize @@ -266,12 +264,6 @@ reader encountered the open parenthesis, decided that it ended the input, and unread it. Another attempt to read from the stream at this point would read @samp{()} and return @code{nil}. -@defun get-file-char -This function is used internally as an input stream to read from the -input file opened by the function @code{load}. Don't use this function -yourself. -@end defun - @node Input Functions @section Input Functions @@ -625,7 +617,7 @@ spacing between calls. @defun terpri &optional stream @cindex newline in print This function outputs a newline to @var{stream}. The name stands -for ``terminate print.'' +for ``terminate print''. @end defun @defun write-char character &optional stream @@ -702,9 +694,8 @@ The default is @code{t}, meaning display in the echo area. @defvar print-quoted If this is non-@code{nil}, that means to print quoted forms using -abbreviated reader syntax. @code{(quote foo)} prints as @code{'foo}, -@code{(function foo)} as @code{#'foo}, and backquoted forms print -using modern backquote syntax. +abbreviated reader syntax, e.g., @code{(quote foo)} prints as +@code{'foo}, and @code{(function foo)} as @code{#'foo}. @end defvar @defvar print-escape-newlines @@ -820,7 +811,6 @@ reader to produce an uninterned symbol. If non-@code{nil}, that means number continuously across print calls. This affects the numbers printed for @samp{#@var{n}=} labels and @samp{#@var{m}#} references. - Don't set this variable with @code{setq}; you should only bind it temporarily to @code{t} with @code{let}. When you do that, you should also bind @code{print-number-table} to @code{nil}. @@ -833,8 +823,8 @@ to bind it to @code{nil} when you bind @code{print-continuous-numbering}. @end defvar @defvar float-output-format -This variable specifies how to print floating point numbers. Its -default value is @code{nil}, meaning use the shortest output +This variable specifies how to print floating point numbers. The +default is @code{nil}, meaning use the shortest output that represents the number without losing information. To control output format more precisely, you can put a string in this