cvsuser 01/09/25 16:54:11
Modified: docs parrot_assembly.pod
Log:
Added in the base for threading, I/O, and interpreter creation. Skeleton
only, but it's something to peer at.
Revision Changes Path
1.4 +76 -6 parrot/docs/parrot_assembly.pod
Index: parrot_assembly.pod
===================================================================
RCS file: /home/perlcvs/parrot/docs/parrot_assembly.pod,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -w -r1.3 -r1.4
--- parrot_assembly.pod 2001/09/17 23:35:53 1.3
+++ parrot_assembly.pod 2001/09/25 23:54:11 1.4
@@ -9,9 +9,9 @@
Maintainer: Dan Sugalski
Class: Internals
PDD Number: 6
- Version: 1.3
+ Version: 1.4
Status: Developing
- Last Modified: 12 September 2001
+ Last Modified: 24 September 2001
PDD Format: 1
Language:English
@@ -19,6 +19,10 @@
=over 4
+=item Version 1.4
+
+September 24, 2001
+
=item Version 1.3
September 12, 2001
@@ -41,6 +45,20 @@
=over 4
+=item Version 1.4
+
+=over 4
+
+=item * Conditional branches have just a true destination now
+
+=item * Added the I/O ops
+
+=item * Added in the threading ops
+
+=item * Added in the interpreter ops
+
+=back
+
=item Version 1.3
=over 4
@@ -98,7 +116,7 @@
Conditional branches take the format:
- code boolean, bool_key, true_dest, false_dest
+ code boolean, bool_key, true_dest
The key parameters are optional, and may be either an integer or a
string. If either is passed they are associated with the parameter to
@@ -170,10 +188,9 @@
=over 4
-=item if tx, X, Y
+=item if tx, X
-Check register tx. (Px, Sx, Ix, or Nx) If true, branch by X, otherwise
-branch by Y.
+Check register tx. (Px, Sx, Ix, or Nx) If true, branch by X.
=item jump tx
@@ -558,6 +575,59 @@
Find the string library that handles strings of type Y. Return its
name in X.
+
+=back
+
+=head2 I/O operations
+
+=over 4
+
+=item new_fh px
+
+Create a new filehandle px
+
+=item open px, sy
+
+Open the file Y on filehandle X
+
+=item read px, py
+
+Issue a read on the filehandle in Y, and put the result in PMC
+X.
+
+=item readw px, py
+
+=item write px, sy
+
+=item writew px, sy
+
+=item seek px, ty
+
+=item seekw px, ty
+
+=item tell tx, py
+
+=item wait px
+
+=back
+
+=head2 Threading ops
+
+=head2 Interpreter ops
+
+=over 4
+
+=item * newinterp Px, flags
+
+Create a new interpreter in X, using the passed flags.
+
+=item * callout Pw, Px, sy, pz
+
+Call routine Y in interpreter x, passing it the list of parameters
+Z. V is a synchronization object returned. It can be waited on like
+the sync objects returned from async I/O routines.
+
+=back
=head1 ATTACHMENTS
