Changeset 21010 in project


Ignore:
Timestamp:
10/25/10 04:04:15 (11 years ago)
Author:
Kon Lovett
Message:

Release

Location:
wiki/eggref/4
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • wiki/eggref/4/thread-utils

    r20955 r21010  
    3939<procedure>(thread-reaper-timeout SECONDS)</procedure>
    4040
    41 Gets and sets the number of seconds to wait for a thread to quit.
    42 
    43 Default is {{5.0}}.
     41Gets and sets the number of seconds to wait for a thread to quit. The default
     42is {{#f}} or wait till termination. Should threads submitted to the reaper be
     43known to "run off with the cpu" then something other than wait forever is
     44warranted.
    4445
    4546==== thread-reaper-retries
     
    8586(require-extension thread-utils)
    8687</enscript>
    87 
    88 ==== print-exception-warning
    89 
    90 <procedure>(print-exception-warning EXN [THREAD [PORT]])</procedure>
    91 
    92 Invokes {{print-exception-error}} when warnings are enabled. This routine
    93 duplicates the uncaught exception in a thread handling behavior of Chicken.
    94 Useful for caught exceptions that cannot in fact be handled.
     88==== print-exception-error
     89
     90<procedure>(print-exception-error EXN [THREAD [PORT]])</procedure>
     91
     92Prints the error {{EXN}} and the current call chain. The message header is
     93supplied by {{thread-warning-message}}. This routine duplicates the uncaught
     94exception in a thread handling behavior of Chicken. Useful for caught
     95exceptions that cannot in fact be handled.
    9596
    9697The {{EXN}} is a {{condition}} or any other object.
     
    9899The default for {{PORT}} is the {{(current-error-port)}}.
    99100
    100 ==== print-exception-error
    101 
    102 <procedure>(print-exception-error EXN [THREAD [PORT]])</procedure>
    103 
    104 Prints the error {{EXN}} and the current call chain. The message header
    105 is supplied by {{thread-warning-message}}.
     101==== print-exception-warning
     102
     103<procedure>(print-exception-warning EXN [THREAD [PORT]])</procedure>
     104
     105Invokes {{print-exception-error}} when warnings are enabled.
    106106
    107107The {{EXN}} is a {{condition}} or any other object.
     
    195195
    196196Currently only threads blocked for timeout can be unblocked. Threads blocked
    197 for termination or I/O are skipped.
     197for any other reason are ignored.
    198198
    199199
  • wiki/eggref/4/timed-resource

    r20955 r21010  
    2121end of its' life.
    2222
    23 The {{OPENER}} is a {{(procedure () *)}} returning the resource.
     23The {{OPENER}} is a {{(procedure () *)}} returning the resource object.
    2424
    25 The {{CLOSER}} is a {{(procedure (*))}} taking a resource returned by the
    26 {{OPENER}}.
     25The {{CLOSER}} is a {{(procedure (*))}} taking a resource object returned by
     26the {{OPENER}}.
    2727
    2828The {{NAME}} is used as a prefix for the generated unique identifier of the
    29 created {{timed-resource}} and is usually a {{string}} or {{symbol}}.
     29created {{timed-resource}} and is usually a {{string}} or {{symbol}}. There is
     30no semantic content.
     31
     32No attempt is made to serialize access to a resource, this is up to the caller;
     33just don't share the thing.
     34
     35Exceptions occurring during resource acquisition or release abort the
     36operation. Exceptions during resource release at shutdown are just displayed
     37but no further action is taken.
    3038
    3139=== with-timed-resource
     
    3745of the {{with-timed-resource}} invocation.
    3846
    39 Exceptions occurring during resource acquisition abort the operation. Exceptions
    40 during resource release are caught and displayed but no further action is
    41 taken.
     47{{ACTION}} is a {{(procedure (timed-resource) *)}}.
    4248
    4349=== timed-resource?
     
    5864<procedure>(timed-resource-timeout SECONDS) => </procedure>
    5965
    60 Gets & sets the number of seconds to wait for a thread to quit. Only used at
    61 shutdown.
     66Gets & sets the number of seconds to wait for a thread to quit.
    6267
    63 Default is {{1.0}}.
     68Default is {{#f}}.
     69
     70Currently only used at shutdown.
    6471
    6572
     
    99106== Requirements
    100107
    101 [[miscmacros]]
     108[[thread-utils]]
    102109[[synch]]
    103110[[record-variants]]
Note: See TracChangeset for help on using the changeset viewer.