This is a readme file for the first arexx version of origami !

!!! The arexx port is highly experimental !!!

There are two public origami ports, which can be used for arexx
applications.

{{{  normal arexx use
The normal arexx port (as planed) will have two different ways of
communication :
- first :starting arexx macros and returning to normal
  editing (without waiting for completion) and
- second:controlling origami from outside by sending OCL_macros
  (and some special commands) to the arexx port. This will happen
  during normal editing and may cause problems !

{{{  starting arexx macros
To start an arexx macro use the origami-function 'shell-command' and
type 'AREXX:<name of arexx-macro-file>', origami then will try to
start this file with the ending ".origami".
REMEMBER: the `AREXX:` at the beginning of the command string has to
be typed in uppercase letters to make clear, that the following command
should be sent to the arexx port but not be executed by a system shell.
}}}
{{{  controling origami
Origami can be controled trough the origami arexx port, which will be named
ORIGAMIxxxx, where xxxx is the task-address, you can get from the ORIPID
Enviroment-Variable.
}}}
}}}

There are two public origami ports, that can be used for arexx
applications.
{{{  port ORIGAMIxxxxxxxx
This port name will be the string ORIGAMI and a number, if the PORT origami
already exists. The number will be origami's task address, which you can
get from the enviroment variable ORIPID.

This port will expect command strings as mentioned above.
}}}
{{{  port Oxxxxxxx
This port name will be the character O and the task structure address.

This port is used for the communication between the TasksOrigami and
Origami_Arexx and will expect messages of the My_ArexxMessage type,
defined in amiga.h.
REMEMBER : This port is designed to be used only by Origami and is
private. Please note, that the specification of the messages
accepted by origami may be changed in future releases. If you want to
progamm an own application, that makes use of this port, contact me
for more information.
}}}

{{{  Current features of the Arexx port (version 1.6 gamma Arexx alpha)
The arexx feature is not programmed fully !

At this point only a part of the Oxxxxxx port is partially functional, no
actual arexx features work !
REMEMBER : The arexx feature is highly experimental at this point !
}}}

{{{  Commands
{{{  Commands from origami
The commands you can use from Origami are :
AREXX:$NAME                 will display the portname of this origami
AREXX:<name-of-script-file> will start the scriptfile :
                            <name-of-script.file>.ori
}}}
{{{  Commands for origami
You can send the following commands to the AREXX-Port of origami :
1. <ocl-function> : the ocl-function will be called, only the
            functions you can use by the keybind function
            (keybind function (keysequence)) and the defined macros
            can be used.
2. deffun : works like the keybind-deffun command and will define a
            macro, which can be executed by his name.
            (only exeption : test-char-set doesn't work)
}}}
}}}