libs-steptalk/Examples/Shell
David Ayers ddc9d205af * STEngine.h: Fixed declaration to match implementation to avoid
compiler warnings.
    * STEnvironment.h: Ditto.
    * STScriptsManager.h: Ditto.
    * STLanguage.h: Corrected declaration.
    * STScriptsManager.m: Added needed interface declaration.
    * GNUmakefile:  Added flags to show all warnings except for import.
    * Module/ObjectiveC/GNUmakefile:  Added flags to show all warnings
    except for import.
    * Module/Foundation/GNUmakefile:  Added flags to show all warnings
    except for import.
    * Module/AppKit/AppKitExceptions.m: Used variable to supress compiler
    warnings.
    * Module/AppKit/AppKitNotifications.m: Ditto.
    * Module/AppKit/GNUmakefile:  Added flags to show all warnings except
    for import.
    * Module/GDL2/GDL2Constants.m: Used variable to supress compiler
    warnings.
    * Module/GDL2/GNUmakefile: Added flags to show all warnings except
    for import.
    * Module/SimpleTranscripts/GNUmakefile: Added flags to show all warnings
    except for import.
    * Module/StepTalk/GNUmakefile: Added flags to show all warnings
    except for import.
    * Tools/stalk.m: Added needed interface declaration.
    * Tools/stupdate_languages.m: Corrected variable declaration and added
    cast.

ApplicationScripting
    * GNUmakefile: Added flags to be able to compile from the building
    directories and show all warnings except for import.
    * NSApplication+additions.m: Added import of needed headers.  Added
    interface declarations to supress compiler warnings.  Commented unused
    variables to supress compiler warnings.  Corrected variable types and
    added necessary casts.
    * STScriptingSupport.m: Added interface declaraions to supress
    compiler warnings.

Examples/Shell
    * GNUmakefile: Added flags to show all warnings except for import.
    * STShell.m: Unified name for private categories.

Examples/Server
    * ChangeLog: Added new file.
    * GNUmakefile: Added flags to show all warnings except for import.

Languages/Smalltalk/ChangeLog
    * GNUmakefile: Added flags to show all warnings except for import.
    * STBlock.m: Initialzed variables to supress compiler warnings.
    * STCompiledMethod.m: Added needed import.
    * STCompiler.m: Added missing declaration.  Wrapped declarations only
    needed for DEBUG into #ifdefs to supress compiler warnings.
    Initialzed variables to supress compiler warnings.
    * STExecutionContext.m: Unified name for private categories.


git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/steptalk/trunk@16351 72102866-910b-0410-8b05-ffd578937521
2003-04-04 10:57:04 +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 * STEngine.h: Fixed declaration to match implementation to avoid 2003-04-04 10:57:04 +00:00
GNUmakefile * STEngine.h: Fixed declaration to match implementation to avoid 2003-04-04 10:57:04 +00:00
README import NSException.h 2003-02-21 12:45:42 +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 * STEngine.h: Fixed declaration to match implementation to avoid 2003-04-04 10:57:04 +00:00
stshell.m import NSException.h 2003-02-21 12:45:42 +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

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