home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / util / misc / man / docs / deutsch / man.dok < prev    next >
Encoding:
Text File  |  1993-12-21  |  5.2 KB  |  138 lines
  1. Document Man
  2.  
  3. Man v2.5 - © 1993 by Markus Hillenbrand
  4. ---------------------------------------
  5.  
  6. Man ist ein Hilfsprogramm zum Anzeigen von Texten aus der Shell heraus.
  7. Von der Workbench aus kann man es aber auch benutzen.
  8.  
  9.  
  10. 1. Systemvoraussetzungen
  11. ~~~~~~~~~~~~~~~~~~~~~~~~
  12.  
  13. Benötigt werden:  - asl.library         v37
  14.                   - intuition.library   v37
  15.                   - gadtools.library    v37
  16.                   - graphics.library    v37
  17.                   - dos.library         v37
  18.           - icon.library        v37 (nur ManCom)
  19.           - commodities.library v37 (nur ManCom)
  20.  
  21. Unterstützt wird: - locale.library      v38
  22.                   - reqtools.library    v38 (Busy-Pointer)
  23.                   
  24. Empfohlen wird :  - eine Festplatte zur effizienten Nutzung von Hilftexten
  25.                   - "Multiview" von OS3.0 zum automatischen Anzeigen von
  26.                     .guide-Dateien
  27.           - "AmigaGuide" von OS2.0 als Ersatz für Multiview, wenn
  28.              kein OS3.0 vorhanden
  29.  
  30. 2. Konfiguration
  31. ~~~~~~~~~~~~~~~~
  32.  
  33. Das Programm wird konfiguriert, indem man in der Shell "mam -c" oder
  34. "man -config" eingibt. Danach erscheint ein Window, in dem verschiedene
  35. Einstellungen gemacht werden können.
  36.  
  37. Im Gadget "Pfad für Texte" wird angegeben, welches Verzeichnis das Programm
  38. Programm durchsuchen soll. Hier kann auch ein Assign angegeben werden, so
  39. daß auch mehrere Verzeichnisse durchsucht werden können. Am besten ist es,
  40. auf einer Festplatten-Partition ein Verzeichnis anzulegen, in dem man die
  41. gesammelten .DOC und .guide Files sammelt.
  42.  
  43. Im Gadget "Anzeigeprogramm" kann man einen Textanzeiger angeben, mit dem
  44. die Hilftexte angezeigt werden sollen.
  45.  
  46. In den vier Gadgets auf der rechten Seite kann man die Endungen anklicken,
  47. nach denen gesucht werden soll. Im letzten dieser vier Gadgets kann man
  48. eine eigene Endung angeben. (Wird ".guide" angegeben, so kann man umgehen,
  49. daß bei einer .guide-Datei Multiview oder AmigaGuide aufgerufen wird.)
  50. Die restlichen Gadgets erklären sich von selbst.
  51.  
  52.  
  53. 3. Benutzung von der Shell aus
  54. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  55.  
  56. Um von der Shell aus einen Text anzeigen zu lassen, muß man diesen angeben.
  57. Dabei ist die Endung wegzulassen. "Man lha" sucht demnach im voreingestell-
  58. ten Verzeichnis nach lha.doc, lha.dok, lha.man oder lha.guide oder ...
  59. Der Text wird dann mit dem voreingestellten Textanzeiger angezeigt.
  60. Gibt man "man -l" an, so wird eine Liste der Texte ausgegeben. Ruft man das
  61. Programm ohne Parameter auf, so wird ein Asl Requester geöffnet, mit dem man
  62. einen Text auswählen kann.
  63.  
  64.  
  65. 4. Lokalisierung unter WB2.1+
  66. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  67.  
  68. Ab der Workbench 2.1 kann das Programm lokalisiert werden, das heißt es
  69. kann leicht in andere Sprachen übersetzt werden. Dazu ist der C-Quelltext
  70. von MAN.catalog dem Programm beigefügt. Im Original werden nur deutsch und
  71. englisch unterstützt.
  72. Der C-Text kann jedoch erweitert werden und mit einem geeigneten Programm
  73. (z.B. MakeCAT - © by Paladin-Software) wieder in einen Katalog umgewandelt
  74. werden.
  75. Wenn Sie den Katalog in eine andere Sprache übersetzen, so wäre es sehr nett,
  76. wenn Sie mir den Quelltext dieses neuen Katalogs per e-mail zusenden würden,
  77. damit die Sprache in neueren Versionen von Man schon von vornherein unter-
  78. stützt wird!
  79.  
  80.  
  81. 5. ManCom - das Man Commodity
  82. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  83.  
  84. ManCom v1.1 ist ein Commodity, das nichts anderes tut als auf den Hotkey
  85. CTRL HELP zu warten, um dann einen Asl.Requester zu öffnen, der nach dem
  86. zu zeigenden Text fragt.
  87. Demnach erfüllt es die gleiche Funktion wie man ohne einen Parameteraufruf,
  88. nur daß es im Speicher bleibt, bis ManCom verlassen wird.
  89. Mit Hilfe des Programmes "Exchange" kann man das Konfigurationsfenster 
  90. öffnen (entspricht "man -c" in der Shell).
  91.  
  92. Das Programm liest die Tooltypes im Programm-Icon ein, diese können sein:
  93.  
  94.   HOTKEY=...     und CX_PRIORITY=...
  95.  
  96. Hier können die für Commodities gültiges Werte angegeben werden.
  97.  
  98.  
  99. 6. Copyright und Anderes 
  100. ~~~~~~~~~~~~~~~~~~~~~~~~
  101.  
  102.    Copyright (C) 1993 by Markus Hillenbrand
  103.  
  104. Dieses Programm darf kopiert und weitergegeben werden solange die Copyright-
  105. Notiz und diese Dokumentation unverändert auf allen Kopien enthalten ist.
  106.  
  107. Es wird keine Garantie gegeben, daß das Programm 100%ig zuverlässig ist. 
  108. Sie benutzen dieses Programm auf eigene Gefahr. Der Autor kann auf *keinen*
  109. Fall für irgendwelche Schäden verantwortlich gemacht werden, die durch die 
  110. Anwendung dieses Programmes entstehen.
  111.  
  112. Das Paket ist "freely distributable", aber das Copyright liegt weiterhin 
  113. bei Markus Hillenbrand. Dies bedeutet, daß es von jedem kopiert werden darf,
  114. solange er nicht mehr als eine angemessene Kopiergebühr dafür verlangt. 
  115.  
  116. Dieses Paket darf in Public-Domain Sammlungen aufgenommen werden, in
  117. Mailboxsystemen oder auf FTP Servern abgelegt werden. Wenn Sie dieses
  118. Paket weitergeben wollen, dann *müssen* Sie die originale
  119. Distributionsdatei "man25.lha" benutzen.
  120.  
  121. Dieses Programm darf nicht ohne eine schriftliche Genehmigung des Autors in 
  122. kommerziellen Programmen benutzt werden.
  123.  
  124.  
  125. 7. Adresse des Autors
  126. ~~~~~~~~~~~~~~~~~~~~~
  127.  
  128. Hier ist meine Adresse (für Anregungen, Bug-Report, oder Sonstiges):
  129.  
  130.                Markus Hillenbrand
  131.                Weserstraße 9
  132.                36124 Eichenzell-Löschenrod
  133.  
  134.                GERMANY
  135.  
  136.  
  137. oder e-mail:   m_hillen@informatik.uni-kl.de
  138.