summaryrefslogtreecommitdiff
path: root/StepTalkShell/README
blob: 96bd5564c3acba9361b60b37f9f3e8f9fa8ec98e (plain)
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
stshell
-------

Author: Stefan Urbanek <urbanek@host.sk>


What is stshell?
-----------------
StepTalk Shell is an interactive tool for communicating with objects.

Features
--------
    - GNUstep classes and objects
    - command-line editing
    - TAB completition of named objects and selectors

For more information read included *.txt files.

Installation
------------
Requirements: StepTalk and the readline library (development files)

    > make 
    > make install

Running
-------
To run stshell with default language, run just

    > stshell
    
If you would like to use another language, then use

    > stshell -language AnotherLanguage
    
To use AppKit

    > stshell -environment AppKit

To use it as a distributed objects 'glue'

    > stshell -environment Distributed

The shell will greet you with 'Welcome to the StepTalk shell.' message.

    Welcome to the StepTalk shell.
    StepTalk > _

Now you may write statements in the language you have specified.

    StepTalk > Transcript showLine:'Current date is ', ((NSDate date) description)
    
If the line is too long, then you may use the backslash '\' character at the end
of the line to continue on the next line.

    StepTalk > Transcript showLine:'Current date is ', \
    ... ? ((NSDate date) description)

Objects history array
---------------------
All results from the expressions are stored in the 'Objects' array. The example
above can be written in more steps:

    StepTalk > ((NSDate date) description)
    0: 2002-05-29 22:41:57 +0200
    StepTalk > 'Current date is ', (Objects @ 0)
    1: Current date is 2002-05-29 22:41:57 +0200
    StepTalk > Transcript showLine: (Objects @ 1)
    Current date is 2002-05-29 22:41:57 +0200
    
To show all objects type:

    StepTalk > Shell listObjects
    Objects
       0: '2002-05-29 22:41:57 +0200' (GSCInlineString)
       1: 'Current date is 2002-05-29 22:41:57 +020...' (GSUnicodeString)

TAB completition
----------------
Here is an example of TAB completition.
    StepTalk > Tr<TAB> showL<TAB>:'Current date is ', ((NSDate date) desc<TAB>i<TAB>)

Feedback
--------
Any questions, comments and bug reports are velcome at
    
    urbanek@host.sk