StepTalk is a scripting framework for creating scriptable servers or applications.
Find a file
Stefan Urbanek 54bb5b32d2 Added .cvsignore files
git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/steptalk/trunk@14479 72102866-910b-0410-8b05-ffd578937521
2002-09-17 13:00:16 +00:00
Documentation Scripts manager added 2002-06-21 22:40:59 +00:00
Examples Added .cvsignore files 2002-09-17 13:00:16 +00:00
Finders Added .cvsignore files 2002-09-17 13:00:16 +00:00
Languages Added .cvsignore files 2002-09-17 13:00:16 +00:00
Modules Added .cvsignore files 2002-09-17 13:00:16 +00:00
Source Added .cvsignore files 2002-09-17 13:00:16 +00:00
Testing/Smalltalk Code cleanup 2002-06-14 08:42:00 +00:00
Tools Added .cvsignore files 2002-09-17 13:00:16 +00:00
.cvsignore Added .cvsignore files 2002-09-17 13:00:16 +00:00
.dist-ignore Patch from Deek 2002-09-17 12:40:41 +00:00
ChangeLog Added .cvsignore files 2002-09-17 13:00:16 +00:00
COPYING Initial revision 2002-05-13 22:13:06 +00:00
COPYING.LIB Initial revision 2002-05-13 22:13:06 +00:00
GNUmakefile Added object finders 2002-06-04 17:59:06 +00:00
GNUmakefile.postamble Initial revision 2002-05-13 22:13:06 +00:00
NEWS Fixed AppKit constants 2002-09-15 10:22:15 +00:00
README Finders updated 2002-06-08 19:05:34 +00:00
TODO Scripts manager added 2002-06-21 22:40:59 +00:00
Version Fixed AppKit constants 2002-09-15 10:22:15 +00:00

StepTalk
--------

Ahthor: Stefan Urbanek  <urbanek@host.sk>


What is StepTalk ?
------------------

StepTalk is a scripting framework for creating scriptable servers or
applications. StepTalk, when combined with the dynamism that the Objective-C
language provides, goes way beyond mere scripting.  It is written using
GNUstep.


Where to get it?
----------------

You can download StepTalk from 

    http://steptalk.host.sk


Installation
------------
To install StepTalk type:

    > make
    > make install

If you do not want to build AppKit extensions, then type

    > make appkit=no
    > make appkit=no install

Tools
-----
    stexec - execute a StepTalk script in the GNUstep Foundation environment
    stalk  - talk to named server
    stupdate_languages - update the available languages info

    Predefined objects for executing scripts by 'stexec'
    
        Args          - command line arguments
        Engine        - scripting engine
        Environment   - scripting environment

        Transcript    - simple transcript


Sripting environment description
-------------------------------------------

Scripting environment description is used to translate the method names and/or
allow or deny the methods for concrete classes. Denying methods can be used to
create safe scripting  environment as prevention against script viruses.

It contains:
    - list of methods, that are available for scripting for particular class
    - symbolic selector (operator) to selector mapping
    - list of modules to be loaded
    - list of object finders


Standard vs. full scripting
---------------------------
Before each message send, selector is translated using scipting description.
When standard scripting is used and there is no such selector avilable for
scripting for target object, then an exception is raised. With full scripting,
any message should be sent to any target object.

Files
-----
    StepTalk is looking for its files in GNUSTEP_*_ROOT/Library/StepTalk
    
    There should be these directories:
    
    Configuration - Configuration files        
    Environments  - Directory containig environment descriptions
    Finders       - Object finders
    Languages     - StepTalk language bundles
    Modules       - StepTalk modules
    Scripts       - Directory containig StepTalk scripts

Defaults
--------
See Documentation/Defaults.txt


Feedback
--------
Any bug reports and comments are welcome at
<urbanek@host.sk>