GetPubName V1.4 Documentation
=============================
Programm and Documentation © Copyright 1992 by Michael `Mick' Hohmann.

IMPORT StdDisclaimer; (* in short: use it at your own risk *)
GetPubName was carefully tested, but there's certainly plenty of room for
bugs.

GetPubName V1.4 is Freeware, non-commercial distribution is o.k. as long as
the following conditions are met:

  * Source, executable and documentation must be distributed together
    (GetPubName.mod, MoreIntuition.mod, GetPubName, GetPubName.doc and
    GetPubName.dok), and these files must be intact (you're not allowed to
    make changes).

  * Disk librarians: you may charge no more than the current price
    of a single AmigaLibDisk from Fred Fish


GetPubName requires AmigaOS V37 or later (that's 2.04 or later).


Purpose
=======
GetPubName returns the Name of the frontmost PubScreen either to StdOut,
or if specified to a global/local Environment-Variable.

The main usage is supposed to be in conjunction with other programs,
that need a PubScreenName, and the BackTick "`". E.g. I call the C=
Calculator from my ToolManager-Hotkey-DockWindow with:

     "Calculator PUBSCREEN=`GetPubName`"

The Calculator will open on the frontmost PubScreen, like the
Hotkey-DockWindow itself.


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

HELP
----
Displays a short help message.

ENV | ENVIRONMENT  name
-----------------------
If you specify a name GetPubName will write the PubScreenName to an
Environment-Variable.

LOC | LOCAL
-----------
If you specify this switch together with a name, GetPubName will write
the PubScreenName to a local Environment-Variable.


Example: GetPubName PubScreenName
         will save the name of the frontmost PubScreen to the global
         Environment-Variable "PubScreenName"


History
=======
V1.4    Bug-Fix (thanx to `tron') and included the local Env-Vars
V1.3    translated to Oberon
V1.2    now the PubScreenName can be saved to a global Environment-Varibale
V1.1    First usable version :-)
V0.x    some attempts...


Known problems/bugs
===================
None so far...


You can contact me through the Usenet:

   swb.de!imart!mickh
or after 1-OCT-92 try
   mickh@imart.franken.de

Or through the snail mail:

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

Thanx
=====
The following people contributed suggestions and bugreports:

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

Many thanks to each of you.