Document Man

Man v2.3 - © 1993 by Markus Hillenbrand
---------------------------------------

Man ist ein Hilfsprogramm zum Anzeigen von Texten aus der Shell heraus.
Von der Workbench aus kann man es aber auch benutzen.


1. Systemvoraussetzungen
~~~~~~~~~~~~~~~~~~~~~~~~

Benötigt werden: - asl.library       v37
                 - intuition.library v37
                 - gadtools.library  v37
                 - graphics.library  v37
                 - utility.library   v37
                 - dos.library       v33
                  
Empfohlen wird : - eine Festplatte zur effizienten Nutzung von Hilftexten
                 - "Multiview" von OS3.0 zum automatischen Anzeigen von
                   .guide-Dateien

2. Konfiguration
~~~~~~~~~~~~~~~~

Das Programm wird konfiguriert, indem man in der Shell "mam -c" oder
"man -config" eingibt. Danach erscheint ein Window, in dem verschiedene
Einstellungen gemacht werden können.

Im Gadget "Pfad für Texte" wird angegeben, welches Verzeichnis das Programm
Programm durchsuchen soll. Hier kann auch ein Assign angegeben werden, so
daß auch mehrere Verzeichnisse durchsucht werden können. Am besten ist es,
auf einer Festplatten-Partition ein Verzeichnis anzulegen, in dem man die
gesammelten .DOC und .guide Files sammelt.

Im Gadget "Anzeigeprogramm" kann man einen Textanzeiger angeben, mit dem
die Hilftexte angezeigt werden sollen.

In den vier Gadgets auf der rechten Seite kann man die Endungen anklicken,
nach denen gesucht werden soll. Im letzten dieser vier Gadgets kann man
eine eigene Endung angeben. (Wird ".guide" angegeben, so kann man umgehen,
daß bei einer .guide-Datei Multiview aufgerufen wird.)
Die restlichen Gadgets erklären sich von selbst.


3. Benutzung von der Shell aus
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Um von der Shell aus einen Text anzeigen zu lassen, muß man diesen angeben.
Dabei ist die Endung wegzulassen. "Man lha" sucht demnach im voreingestell-
ten Verzeichnis nach lha.doc, lha.dok, lha.man oder lha.guide oder ...
Der Text wird dann mit dem voreingestellten Textanzeiger angezeigt.
Gibt man "man -l" an, so wird eine Liste der Texte ausgegeben. Ruft man das
Programm ohne Parameter auf, so wird ein Asl Requester geöffnet, mit dem man
einen Text auswählen kann.


4. Copyright und Anderes 
~~~~~~~~~~~~~~~~~~~~~~~~

   Copyright (C) 1993 by Markus Hillenbrand

Dieses Programm darf kopiert und weitergegeben werden solange die Copyright-
Notiz und diese Dokumentation unverändert auf allen Kopien enthalten ist.

Es wird keine Garantie gegeben, daß das Programm 100%ig zuverlässig ist. 
Sie benutzen dieses Programm auf eigene Gefahr. Der Autor kann auf *keinen*
Fall für irgendwelche Schäden verantwortlich gemacht werden, die durch die 
Anwendung dieses Programmes entstehen.

Das Paket ist "freely distributable", aber das Copyright liegt weiterhin 
bei Markus Hillenbrand. Dies bedeutet, daß es von jedem kopiert werden darf,
solange er nicht mehr als eine angemessene Kopiergebühr dafür verlangt. 

Dieses Paket darf in Public-Domain Sammlungen aufgenommen werden, in
Mailboxsystemen oder auf FTP Servern abgelegt werden. Wenn Sie dieses
Paket weitergeben wollen, dann *müssen* Sie die originale
Distributionsdatei "man23.lha" benutzen.

Dieses Programm darf nicht ohne eine schriftliche Genehmigung des Autors in 
kommerziellen Programmen benutzt werden.


5. Adresse des Autors
~~~~~~~~~~~~~~~~~~~~~

Hier ist meine Adresse (für Anregungen, Bug-Report, oder Sonstiges):

               Markus Hillenbrand
               Weserstraße 9
               36124 Eichenzell-Löschenrod

               GERMANY


oder e-mail:   m_hillen@informatik.uni-kl.de