Dokumentation zu GetPubName 1.4
===============================
Programm und Dokumentation sind © Copyright 1992 by Michael `Mick' Hohmann.

IMPORT StdDisclaimer; (* kurz: Benutzung auf eigene Gefahr *)
GetPubName wurde sorgfältig getestet, aber es können natürlich trotzdem noch
diverse Fehler auftreten.

GetPubName V1.4 ist Freeware. Es darf auf nicht-kommerziellem Weg weitergegeben
werden, solange die folgenden Bedingungen erfüllt sind:

  * Quelltext, ausführbares Programm und Dokumentation müssen zusammen
    weitergegeben werden (GetPubName.mod, MoreIntuition.mod, GetPubName,
    GetPubName.doc und GetPubName.dok).
    Die Dateien müssen unverändert weitergegeben werden!

  * PD-Serien: Die Disketten, die GetPubName enthalten, dürfen in Deutschland
    nicht mehr als 8 DM kosten.
    Ansonsten darf der Preis, den Fred Fish für eine einzelne seiner
    AmigaLibDisks verlangt, nicht überschritten werden.


GetPubName läuft nur mit AmigaOS V37 oder höher (das ist 2.04 oder höher).


Zusammenfassung
===============
GetPubName liefert den Namen des vordersten PubScreens entweder nach
StdOut, oder, falls angegeben, in eine globale/lokale Environment-Variable.

Der Sinn des Programmes liegt darin, daß Programmen, die als Argument
einen PubScreen-Namen erwarten, dieser mit dem BackTick "`" zur
Startzeitpunkt übergeben werden kann. Z.B. rufe ich den C= Calculator von
meinem ToolManager-Hotkey-DockFenster folgendermaßen auf:

    "Calculator PUBSCREEN=`GetPubName`"

wodurch der Calculator immer auf dem vordersten PubScreen geöffnet wird,
genauso, wie auch das ToolManager-Hotkey-DockFenster.


Aufruf
======
GetPubName [ENV | ENVIRONMENT name] [LOC | LOCAL] [HELP]

HELP
----
Zeigt einen kurzen Hilfstext an.

ENV | ENVIRONMENT  name
-----------------------
Wenn ein Name angegeben wurde, schreibt GetPubName den PubScreenNamen in
eine Environment-Variable.

LOC | LOCAL
-----------
Wenn dieser Schalter und ein Environment-Name angegeben werden, legt
GetPubName eine lokale Environment-Variable an.


Beispiel: GetPubName PubScreenName
          schreibt den Namen des vordersten PubScreens in die globale
          Environment-Varibale "PubScreenName"


History
=======
V1.4    Bug-Fix (thanx to `tron') und Unterstützung von lokalen
        Environment-Variablen
V1.3    Übersetzt nach Oberon
V1.2    Unterstützung von globalen Environment-Variablen eingebaut
V1.1    Erste verwendbare Version :-)
V0.x    diverse Versuche...


Bekannte Probleme/Bugs
======================
Bis jetzt keine...


Im Usenet erreicht man mich unter:

   swb.de!imart!mickh
oder ab dem 1. Oktober 1992
   mickh@imart.franken.de

Oder mit der Bundesp*st (Rückporto bitte!):

   Michael-W. Hohmann
   Carl-Schilling-Str. 10
   D-8701 Kirchheim

Viel Spass!


Danksagung
==========
Die folgenden Leute haben mir mit diversen Anregungen und Bug-Reports
sehr geholfen:

  Bernhard Möllemann
  Jürgen Weinelt
  Steffen Reith
  Hartmut Goebel
  Matthias `Tron' Scheler

Vielen Dank euch allen.