PROGTOOL(1) Benutzerkommandos PROGTOOL(1) NAME progtool - Eine Sammlung von Programmier-Tools VERSION Release 02 vom 24. Januar 1994 BESCHREIBUNG Achtung: dies ist NICHT `Public-Domain' oder `Freeware'. N„heres 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 F„higkeiten gezielt nutzen, k”nnen die Pro- gramme auch mit jeder anderen `vernnftigen' Shell eingesetzt werden. Wer mag, kann es sogar mit einer DOS-„hnlichen Shell oder gar dem Atari-Desktop versuchen... Erl„uterungen zu den einzelnen Kommandos finden Sie in den jewei- ligen Manual-Pages. Fr Hinweise (Bugs, Vorschl„ge, Inkompatibilit„ten, Tippfehler, fehlende Dinge in den Manual-Pages) w„re ich natrlich sehr dank- bar. Auch etwaige Differenzen zu den langen Optionsnamen bei entsprechenden GNU-Programmen w„ren interessant. Zur Anzeige der Manual-Pages wird das Mupfel-Script `man.mup' sowie ein `more', das von der Standardeingabe lesen kann, ben”tigt (siehe Gemini-2-Distribution). Aužerdem sollte es m”glich sein, die Dateien so, wie sie sind, direkt auf einem Drucker auszugeben (zumindest Unterstreichungen mžten dabei erhalten bleiben). INSTALLATION Da Sie diesen Text lesen, haben Sie offenbar bereits das Archiv ausgepackt. Dabei sollte folgende Ordnerstruktur entstanden sein: \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 Ger„tetreibern \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 ungef„hr in der Standard-Gemini-Distribution. Fortgeschrittene Benutzer k”nnen 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 l„žt sich normalerweise mit der Option `--version' ermitteln! Eine Kurzhilfe gibt es in den meisten F„llen 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' enth„lt Voreinstellungen. c89(1) ist eine eingeschr„nkte 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 Schlsselw”rter. 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 erm”glichen. rscsplit(1) splittet von Resource Construction Sets angelegte Headerdateien auf (je Objektbaum eine). size(1) gibt die Segmentgr”žen 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 Hensenstraže 142 D-48161 Mnster EMAIL Maus Mnster, Telefon 0251/77261, Benutzername "Julian Reschke" reschke@math.uni-muenster.de oder jr@ms.maus.de WICHTIGER HINWEIS Ich, Julian F. Reschke, bernehme keine Haftung fr irgendwelche direkten oder indirekten Sch„den -- einschliežlich aber nicht beschr„nkt 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) 1994 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 unver„nderter 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) Bei eventuellen Problemen oder Verbesserungsvorschl„gen wenden Sie sich bitte an eine der oben genannten Email-Adressen. SIEHE AUCH cc(1), c89(1), ident(1), mupftool(1), nm(1), rcs(1), rsccrc(1), size(1), strip(1), texttool(1) šBERSICHT šBER TOOLSAMMLUNGEN Mupfel-Tools, Release 02 (MUPFTL02.TOS) absname - Dateinamen zu absoluten Pfaden expandieren banner - Worte in grožen Lettern ausgeben cal - Kalender anzeigen calendar - Termine anzeigen cmp - Bin„rdateien vergleichen crc - Prfsummen von Dateien bilden cut - Teile aus Textzeilen herausschneiden date - Datum ausgeben df - freien Plattenplatz anzeigen du - durch Dateien belegten Platz ermitteln env - Environment ausgeben bzw. Programme mit spez. Environment starten file - Dateityp ermitteln find - Dateien suchen line - Zeile aus Standardeingabe extrahieren locate - Dateien suchen (Einfachversion) one-of - ein zuf„lliges Argument ausgeben printenv - Environmentvariablen anzeigen runopts - Programmflags setzen sleep - bestimmte Zeit warten strings - Bin„rdateien 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 02 (PROGTL02.TOS) cc - Frontend fr Pure-C-TTPs (Posix mit Unix-Erweiterungen) c89 - Frontend fr Pure-C-TTPs (Posix) ident - RCS-Kennungen suchen nm - Symboltabellen anzeigen (DR, Gnu, Pure) rsccrc - CRC-Prfsummengenerator fr Resource-Dateien rscsplit - Resource-Header fr einzelne Objektb„ume splitten size - Gr”že der Programmsegmente anzeigen (DR, Gnu, Pure) strip - Debugging-Informationen aus Binaries und CPXen entfernen Text-Tools, Release 02 (TEXTTL02.TOS) bs2esc - Backspacing-Sequenzen wandeln pr - Texte zur Druckausgabe vorbereiten vdiprint - Texte per GDOS drucken wc - Zeichen, Worte und Zeilen z„hlen wpcat -- Wordplus-Dateien wandeln