[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] feature/stdout-stderr-stream 3671082 2/3: Doc update
From: |
Phillip Lord |
Subject: |
[Emacs-diffs] feature/stdout-stderr-stream 3671082 2/3: Doc update |
Date: |
Wed, 28 Dec 2016 16:38:12 +0000 (UTC) |
branch: feature/stdout-stderr-stream
commit 3671082368082a54f8359798515ee1f16064d47e
Author: Phillip Lord <address@hidden>
Commit: Phillip Lord <address@hidden>
Doc update
---
doc/lispref/streams.texi | 21 ++++++++++++++++++++-
1 file changed, 20 insertions(+), 1 deletion(-)
diff --git a/doc/lispref/streams.texi b/doc/lispref/streams.texi
index 41bc71e..acc5400 100644
--- a/doc/lispref/streams.texi
+++ b/doc/lispref/streams.texi
@@ -142,7 +142,7 @@ A symbol as input stream is equivalent to the symbol's
function
definition (if any).
@end table
- Here is an example of reading from a stream that is a buffer, showing
+Here is an example of reading from a stream that is a buffer, showing
where point is located before and after:
@example
@@ -530,6 +530,25 @@ Now we can put the output in the proper order by reversing
the list:
Calling @code{concat} converts the list to a string so you can see its
contents more clearly.
+Two functions which are specifically designed for use as output
+streams:
+
address@hidden @asis
address@hidden @code{stdout} output stream
address@hidden @var{stdout}
+Prints to the system standard output (as opposed to the
address@hidden), regardless of whether Emacs is running
+interactively or not.
+
address@hidden @var{stderr} output stream
+Prints to the system standard error, regardless of whether Emacs is
+running interactively or not.
address@hidden table
+
+These functions are predominately useful for debugging, as they are a
+mechanism for producing output that does not change any buffer.
+
+
@node Output Functions
@section Output Functions