home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / useful / dist / util / shell / pdksh / readme < prev    next >
Text File  |  1993-12-01  |  5KB  |  123 lines
  1.         Public Domain Korn Shell
  2.               Version 4.5
  3.  
  4. PD KSH:
  5.  
  6. This is the latest version of the PD ksh (pdksh).  It is not
  7. intended to be the ultimate shell but rather a usable ksh work
  8. alike.  For those of us who have to work on multiple systems it
  9. is nice to have the same user interface on all.  I resisted
  10. moving to the ksh on a Bull system at work for nearly a year due
  11. to the lack of a ksh on my Sun systems.  When I first picked up
  12. the 3.2 PD KSH a couple of years ago, it took only a few minutes
  13. to convert a C-shell fan to a ksh fan :-)  Pdksh is not 100%
  14. compatible with the ksh.  Having said that, I use it daily
  15. beside a real ksh88 and find them virtually indistinguishable.
  16.  
  17. I only run this shell on sun's and only for interactive use.  I
  18. use it on sun4c, sun3 and sun386 systems.  The shell itself has
  19. been compiled on each of these both with and without the
  20. POSIX/ANSI compatability libraries in ./std.  See the file
  21. MACHINES for details of systems that the shell has been built
  22. on.
  23.  
  24. I have released this version of the shell (with the kind
  25. permission of the previous maintainers and major contributors) to
  26. ensure that it is available from usenet archive sites.  Of
  27. course it remains in the Public Domain.  Equally obviously
  28. neither myself nor any other contributors make any claims of
  29. suitability etc.  Ie. NO WARRANTY!!!  If you make any changes
  30. and distribute them, please leave your own finger prints in the
  31. source.  Its bad enough being flamed for my own bugs let alone
  32. anyone elses :-)
  33.  
  34. WHATS NEW:
  35.  
  36. This update includes Job Control for System V (POSIX), many bug
  37. fixes and a simple history file mechanism.  See sh/ChangeLog.
  38.  
  39. HISTORY:
  40.  
  41. This shell was written by Eric Gisin.  It is based on Charles
  42. Forsyth's public domain V7 shell, which he later contributed to
  43. Minix.  John R MacMillan picked up Eric Gisin's version after
  44. Eric moved on to other projects (see ReadMe.jrm).
  45.  
  46. Since then there have been many contributors to this shell.
  47. Most have left their fingerprints within the source and various
  48. ReadMe.xxx and Changes.xxx files reflect their input.
  49.  
  50. This version is basically that known as Eric Gisin's version 3.3
  51. alpha which I obtained indirectly from John R MacMillan who is
  52. the most recent maintainer.  This version has much improved
  53. emacs-mode command line editing (my main contribution) plus
  54. enough extra emacs-mode features to make it difficult to
  55. distinguish from ksh88.  Bug fixes from various contributors are
  56. the only other changes from John MacMillan's version.
  57.  
  58. I have upped the version number for this release to distinguish
  59. it from the original 3.3 version.  This version is much improved
  60. despite the small number of new features.
  61.  
  62. INSTALLATION:
  63.  
  64. The file INSTALL contains intructions for building and
  65. installing the shell.  
  66.  
  67. The original instructions indicated that a POSIX compliant
  68. environment and possibly an ANSI compiler are required.  I have
  69. used both gcc and native Sun and the GreenHills ANSI compiler
  70. without problems.
  71.  
  72. The POSIX/STDC compatability stuff in ./std seems to cause lots
  73. of problems for some systems.  This was at least in part because
  74. I distributed it with half the librraies disabled :-), in any
  75. case the shell itself in ./sh can now be compiled without any of
  76. the ./std stuff which makes things much simpler on systems that
  77. have a real POSIX environment.
  78.  
  79. Porting to new environemnts can be a real pain.  I don't really
  80. plan to make a huge effort in this area since I expect that this
  81. shell will be mainly required on exotic or obscure systems (the
  82. ones that the vendor does not provide a ksh for).  Thus the
  83. small "market" does not warrant a C-news or X11 style
  84. portability effort.  Of course if people send patches for
  85. various systems I'm happy to try and integrate them.
  86.  
  87. ENVIRONMENT:
  88.  
  89. My main interest in this shell is for Sun workstations.  Every
  90. other UNIX system I use comes with a real ksh.  Being a strictly
  91. C-shell environment, some improved profile files are in order on
  92. Sun's.
  93.  
  94. The etc directory contains a set of useful environment files.
  95. These are the same files I use on several systems (many use a
  96. real ksh):
  97. ./etc/profile
  98. ./etc/sys_config.sh
  99. ./etc/ksh.kshrc    
  100.  
  101. The first one is obvious.  The second, sys_config.sh is sourced
  102. by /etc/profile and several other scripts.  It is used to
  103. determine the system type so that scripts like profile can be
  104. used on multiple platforms.
  105. The third one is also quite useful, add 
  106. . /etc/ksh.kshrc 
  107. to user's ~/.kshrc to simplify alias management.
  108.  
  109. BUGS:
  110.  
  111. Many folk have contributed to this shell.  
  112. I have attempted to credit (in sh/ChangeLog) the authors of bug
  113. fixes received since the previous release.
  114. There are surely still plenty of bugs to be found/fixed.
  115.  
  116. There is a template bug report in bug-report [borrowed from the
  117. X11R5 mit tree], just fill in the blanks and mail to
  118. pdksh-bug@zen.void.oz.au.  
  119.  
  120. I hope you find this shell as useful as I do...
  121.  
  122. Simon J. Gerraty <sjg@zen.void.oz.au>
  123.