gnustep/libs-steptalk
0
0
Fork 0
mirror of https://github.com/gnustep/libs-steptalk.git synced 2025-02-13 23:21:05 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
StepTalk is a scripting framework for creating scriptable servers or applications.
292 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
Wolfgang Lux 93caa89228 Unconditionally specify dependent libraries while linking StepTalk framework
2020-06-29 00:08:00 +02:00
Applications/ScriptPapers Update to current StepTalk framework methods. 2013-03-23 19:00:43 +00:00
ApplicationScripting StepTalk scripts panel: int->NSInteger transition 2013-05-26 16:03:29 +00:00
Documentation update deprecated and removed selectors in the documentation 2018-03-20 21:05:48 +00:00
Examples StepTalk tools and examples: int->NSInteger transition 2013-05-26 16:01:34 +00:00
Finders Updated to use GNUSTEP_LIBRARY instead of GNUSTEP_INSTALLATION_DIR/Library 2007-02-14 12:34:00 +00:00
Frameworks Unconditionally specify dependent libraries while linking StepTalk framework 2020-06-29 00:08:00 +02:00
Languages Use numberWithBool: when pushing true and false values onto the stack. 2019-03-27 09:22:10 +01:00
Modules StepTalk module bundles: int->NSInteger transition 2013-05-26 15:58:39 +00:00
Testing added distant scripting test 2005-09-05 20:38:41 +00:00
Tools Use NULL instead of NO where a pointer argument is expected 2017-12-27 18:28:47 +01:00
.cvsignore added includeBundle 2003-01-22 21:52:01 +00:00
.dist-ignore minor version update 2005-09-05 20:14:11 +00:00
ChangeLog Unconditionally specify dependent libraries while linking StepTalk framework 2020-06-29 00:08:00 +02:00
COPYING Changed license to LGPL 2004-04-25 18:18:17 +00:00
GNUmakefile warn if gnustep-make not found 2010-09-10 14:00:14 +00:00
GNUmakefile.postamble Initial revision 2002-05-13 22:13:06 +00:00
NEWS update to 0.10.0 2005-09-05 20:31:08 +00:00
README Updated StepTalk home page 2004-06-01 19:50:27 +00:00
TODO New methods to construct rectangles from points and sizes. 2012-01-15 17:33:48 +00:00
Version minor version update 2005-09-05 20:14:11 +00:00
WISH Updated StepTalk home page 2004-06-01 19:50:27 +00:00

README 

StepTalk
--------

Ahthor: Stefan Urbanek (Google the name for contact)
License: LGPL (see file COPYING)


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?
----------------

StepTalk requires GNUstep http://www.gnustep.org

You can download StepTalk from 

    http://www.gnustep.org/experience/StepTalk.html

Documentation for users and developers:

    http://wiki.gnustep.org/index.php/Scripting


Installation
------------

You need to have GNUstep which you can get from http://www.gnustep.org

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

If something goes wrong while build process and it is not while building in the
Source directory, then try to do make and make install in that directory first. 
In any case of problem, do not hesitate to contact the author.

StepTalk Shell is included in Examples/Shell directory. It requires libncurses.

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

    stshell - StepTalk shell - interactive tool (in Examples/Shell)
    
    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
--------
Send comments, questions and suggestions to: discus-gnustep@gnu.org

Send bug reports to: bug-gnustep@gnu.org