PROGTOOL(1)                Benutzerkommandos                PROGTOOL(1)

NAME
     progtool - Eine Sammlung von Programmier-Tools

VERSION
     Release 05

BESCHREIBUNG
     Achtung: dies ist NICHT `Public-Domain' oder `Freeware'. Nheres 
     dazu unter `COPYRIGHT'!!!!

     Diese Sammlung von Utilities wendet sich in erster Linie an den 
     Programmierer. Sie ist speziell auf Pure-C-Benutzer ausgerichtet, 
     kann aber teilweise auch fr andere Entwicklungssysteme verwendet 
     werden.

     Auch wenn die Tools speziell fr die Shell `Mupfel' (Copyright 
     Stefan Eissing, Stefan_Eissing@ac.maus.de) entwickelt worden sind 
     und ihre speziellen Fhigkeiten gezielt nutzen, knnen die Pro-
     gramme auch mit jeder anderen `vernnftigen' Shell wie beispiels-
     weise der `CoSHy' in `Connect' eingesetzt werden. Wer mag, kann es 
     sogar mit einer DOS-hnlichen Shell oder gar dem Atari-Desktop 
     versuchen...

     Erluterungen zu den einzelnen Kommandos finden Sie in den jewei-
     ligen Manual-Pages.

     Fr Hinweise (Bugs, Vorschlge, Inkompatibilitten, Tippfehler, 
     fehlende Dinge in den Manual-Pages) wre ich natrlich sehr dank-
     bar. Auch etwaige Differenzen zu den langen Optionsnamen bei 
     entsprechenden GNU-Programmen wren interessant.

     Zur Anzeige der Manual-Pages wird das Mupfel-Script `man.mup' sowie   
     ein `more', das von der Standardeingabe lesen kann, bentigt (siehe 
     Gemini-2-Distribution). Auerdem sollte es mglich sein, die 
     Dateien so, wie sie sind, direkt auf einem Drucker auszugeben 
     (zumindest Unterstreichungen mten dabei erhalten bleiben).

     Alternative: das Shareware-Programm `Manview' (manview.zoo) von 
     Ulrich Khn (kuehn@math.uni-muenster.de). Es zeigt die Manual-Pages 
     im GEM-Fenster an und erlaubt es auch, komfortabel den 
     Querverweisen zu folgen.

INSTALLATION
     Da Sie diesen Text lesen, haben Sie offenbar bereits das Archiv     
     ausgepackt. Dabei sollte folgende Ordnerstruktur entstanden sein:

     <wo_auch_immer>\bin\*.ttp          ausfhrbare Programme
                    \etc\*              Infodateien
                    \scripts\*.mup      Mupfel-Scripts
                    \man\cat1\*.1       Manual-Pages zu externen Kom-
                                        mandos
                    \man\cat4\*.4       Manual-Pages zu Gertetreibern
                    \man\cat5\*.5       Manual-Pages zu Dateiformaten
                    \options\*.opl      Option-Library fr Mupfel (fr 
                                        die Mupfel mu die Environment-
                                        variable OPTIONPATH auf das 
                                        entsprechende Verzeichnis 
                                        gesetzt sein).

     Eine entsprechende Ordnerstruktur findet sich nicht von ungefhr in     
     der Standard-Gemini-Distribution. Fortgeschrittene Benutzer knnen     
     natrlich gerne die Verzeichnisse anders sortieren (dann mu     
     allerdings auf die richtigen Werte einiger Environmentvariablen wie     
     PATH, MANPATH und OPTIONPATH geachtet werden).

     In den Verzeichnissen man\man*\ kann man brigens auch Manual-Pages 
     im nroff-Format verstecken (wenn man denn einen nroff installiert 
     hat). Beispiel: die MiNT-Manualpages sollten in man\man2\*.2 stehen 
     (Kapitel 2: System-Calls!)

     Das Versionsdatum der einzelnen Tools lt sich normalerweise mit 
     der Option `--version' ermitteln! Eine Kurzhilfe gibt es in den 
     meisten Fllen durch `--help'.

PROGRAMME
     cc(1)          ist ein Frontend fr die Kommandozeilenversionen des 
                    Pure-C-Compilers. Die Parametrisierung entsprecht 
                    den Unix-Konventionen, daher kann man somit normale 
                    Makefiles benutzen, ohne an Parametern oder Regeln 
                    herumbasteln zu mssen. Die (mit vielen Kommentaren 
                    versehene) Datei 'cc.cfg' enthlt Voreinstellungen.

     c89(1)         ist eine eingeschrnkte Version von cc(1), bei der 
                    nur die im POSIX-Standard definierten Optionen 
                    untersttzt werden.

     ident(1)       findet in Dateien die vom 'Revision Control System' 
                    (rcs(1)) angelegten Schlsselwrter.

     listopen(1)    gibt Informationen ber geffnete Dateien bzw. 
                    Verzeichnisse aus.

     nm(1)          gibt die Symboltabellen von Objektdateien, Pro-
                    grammdateien und Bibliotheken aus. Dabei werden 
                    Formate von Digital Research, GNU (TOS-Portierung) 
                    und Pure untersttzt.

     rsccrc(1)      berechnet Prfsummen von Ressource-Dateien, um zur 
                    Laufzeit einen Versionscheck zu ermglichen.

     rscsplit(1)    splittet von Resource Construction Sets angelegte 
                    Headerdateien auf (je Objektbaum eine).

     size(1)        gibt die Segmentgren von Objektdateien, Programm-
                    dateien und Bibliotheken aus.

     strip(1)       Entfernt aus Programm- und CPX-Dateien berflssiges 
                    (wie Symboltabellen oder Debugging-Informationen).

AUTOR
     Julian F. Reschke
     Hensenstrae 142
     D-48161 Mnster

     Maus MS, Telefon 0251/77261, Benutzername "Julian Reschke"

     mailto:jr@ms.maus.de
     http://www.muenster.de/~reschke

WICHTIGER HINWEIS
     Ich, Julian F. Reschke, bernehme keine Haftung fr irgendwelche     
     direkten oder indirekten Schden -- einschlielich aber nicht     
     beschrnkt auf materielle oder finanzielle -- die durch die Benut-
     zung dieser Programme oder die Untauglichkeit dieser Programme fr 
     einen bestimmten Zweck entstehen.

COPYRIGHT
     Sofern nicht an anderer Stelle genauer oder anderslautend spezifi-
     ziert gilt fr alle Programme und Texte:

     Copyright (c) 1998 Julian F. Reschke
     Alle Rechte vorbehalten

     Diese Programme sind NICHT Public Domain, drfen aber (ausschlie-
     lich frei) weitergegeben werden. Dabei MUSS das Original-Archiv in 
     unvernderter Form weitergegeben werden.

     Ich behalte mir das Recht vor, diese Genehmigung jederzeit und ohne     
     Angabe von Grnden zurckzuziehen.

     Eine Verbreitung auf PD-Sammeldisketten und hnlichen Medien     
     (gebhrenpflichtige Mailboxsysteme, `Channel Videodat', CD-ROMs 
     etc.) ist nur mit meiner ausdrcklichen schriftlichen Genehmigung 
     gestattet. Die Installation und die Weitergabe der Programme oder 
     von Teilen der Programme gilt als Anerkennung dieser Bestimmungen.

     Eine Weiterentwicklung dieser Programme wird definitiv nur dann     
     stattfinden, wenn sie durch entsprechende Spenden ausreichend     
     motiviert wird. Wer also fr diese Programmsammlung Verwendung hat 
     und sich wnscht, da sie weiterhin gepflegt und erweitert wird, 
     benutze folgende Kontoverbindung:

          Kontonummer 2542 39-465
          Postgiroamt Dortmund (BLZ 440 100 46)

     Es ist durchaus mglich, da knftige Versionen nicht mehr frei 
     erhltlich sein werden. Daher ist es wichtig, da Sie auf der 
     berweisung neben dem Namen auch eine Adresse und gegebenenfalls 
     auch eine Email-Adresse angeben.

     Wer bereits ltere Versionen benutzt hat und noch keine Spende 
     berwiesen hat, sollte diese Version sofort wieder lschen oder 
     aber sich nunmehr zur Spende durchringen. Alles andere empfinde ich 
     als Schmarotzerei.

     Bei eventuellen Problemen oder Verbesserungsvorschlgen wenden Sie     
     sich bitte an die oben genannte Email-Adresse.

