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