gnustep/libs-steptalk
0
0
Fork 0
mirror of https://github.com/gnustep/libs-steptalk.git synced 2025-02-21 02:31:01 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
StepTalk is a scripting framework for creating scriptable servers or applications.
44 commits 3 branches 13 tags 1 MiB
Objective-C 91.3%
Makefile 5.1%
Yacc 2.1%
Smalltalk 1%
C 0.3%
Find a file
Stefan Urbanek fa3b61881b Added Tools.txt 
git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/steptalk/trunk@15604 72102866-910b-0410-8b05-ffd578937521
2003-01-15 19:45:41 +00:00
Documentation Added Tools.txt 2003-01-15 19:45:41 +00:00
Examples Fixed misleading help 2003-01-15 19:45:03 +00:00
Finders Added parser for real numbers 2002-12-21 22:13:15 +00:00
Languages Version change 2003-01-15 08:29:05 +00:00
Modules GDL2.stenv added 2003-01-15 19:36:01 +00:00
Source Added GDL2 module 2002-11-29 12:41:33 +00:00
Testing/Smalltalk Added parser for real numbers 2002-12-21 22:13:15 +00:00
Tools Added .cvsignore files 2002-09-17 13:00:16 +00:00
.cvsignore Updated .cvsignore 2002-12-25 21:20:26 +00:00
.dist-ignore Updated .cvsignore 2002-12-25 21:20:26 +00:00
ChangeLog Added Tools.txt 2003-01-15 19:45:41 +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 Added parser for real numbers 2002-12-21 22:13:15 +00:00
README Finders updated 2002-06-08 19:05:34 +00:00
TODO implementorsOfSelector: added 2002-11-11 21:45:46 +00:00
Version Version 0.6.2 2002-12-25 21:28:06 +00:00

README 

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>