libs-steptalk/Examples/Shell
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
..
.cvsignore Added .cvsignore files 2002-09-17 13:00:16 +00:00
AppKit.txt Shell split 2002-06-07 22:11:01 +00:00
ChangeLog Scripts manager added 2002-06-21 22:40:59 +00:00
GNUmakefile Shell split 2002-06-07 22:11:01 +00:00
README 0.6.0 2002-06-09 13:33:35 +00:00
STShell+output.m Scripts manager added 2002-06-21 22:40:59 +00:00
STShell.h Patch from Deek 2002-09-17 12:40:41 +00:00
STShell.m Patch from Deek 2002-09-17 12:40:41 +00:00
stshell.m Fixed AppKit constants 2002-09-15 10:22:15 +00:00
Unix.txt Shell split 2002-06-07 22:11:01 +00:00

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


Installation
------------
Requirements: StepTalk and readline library

    > 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