home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume39 / cwish / part01 / README < prev    next >
Encoding:
Text File  |  1993-09-22  |  5.7 KB  |  147 lines
  1. ================================================================================
  2. #                                                                              #
  3. #        wish - user friendly windowing shell for character terminals          #
  4. #        ------------------------------------------------------------          #
  5. #                                                                              #
  6. #            Release 1.00  (First Public Release)  September 1993              #
  7. #                                                                              #
  8. #                 Written and (c) Copyright 1988-1993 by                       #
  9. #                        Hellmuth Michaelis (hm@hcshh.hcs.de)                  #
  10. #                        Eggerstedtstr. 28                                     #
  11. #                        22765 Hamburg                                         #
  12. #                        Germany                                               #
  13. #                                                                              #
  14. #        See the file COPYING for restriction and warranty information         #
  15. #                                                                              #
  16. ================================================================================
  17.  
  18. Yes, i know there is another program floating around called "wish", but i use
  19. it now for so long that i am not going to change it's name to something else!
  20.  
  21. Wish is an easy to use tool for travelling through the filesystem, either for
  22. doing administrative work or as a shell replacement.
  23.  
  24. It was rewritten several times, a fact which is noticable in many dark corners
  25. of the source, flames to /dev/null please!
  26.  
  27. The code is neither beautiful nor elegant, as are the underlying data-
  28. structures, so this is definitely NOT usable for an intro class into device
  29. independant programming - it just does the job for many years now and the
  30. users (yes, REAL users!) are satisfied with it.
  31.  
  32. It is now curses based, with the exception of two areas of terminal handling:
  33. - the first being the access of alternate character sets, which is used for
  34.   drawing horizontal lines across the screen, and
  35. - second, the access of function keys in general (and HP-terminal function
  36.   keys in special).
  37.  
  38. Before you cry, there is no alternate character handling and function key
  39. label handling available in the current version of HP-UX's curses (9.0).
  40.  
  41. What i did was, that i programmed "around" curses, which is a very bad thing
  42. for portability and other reasons - i know, but i did not found any other way.
  43.  
  44. I think, i found failsafe methods in order to run wish on other than the 
  45. tested terminals, but due to the lack of appropriate hardware, i tested it
  46. only on HP and DEC terminals or clones or terminal emulation packages
  47. emulating one of the before mentioned.
  48.  
  49. If you get wish to run on some other terminals (Wyse, Qume, Televideo etc.)
  50. please tell me !
  51.  
  52.  
  53. HISTORY
  54. --------------------------------------------------------------------------------
  55.  
  56. Release        Changes/Features
  57. -------        ----------------------------------------------------------------
  58. 1.00        First public release to comp.sources.misc
  59.  
  60.  
  61. INSTALLATION
  62. --------------------------------------------------------------------------------
  63.  
  64. HP-UX:
  65.     You need a ANSI-C compiler to compile everything. You should have no
  66.     problems using the 8.0 and 9.0 compiler or GCC from the Free Software
  67.     Foundation. Wish does not compile with the crippled 9.0 compiler.
  68.  
  69.     Copy Makefile.hpux to Makefile and execute make. You should
  70.     have no problems compiling wish.
  71.  
  72.     I had some problems with terminfo entries for "unsupported" terminals
  73.     under HP-UX 8.0, contact me if you need help.
  74.  
  75.     "make install" installs wish to /usr/local/bin, "make man-hpux"
  76.     installs the manual page to /usr/local/man/man1/wish.1.
  77.  
  78.  
  79. 386BSD:
  80.     Zeyd M. Ben-Halim (zmbenhal@netcom.com) rewrote Pavel Curtis'
  81.     ncurses library and made it available for 386BSD and Linux.
  82.     
  83.     This library is needed in order to get wish up and running on
  84.     386BSD, NetBSD and Linux.
  85.  
  86.     It is available from netcom.com:pub/zmbenhal.
  87.  
  88.     Uncomment the appropriate Makefile-entry and execute make. You should
  89.     have no problems compiling wish.
  90.  
  91.     "make install" installs wish to /usr/local/bin, "make man-386bsd"
  92.     installs the manual page to /usr/local/man/cat1/wish.0.
  93.  
  94.  
  95. OTHER:
  96.     You are on your own! I will be glad to get Makefile entries and/or
  97.     diffs for other machines, if you need help, get in touch with me!
  98.  
  99.  
  100.  
  101. WYSIWYG - WHAT YOU SHARE IS WHAT YOU GET
  102. --------------------------------------------------------------------------------
  103.  
  104. PLEASE, if you fix bugs, add features, hack this program to work on your
  105. terminal and/or operating system or simply don't get it up and running, get
  106. in contact with me!
  107.  
  108. The code is far from being perfect, YOU are very welcome to enhance it !
  109.  
  110. Please mail bug reports/fixes, suggestions, enhancements & diffs to 
  111.  
  112.             hm@hcshh.hcs.de
  113.  
  114. I will support this program as my time permits it, feel free to contact me!
  115.  
  116. Thank You!
  117.  
  118.  
  119. KNOWN BUGS
  120. -------------------------------------------------------------------------------
  121.  
  122. too much ...
  123.  
  124.  
  125. TESTED TERMINALS
  126. --------------------------------------------------------------------------------
  127.  
  128. DEC VT100           no function keys, have to use escape + number
  129. DEC VT220           F1 .. F8 mapped to F6 .. F13
  130. HP2392A             slooow, but ok
  131. HP700/92            ok, but very small font
  132. WRQ R1+             nice, fast & easy
  133. WRQ R2+             nice, fast & easy, F1 .. F8 mapped to F6 .. F13
  134. 386BSD pcvt         fully supported
  135. 386BSD pc3          supported
  136.  
  137.  
  138. Good Luck and Have Fun !
  139.  
  140. Hellmuth
  141.  
  142. e-mail:    hm@hcshh.hcs.de (...mcsun!unido!hcshh!hm)
  143. s-mail:    c/o HCS GmbH, Oldesloer Str 97-99, 22457 Hamburg, Germany
  144. tel:    +49/40/55903-0 or +49/40/55903-170    (business)
  145. fax:    +49/40/5591486                (business)
  146. tel:    +49/40/384298                (private)
  147.