home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 1 / FFMCD01.bin / bbs / cliutil / man.lha / Man / Man.doc < prev    next >
Encoding:
Text File  |  1993-07-27  |  3.6 KB  |  143 lines
  1.  
  2.  MAN, written by Kai Iske July 16. 1993
  3.       This is PUBLIC DOMAIN; you may do with it whatever you like
  4.  
  5.  
  6. If you change/republish/delete/sell the program or do anything similar, please
  7. be so kind to keep my name within the program and all the other files.
  8.  
  9. MAN  was  written  because  of  the fact that MRMan (by Mark Rinfret) had some
  10. severe  problems  under  OS 2.x (or was it 3.x).  Anyway, I wrote this tool in
  11. order not to have to keep in mind the locations of all the various man pages I
  12. spread across the subdirectories of my MAN:  directory.
  13.  
  14. MAN was written using SAS 6.3....
  15.  
  16. !!! Man requires OS 2.x and up to run !!!
  17.  
  18.  
  19. -----------------
  20. What does MAN ???
  21. -----------------
  22.  
  23.  
  24. Well, it is a MAN command similar to the one found on any UNIX System.  Simply
  25. type  "man dummy" and the manual pages (documentation) for a file called dummy
  26. will  be searched for.  If man was successful in finding the appropriate file,
  27. a textviewer will be used to display the documentation.
  28.  
  29. You may configure MAN in order to tell the program where to find the man pages
  30. and  what  text  viewers  to  use.   Wait a minute.  Textviewers ???  Yep, MAN
  31. recognizes the following suffixes as to be part of man pages:
  32.  
  33.   .doc   - Simple ASCII text file
  34.   .man   - Simple ASCII text file
  35.   .guide - Got it, AmigaGuide compatible guide file.
  36.  
  37. So now you know why there are different textviewers.
  38.  
  39.    For example...
  40.  
  41.       You have the documentation for a program called "KCommodity" somewhere
  42.       within your docs directory. The doc file is called "KCommodity.Man". In
  43.       order to get the documentation loaded by man, simply type:
  44.  
  45.           MAN KCommodity
  46.  
  47.       ...and the ASCII textviewer will be used. If your filename ends up with
  48.       .guide ("KCommodity.guide"), MAN assumes it to be a GUIDE file and will
  49.       use the GUIDE Viewer instead...
  50.  
  51.       See, no suffixes needed. MAN will take the first file matching a
  52.       suffix mentioned above.
  53.  
  54.  
  55.  
  56. ----------------------
  57. How to install MAN ???
  58. ----------------------
  59.  
  60. Copy the main program to a directory within your search paths (i.e. C:).
  61.  
  62. Simply set three environment variables, so that MAN knows what to do:
  63.  
  64.  
  65.  
  66.    MANPATHS  - This variable tells man where to look for man pages.
  67.  
  68.    For example...
  69.  
  70.       SetEnv MANPATHS "MAN:,MAN:CSHDOC|MAN:HPDOCS,MAN:AUTODOCS"
  71.  
  72.    You see, you may either use "," or the "|" as seperators between
  73.    directory names.
  74.  
  75.  
  76.  
  77.  
  78.    MANVIEW   - This one is the path (including filename) for the
  79.                textviewer you wish to use for displaying normal
  80.                ASCII files.
  81.  
  82.    For example...
  83.  
  84.       SetEnv MANVIEW "SYS:Utilities/More"
  85.  
  86.    REMEMBER: Complete path and filename
  87.  
  88.  
  89.  
  90.  
  91.    MANVIEWAG - This one is used to set the path (and filename) for
  92.                the AmigaGuide GUIDE-Viewer.
  93.  
  94.    For example...
  95.  
  96.       SetEnv MANVIEWAG "SYS:Utilities/AmigaGuide"
  97.  
  98.    REMEMBER : Complete path and filename
  99.  
  100.  
  101.  
  102. It is best to place those lines within your S:User-StartUp file.
  103.  
  104.  
  105.  
  106. -----------
  107. Version 1.0
  108. -----------
  109.   - initial release
  110.  
  111.  
  112. -----------
  113. Version 1.1
  114. -----------
  115.   - Accidentially called Exit() instead of exit(), which
  116.     prevented the program to pass the cleanup code of SAS.
  117.     So a lock to the directory was kept and the shell could
  118.     never been left.............
  119.  
  120. -----------
  121. Version 1.2
  122. -----------
  123.   - Used MAN as a keyword for the template which prevented MAN
  124.     to accept inputs like "man man".
  125.  
  126.  
  127. Hope you like it, if not, delete it......
  128.  
  129.  
  130.  
  131. So long,
  132.  
  133.      Kai
  134.  
  135.  
  136.  
  137.  
  138.  --- Kai Iske
  139.  Brucknerstrasse 18, 63452 Hanau, Germany, Tel.: +49-(0)6181-850181
  140.  Z-Net    : KAI@SWEET.ZER            usenet : kai@iske.adsp.sub.org
  141.  internet : iske@informatik.uni-frankfurt.de              IRC:kiske
  142.  ---- Life sucks ----
  143.