HCoop
/
bpt
/
emacs.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Small doc updates re initial-buffer-choice
[bpt/emacs.git]
/
doc
/
lispref
/
streams.texi
diff --git
a/doc/lispref/streams.texi
b/doc/lispref/streams.texi
index
af0a032
..
1d549ae
100644
(file)
--- a/
doc/lispref/streams.texi
+++ b/
doc/lispref/streams.texi
@@
-1,11
+1,9
@@
@c -*-texinfo-*-
@c This is part of the GNU Emacs Lisp Reference Manual.
@c -*-texinfo-*-
@c This is part of the GNU Emacs Lisp Reference Manual.
-@c Copyright (C) 1990
, 1991, 1992, 1993, 1994, 1998, 1999, 2001, 2002,
-@c
2003, 2004, 2005, 2006, 2007, 2008 Free Software
Foundation, Inc.
+@c Copyright (C) 1990
-1994, 1998-1999, 2001-2014 Free Software
+@c Foundation, Inc.
@c See the file elisp.texi for copying conditions.
@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
@chapter Reading and Printing Lisp Objects
@dfn{Printing} and @dfn{reading} are the operations of converting Lisp
@@
-116,7
+114,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
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
@var{function} returns.
@end itemize
@@
-267,12
+265,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}.
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
@node Input Functions
@section Input Functions
@@
-341,6
+333,12
@@
This variable holds the default input stream---the stream that
The default is @code{t}, meaning use the minibuffer.
@end defvar
The default is @code{t}, meaning use the minibuffer.
@end defvar
+@defvar read-circle
+If non-@code{nil}, this variable enables the reading of circular and
+shared structures. @xref{Circular Objects}. Its default value is
+@code{t}.
+@end defvar
+
@node Output Streams
@section Output Streams
@cindex stream (for printing)
@node Output Streams
@section Output Streams
@cindex stream (for printing)
@@
-620,7
+618,7
@@
spacing between calls.
@defun terpri &optional stream
@cindex newline in print
This function outputs a newline to @var{stream}. The name stands
@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
@end defun
@defun write-char character &optional stream
@@
-679,6
+677,12
@@
For example, if the current buffer name is @samp{foo},
returns @code{"The buffer is foo"}.
@end defmac
returns @code{"The buffer is foo"}.
@end defmac
+@defun pp object &optional stream
+This function outputs @var{object} to @var{stream}, just like
+@code{prin1}, but does it in a more ``pretty'' way. That is, it'll
+indent and fill the object to make it more readable for humans.
+@end defun
+
@node Output Variables
@section Variables Affecting Output
@cindex output-controlling variables
@node Output Variables
@section Variables Affecting Output
@cindex output-controlling variables
@@
-691,9
+695,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
@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
@end defvar
@defvar print-escape-newlines
@@
-794,8
+797,8
@@
Emacs-Lisp Expressions, emacs, The GNU Emacs Manual}).
and shared structure:
@defvar print-circle
and shared structure:
@defvar print-circle
-If non-@code{nil}, this variable enables detection of circular
-
and shared structure in printing
.
+If non-@code{nil}, this variable enables detection of circular
and
+
shared structure in printing. @xref{Circular Objects}
.
@end defvar
@defvar print-gensym
@end defvar
@defvar print-gensym
@@
-809,7
+812,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.
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}.
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}.
@@
-822,8
+824,8
@@
to bind it to @code{nil} when you bind @code{print-continuous-numbering}.
@end defvar
@defvar float-output-format
@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
that represents the number without losing information.
To control output format more precisely, you can put a string in this
@@
-831,7
+833,3
@@
variable. The string should hold a @samp{%}-specification to be used
in the C function @code{sprintf}. For further restrictions on what
you can use, see the variable's documentation string.
@end defvar
in the C function @code{sprintf}. For further restrictions on what
you can use, see the variable's documentation string.
@end defvar
-
-@ignore
- arch-tag: 07636b8c-c4e3-4735-9e06-2e864320b434
-@end ignore