Changeset 15170


Ignore:
Timestamp:
Jan 23, 2012, 5:12:09 PM (8 years ago)
Author:
rme
Message:

Document how standard lisp streams correspond to the
operating systems stdin/stdout/stderr.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/source/doc/src/streams.xml

    r14835 r15170  
    10871087    </sect2>
    10881088  </sect1>
     1089  <sect1>
     1090    <title>Lisp Standard Streams and OS Standard Streams</title>
     1091    <para>
     1092      In normal interactive usage, the input and output sides of the
     1093      bidirectional stream <literal>*terminal-io*</literal> are hooked
     1094      up to the the operating system's standard input and standard
     1095      output.  The lisp streams <literal>*standard-input*</literal>,
     1096      <literal>*standard-output*</literal>, and
     1097      <literal>*error-output*</literal> are synonym streams for
     1098      <literal>*terminal-io*</literal>.
     1099    </para>
     1100    <para>
     1101      In batch mode, this arrangement is modified slightly.  The lisp
     1102      streams <literal>*standard-input*</literal>,
     1103      <literal>*standard-output*</literal>, and
     1104      <literal>*standard-error*</literal> correspond directly to the
     1105      operating system's standard input, standard output, and standard
     1106      error.  If the lisp can determine that it has access to an
     1107      operating system tty, then <literal>*terminal-io*</literal> will
     1108      be hooked up to that.  Otherwise, the input and output streams
     1109      of <literal>*terminal-io*</literal> will correspond to the
     1110      operating system's standard input and standard output.
     1111    </para>
     1112  </sect1>
    10891113</chapter>
Note: See TracChangeset for help on using the changeset viewer.