Changeset 15273


Ignore:
Timestamp:
Mar 26, 2012, 8:08:56 PM (7 years ago)
Author:
gb
Message:

Clarify that a stream created with :SHARING :PRIVATE is "owned"
by the thread that first does I/O on the stream (not necessarily
the thread that created the stream.)

Mention that the implementation of RUN-PROGRAM uses a "monitoring"
thread and that this may introduce stream-sharing issues in some
cases.

Location:
trunk/source/doc/src
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • trunk/source/doc/src/external-process.xml

    r13118 r15273  
    253253            <para>Runs the specified program in an external (Unix) process,
    254254            returning an object of type EXTERNAL-PROCESS if successful.</para>
     255            <para>The implementation involves a lisp process/thread which
     256            monitors the status of this external process and arranges for
     257            the standard I/O descriptors for the external process to be
     258            connected to the specified lisp streams.  Since this may require
     259            the monitoring thread to do I/O on lisp streams in some cases,
     260            streams provided as the values of the <literal>:INPUT</literal>,
     261            <literal>:OUTPUT</literal>, and <literal>:ERROR</literal> arguments
     262            should not be private to some other lisp thread.</para>
    255263          </refsect1>
    256264        </refentry>
  • trunk/source/doc/src/streams.xml

    r15170 r15273  
    5858              <listitem>
    5959                <para>Specifies that the stream can only be accessed
    60                 by the thread that created it.  This is the default.
     60                by the thread that first tries to do I/O to it; that
     61                thread becomes the "owner" of the stream and
     62                is not necessarily the same thread as the one which
     63                created the stream.  This is the default.
    6164                (There was some discussion on openmcl-devel about the
    6265                idea of "transferring ownership" of a stream; this has
Note: See TracChangeset for help on using the changeset viewer.