Changeset 19851 for docs/Perl6/Spec

Timestamp:

02/08/08 22:18:37 (10 months ago)

Author:

buchetc

Message:

Some new heads and code formats

Files:

• docs/Perl6/Spec/Concurrency.pod (modified) (6 diffs)

docs/Perl6/Spec/Concurrency.pod

@@ -14 +14 @@
  Maintainer: Elizabeth Mattijsen <liz@dijkmat.nl>
  Date: 13 Jun 2005
- Last Modified: 13 Nov 2005
+ Last Modified: 08 Feb 2008
  Number: 0
- Version: 1
+ Version: 2
 
 =head1 SKETCH
@@ -259 +259 @@
 the use of named parameters is therefore advisable.
 
-#######################################################################
-Below here still the more or less unorganized stuff
-
-CORE::GLOBAL::exit; # kills all the threads
-
-# We intentionally do not list cross-machine parallelism Conc:: classes here.
-# Consult your local 6PAN mirror with a time machine.
-use Conc::Processes; # fork() or createProcess based implementation
-use Conc::Threads;   # maybe it just exports &async to override the default one, yay
-use Conc::Multiplex; # this is default
-
-my $thr = async {
-    ...do something...
-    END { }
-};
-
-Conc::Thread.this
-Conc::Proc.this
+=head2 Threads
+
+
+=head3 Kill all
+
+   CORE::GLOBAL::exit; # kills all the threads
+
+
+=head3 Thread models 
+
+We intentionally do not list cross-machine parallelism Conc:: classes here.
+Consult your local 6PAN mirror with a time machine.
+
+   use Conc::Processes; # fork() or createProcess based implementation
+   use Conc::Threads;   # maybe it just exports &async to override the default one, yay
+   use Conc::Multiplex; # this is default
+
+   my $thr = async {
+       ...do something...
+       END { }
+   };
+
+   Conc::Thread.this
+   Conc::Proc.this
+
+=head3 Thread methods and attributes
 
 Conc object # name is still up for grabs!
-- numify to TIDs (as in pugs)
-- stringify to something sensible (eg. "<Conc:tid=5>");
-- enumerable with Conc.list
-- Conc.yield (if this is to live but deprecated, maybe call it sleep(0)?)
-- sleep() always respects other threads, thank you very much
-- standard methods:
+
+ - numify to TIDs (as in pugs)
+ - stringify to something sensible (eg. "<Conc:tid=5>");
+ - enumerable with Conc.list
+ - Conc.yield (if this is to live but deprecated, maybe call it sleep(0)?)
+ - sleep() always respects other threads, thank you very much
+ - standard methods:
     - .join    # wait for invocant to finish (always item cxt)
     - .die     # throw exception in the invocant thread
@@ -296 +305 @@
                # including wait (which will always return undef)
                # also needs to discard any atomicity context
-- attributes:
+ - attributes:
     - .started  # time
     - .finished # time
@@ -306 +315 @@
                 # the CC currently running in that thread
 
-- "is throttled" trait
+ - "is throttled" trait
 
     method throttled::trait_auxiliary:<is> ($limit=1, :$key=gensym()) {
@@ -325 +334 @@
     async { $f.b }
 
-- Thread::Status
+
+=head3 Thread status
+
 - IO objects and containers gets concurrency love!
     - $obj.wake_on_readable
@@ -343 +354 @@
 # unjoined threads will be joined at the beginning of the END block batch
 # of the parent thread that spawned them
+
+
+=head2 Still more or less unorganized stuff
+
 
 ### INTERFACE BARRIER ###