[racket] Racket Doc / Places

From: Kevin Tew (tewk at cs.utah.edu)
Date: Mon Nov 5 11:01:25 EST 2012

Here is the documentation patch I came up with.

diff --git a/collects/scribblings/reference/places.scrbl 
b/collects/scribblings/reference/places.scrbl
index 114fc8a..273fb4e 100644
--- a/collects/scribblings/reference/places.scrbl
+++ b/collects/scribblings/reference/places.scrbl
@@ -141,14 +141,15 @@ are simulated using @racket[thread].}
   @racket[start-proc] returns, then the place terminates with the
   @tech{completion value} @racket[0].

- In the created place, the @racket[current-input-port] parameter
- is set to an empty input port, while the values of the
+ In the created place, the @racket[current-input-port] parameter is
+ set to an empty input port, while the values of the
   @racket[current-output-port] and @racket[current-error-port]
- parameters are connected to the current ports in the creating
- place. If the output ports are @tech{file-stream ports}, then the
- connected ports in the places share the underlying stream, otherwise
- a @tech{thread} in the creating place pumps bytes to the current
- ports in the creating place.
+ parameters are connected to the current ports in the creating place.
+ If the output ports in the creating place are @tech{file-stream
+ ports}, then the connected ports in the created place share the
+ underlying streams, otherwise a @tech{thread} in the creating place
+ pumps bytes from the created place's ports to the current ports in the
+ creating place.

   The @racket[module-path] argument must not be a module path of the
   form @racket[(#,(racket quote) _sym)] unless the module is predefined 
(see



On 11/05/2012 08:52 AM, Kevin Tew wrote:
> On 11/05/2012 08:23 AM, Ray Racine wrote:
>> "If the output ports are file-stream ports 
>> <file:///usr/local/racket/doc/reference/file-ports.html?q=places#%28tech._file._stream._port%29>, 
>> then the connected ports in the places share the underlying stream, 
>> otherwise a thread 
>> <file:///usr/local/racket/doc/reference/eval-model.html?q=places#%28tech._thread%29> in 
>> the creating place pumps bytes to the current ports in the creating 
>> place."
>>
>> Should that be "..., otherwise a thread in the created place pumps 
>> bytes to the current ports in the creating place." ??
>>
>>
>> ____________________
>>    Racket Users list:
>>    http://lists.racket-lang.org/users
> No I think its right.
>
> I've added some extra text in CAPS to clarify things.
> I'll make some improvements to the docs as well.
>
> Kevin
>
> "If the CREATING PLACE'S output ports are file-stream ports 
> <file:///usr/local/racket/doc/reference/file-ports.html?q=places#%28tech._file._stream._port%29>, 
> then the connected ports in CREATED places share the underlying 
> streams, otherwise a thread 
> <file:///usr/local/racket/doc/reference/eval-model.html?q=places#%28tech._thread%29> in 
> the creating place pumps bytes FROM THE CREATED PLACE PORTS to the 
> current ports in the creating place."
>
>
> ____________________
>    Racket Users list:
>    http://lists.racket-lang.org/users

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.racket-lang.org/users/archive/attachments/20121105/4b5738fa/attachment.html>

Posted on the users mailing list.