

                        Okami Shell Version 1.0
                
                      K U R Z E I N F  H R U N G
                      
                            Stand: 27.3.90
              


Okami-Shell ist eine Unix-hnliche Kommandoshell fr alle Atari ST-Rechner.
Vorbild war die AIX-Shell des IBM RT PC 6150, deren Vorbild wiederum die
Unix-Bourne-Shell war.

Sie arbeitet:
        * mit jeder Speicherkonfiguration (auch mit 512K)
        * mit jeder Bildauflsung
        * mit Diskette, Ramdisk und Festplatte
        
Beschrnkungen:
        * der Start der Shell von Diskette ist mglich, aber wegen der
          geringen Geschwindigkeit wird Ramdisk oder Festplatte empfohlen.
        * Zur Benutzung der Pipe mu das Laufwerk, von dem die Shell
          gestartet wurde, beschreibbar sein.

Zum Starten der Shell
        * sh.ttp anklicken und als Parameter ein Minuszeichen angeben.
oder:   * msh.tos anklicken.
Die Shell erscheint dann im Dialogmodus. Zum Beenden der Shell exit
eingeben oder Ctrl V drcken.
Fr Hilfe help eingeben. Anhalten der Ausgabe mit Ctrl S, Wiederstarten
mit Ctrl Q.

        
Das wichtigste in Krze:
        * Standard-Unix-Kommandos: cat, ls, cd, pwd, cp, mv, rm, rmdir,
           df, pg, echo, grep, find, chmod, touch, date, mkdir, basename,
           dirname, time, shutdown,...
        * ber 40 eingebaute Kommandos
        * Shell-Variablen setzen in der Form NAME=WERT
        * Ausfhrung von der Shell als TTP-Parameterzeile bergebenen
          Kommandos mit darauffolgender Beendigung der Shell mglich
        * Konfiguration der Shell durch eine nach Programmstart auszu-
          fhrende Kommandodatei (Profile)
        * Eingabe, Ausgabe und Fehlerausgabe aller interner Kommandos
          umleitbar mit <, >, >>, 2>, 2>>
        * Simulation von Pipelining: Die Ausgabe eines Kommandos wird
          zur Eingabe eines anderen; beliebig schachtelbar
        * Lesen von Shell-Variablen von der Pipe
        * Simulation eines "Null-Device" zum Ignorieren von Ausgaben
          (in Unix: /dev/null)
        * Ausfhrung von Shell-Scripts (Batch-Files) mit Parameterbergabe
        * Tastatureingabe mit History (zurckholen vorheriger Eingaben
          per Tastendruck)
        * Spezialkommandos zum Speicherauslesen
        * Suchen von Programmen auf konfigurierbaren Pfaden, mit
          konfigurierbaren Extendern zur Erkennung ausfhrbarer
          Programme
        * Alle GEM-Programme sind von der Shell aus ausfhrbar
        * Online-Help mit Syntaxerklrung aus einer editierbaren Datei
        * Quellcode der "system"-Funktion zum Aufruf der Shell aus eigenen
          Programmen
        * Deutsche Dokumentation aller interner Kommandos mit Beispielen
        * Software-Support bei Fehlern und Fragen, nicht gebunden an
          die Zahlung von Anerkennungsbeitrgen etc.
        * Quellcode erhltlich
        * Pd-Software-Kontaktkarte

Das wichtigste in Beispielen:

        rm test.o

        rm -i *.o               (Lschen aller O-Files mit Nachfrage)
        
        cat test.txt
        
        cat test.txt >PRT:      (Ausdrucken einer Datei)
        
        cd d:\shell\bin         (Wechsel des aktuellen Laufwerks und des
                                 aktuellen Directories)
                                 
        cd ..                   (Wechsel ins Parent-Directory des aktuellen
                                 Directories)

        ls -l d:\*.*
        
        ls -l d:\*.* > dir.txt  (Umleitung der Ausgabe)
        
        rmdir d:\test 2>NULL:   (Ignorieren der Fehlerausgabe)
        
        hd test.prg | pg        (Seitenweise Ausgabe eines Hexdump)
        
        hd test.prg >test.tmp   (analog zu vorigem Beispiel)
        pg <test.tmp
        rm test.tmp
        
        date >> datum.log       (Anfgen des Datums an das Ende einer Datei)

        echo Bitte Name eingeben
        read NAME               (Benutzung von Shellvariablen)
        echo Der Name ist $NAME
                
        TMPNAME=dat$$.tmp       (Erzeugen eines eindeutigen Dateinamens
                                 durch die System-Shellvariable $, deren
                                 Wert sich stndig ndert [in Unix:
                                 Prozessnummer])
        
        PS1='Eingabe >'         (ndern des Shell-Prompts)        

        date | read a           (Einlesen des Datums in die Variable a)
        echo Das Datum ist $a   (Unix-"Command Substitution":
                                 echo Das Datum ist `date`
                                 wird leider nicht untersttzt, ist aber
                                 durch read von der Pipe in praktisch
                                 allen Fllen simulierbar)
        
        grep printf *.c         (Suchen von "printf" in allen C-Dateien)
        
        df C: E: F:             (Ausgabe der Plattenbelegungen)
        
        chmod +hr secret.dat    (Verstecken und Schreibschtzen einer Datei)

        help | grep chmod       (Ausgabe der Syntax des Kommandos chmod)

        find d:\ test.prg       (Ausgabe des Pfades aller Dateien namens
                                 test.prg auf Laufwerk D:)
                                 
        pg $HOME\profile        (Seitenweise Ausgabe der Konfigurationsdatei)
        
        cursor 12               (Setzen der Cursor-Geschwindigkeit)
        
        touch sh.c              (Erneuern des Dateidatums von sh.c)
        
        cls                     (Bildschirm lschen)
        
        time test.tos           (Messen der Ausfhrungszeit eines Programmes
                                 auf 1/100 Sekunden genau)
        
        find e:\ *.* | wc | pg  (Seitenweise Ausgabe der Anzahlen der
                                 Zeilen, Zeichen und Worte aller Dateien
                                 auf Partition E:)
                    
        rm test.dat ; echo test.dat ist gelscht
                                (Verkettung von Anweisungen)
                                             

Dokumentation:

        readme                  Kurzeinfhrung und bersicht
        release                 Versionsnummer und Ausstattung der Shell
        okami.doc               Bedienung der Shell
        commands.doc            Bedienung der internen Kommandos
                                Aufruf von externen Kommandos
        tricks.doc              Tips&Tricks zur Benutzung der Shell
        system.doc              Benutzung der "system"-Funktion
        msh.doc                 Benutzung der Micro-Shell 

