forked from onflapp/libs-steptalk
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
112 lines (74 loc) · 3.09 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
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: [email protected]
Send bug reports to: [email protected]