[racket-dev] Want to add an example to reference docs

On Dec 30, 2012, at 8:27 AM, Matthew Flatt wrote:

> At Sat, 29 Dec 2012 23:26:56 -0800, Danny Yoo wrote:
>> I'd like to add something like the following example to the third
>> paragraph of section 1.1.16 on the implications on custodian shutdown:
>> 
>>    https://gist.github.com/4411396
>> 
>> 
>> Otherwise, without the example, it's easy to misinterpret the sentence:
>> 
>>    "If the current custodian is shut down before a procedure is
>> called to create a managed resource (e.g., open-input-port, thread),
>> the exn:fail:contract exception is raised."
>> 
>> to imply that closing a custodian with no associated resources to
>> raise an exception.
>> 
>> 
>> Alternatively, can we rephrase that sentence to the following?
>> 
>>    "Once the current custodian is shut down, if a procedure is called
>> that attempts to create a managed resource (e.g., open-input-port,
>> thread), then the exn:fail:contract is raised."
> 
> Both of those changes look good, except that I recommend "After"
> instead of "Once".
> 
> _________________________
>  Racket Developers list:
>  http://lists.racket-lang.org/dev



May I propose 

    "After the current custodian is shut down, a exn:fail:contract exception is raised if the program attempts to create a managed resource, e.g., an input-port or a thread."