SIEHE AUCH
     cc(1), c89(1), ident(1), listopen(1), mupftool(1), nm(1), 
     progtool(1), rcs(1), rsccrc(1), rscsplit(1), size(1), strip(1), 
     texttool(1)

BERSICHT BER (knftige) TOOLSAMMLUNGEN

     Mupfel-Tools, Release 14 (MUPFTL14.TOS)

     absname - Dateinamen zu absoluten Pfaden expandieren
     banner - Worte in groen Lettern ausgeben
     cal - Kalender anzeigen
     calendar - Termine anzeigen
     chmod - Zugriffsrechte setzen
     cksum - Prfsummen von Dateien bilden
     cmp - Binrdateien vergleichen
     crc - Prfsummen von Dateien bilden
     date - Datum ausgeben
     df - freien Plattenplatz anzeigen
     du - durch Dateien belegten Platz ermitteln
     eject - Medien auswerfen bzw. wieder einziehen
     env - Environment ausgeben bzw. Programme mit spez. Environment starten
     error - Text zu Fehlernummern anzeigen
     file - Dateityp ermitteln
     find - Dateien suchen
     hushictl - HuSHI-Einstellungen fr Schreibschutz kontrollieren
     line - Zeile aus Standardeingabe extrahieren
     locate - Dateien suchen (Einfachversion)
     od - Dateiinhalte dumpen
     one-of - ein zuflliges Argument ausgeben
     printenv - Environmentvariablen anzeigen
     printf - formatierte Bildschirmausgabe
     runopts - Programmflags setzen
     sleep - bestimmte Zeit warten
     strings - Binrdateien nach Zeichenketten durchsuchen
     sum - Prfsummen von Dateien bilden
     tee - T-Stck fr Pipes
     time - Zeitbedarf eines Kommandos messen
     touch - Dateidatum setzen
     uname - Systemdaten ausgeben
     what - SCCS-Kennungen suchen

     Programming-Tools, Release 05 (PROGTL05.TOS)

     cc - Frontend fr Pure-C-TTPs (Posix mit Unix-Erweiterungen)
     c89 - Frontend fr Pure-C-TTPs (Posix)
     ident - RCS-Kennungen suchen
     listopen - Informationen ber geffnete Dateien/Verzeichnisse
     nm - Symboltabellen anzeigen (DR, Gnu, Pure)
     rsccrc - CRC-Prfsummengenerator fr Resource-Dateien
     rscsplit - Resource-Header fr einzelne Objektbume splitten
     size - Gre der Programmsegmente anzeigen (DR, Gnu, Pure)
     strip - Debugging-Informationen aus Binaries und CPXen entfernen

     Text-Tools, Release 11 (TEXTTL11.TOS)

     bs2esc - Backspacing-Sequenzen wandeln
     cut - Teile aus Textzeilen herausschneiden
     fold - zu lange Zeilen umbrechen
     head - Beginn einer oder mehrerer Dateien anzeigen
     pr - Texte zur Druckausgabe vorbereiten
     split - Dateien in kleinere Teile zerlegen
     tr - Zeichen konvertieren bzw. lschen
     uniq - Identische Zeilen finden/zhlen
     uuencode - Binrdateien in ASCII-Dateien wandeln
     vdiprint - Texte per GDOS drucken
     wc - Zeichen, Worte und Zeilen zhlen
     wpcat - Wordplus-Dateien wandeln

     MiNT-Tools, Release 05 (MINTTL05.TOS)

     chgrp - Gruppenzugehrigkeit von Dateien ndern
     chmac - Mac-Finderinformationen setzen
     chown - Besitzer von Dateien ndern
     fsinfo - Informationen ber Dateisysteme ausgeben
     id - Benutzer- und Gruppenkennungen ausgeben
     kill - Signale an Programme schicken
     leave - einfacher Terminwarner
     ln - Verweise (Links) auf Dateien anlegen
     logname - Namen des Benutzers ausgeben
     mknod - Gerte fr Linux/68K auf MFS-Partitionen anlegen
     newgrp - Shell mit neuer Gruppenkennung starten
     nice - Proze mit genderter Prioritt starten
     ps - Prozestatus anzeigen
     renice - Prioritt eines laufenden Prozesses ndern
     su - Shell mit neuer Userkennung starten
     sync - Dateisysteme synchronisieren
     tty - Namen des TTYs ausgeben
     uptime - Systemauslastung ausgeben
