home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / shell / pdksh.5.2.3.README < prev    next >
Encoding:
Text File  |  1996-01-10  |  6.5 KB  |  146 lines
  1. ksh was compiled quad-fat my mmalcolm crawford <m.crawford@dcs.shef.ac.uk>.
  2.  
  3. The compilation reported a number of warnings of the form:
  4.  
  5. For architecture m68k:
  6. In file included from /NextDeveloper/Headers/bsd/sys/time.h:106,
  7.                  from ksh_time.h:5,
  8.                  from c_sh.c:12:
  9. /NextDeveloper/Headers/ansi/time.h:26: warning: useless keyword or type name in empty declaration
  10. /NextDeveloper/Headers/ansi/time.h:26: warning: empty declaration
  11.  
  12. It is assumed that these are not important!
  13.  
  14. -------------------------
  15. From the original README:
  16.  
  17.  
  18. Last updated June '95 for pdksh-5.2.3.
  19.  
  20. PD-ksh is a mostly complete AT&T ksh look-alike (see NOTES file for a list
  21. of things not supported).  Work is currently underway to make it fully
  22. compatible with both POSIX and AT&T ksh (when the two don't conflict).
  23.  
  24. Since pdksh is free and compiles and runs on most common unix systems, it
  25. is very useful in creating a consistent user interface across multiple
  26. machines.  For example, in the CS dept. of MUN, pdksh is installed on a
  27. variety of machines including Suns, HPs, DecStations, pcs running Linux,
  28. etc., and is the login shell of ~4500 users.
  29.  
  30. PDksh is currently being maintained by Michael Rendell (michael@cs.mun.ca),
  31. who took over from Simon J. Gerraty (sjg@zen.void.oz.au) at the later's
  32. suggestion.  A short list of things that have been added since the last
  33. public pdksh release (4.9) are auto-configuration, arrays, $(( .. )),
  34. [[ .. ]], variable attributes, co-processes, many POSIXisms and many bug
  35. fixes.  See the NEWS and ChangeLog files for other features added and bugs
  36. fixed.
  37.  
  38. Note that pdksh is provided AS IS, with NO WARRANTY, either expressed or
  39. implied.  Also note that although the bulk of the code in pdksh is in the
  40. public domain, some files are copyrighten (but freely distributable) and
  41. subject to certain conditions (eg, don't remove copyright, document any
  42. changes, etc.).
  43.  
  44. If you would like to be notified via email of new releases as they become
  45. available, send mail to pdksh-request@cs.mun.ca with subject
  46. "send release notifications" (or "don't send release notifications" to stop
  47. them).
  48.  
  49. Files of interest:
  50.     NEWS        short list of noticeable changes in various versions.
  51.     CONTRIBUTORS    short history of pdksh, people who contributed, etc.
  52.     NOTES        lists of known bugs in pdksh, at&t ksh, and posix.
  53.     PROJECTS    list of things that need to be done in pdksh.
  54.     BUG-REPORTS    list of recently reported bugs that have been fixed
  55.             and all reported bugs that haven't been fixed.
  56.     etc/*        system profile and kshrc files used by Simon J. Gerraty.
  57.     misc/README*    readme files from previous versions.
  58.     misc/Changes*    changelog files from previous versions.
  59.     os2/*        files and info needed to compile ksh on os/2.
  60.  
  61. Compiling/Installing:
  62.     * edit options.h and define/undef the options therein.
  63.     * run configure: this is a GNU autoconf configure script that will generate
  64.       a Makefile and a config.h.  Some of the useful options to configure are:
  65.     --prefix=PATH        indicates the directory tree under which the binary
  66.                 and man page are installed (ie, PATH/bin/ksh and
  67.                 PATH/man/man1/ksh.1).
  68.                 The default prefix is /usr/local.
  69.     --exec-prefix=PATH  overrides --prefix for machine dependent files
  70.                 (ie, the ksh binary)
  71.     --verbose        show what is being defined as script runs
  72.       Note that you don't have to build in the source directory.  To build
  73.       in a separate directory, do something like:
  74.         $ mkdir objs
  75.         $ cd objs
  76.         $ ../configure --verbose
  77.         ....
  78.         $ make
  79.       See the file INSTALL for a complete description of configure and its
  80.       options.
  81.     * miscellaneous configuration notes:
  82.     * If your make doesn't understand VPATH, you must compile in
  83.       the source directory.
  84.     * On DecStations, MIPS and SONY machines with older C compilers that
  85.       can't handle "int * volatile x", you should use gcc or turn off
  86.       optimization.  The problem is configure defines volatile to nothing
  87.       since the compiler can't handle it properly, but the compiler does
  88.       optimizations that the volatile is meant to prevent.   So.  Use gcc.
  89.     * On MIPS RISC/os 5.0 systems, sysv environment, <signal.h> is
  90.       messed up - it defines sigset_t, but not any of the rest of
  91.       the posix signals (the sigset_t typedef should be in the
  92.       ifdef KERNEL section) - also doesn't have waitpid() or wait3().
  93.       Things compile up ok in the svr4 environment, but it dumps core
  94.       in __start (perhaps our system doesn't have the full svr4
  95.       environ?).  Try compiling in the bsd43 environ instead (still not
  96.       perfect - see BUG-REPORTS file), using gcc - cc has problems with
  97.       macro expansions in the argument of a macro (in this case, the ARGS
  98.       macro).
  99.     * run make: everything should compile and link without problems.
  100.     * run make check: this fires up ksh on a script that checks for some
  101.       known and some fixed bugs.  The script prints the list of tests
  102.       it expects to fail.
  103.     * run make install: this installs ksh (in /usr/local/bin/ksh by default,
  104.       or where ever you told configure to put things).
  105.  
  106. The following is a list of machines that pdksh is reported to work on:
  107.     -/PC Linux 1.x
  108.     -/PC NetBSD 0.9a
  109.     -/PC BSDI 1.1
  110.     -/PC FreeBSD 2.0
  111.     -/PC Interactive/Sunsoft 3.0.1 and 4.1 (note that problems have been
  112.         reported with isc3.2 - see the BUG-REPORTS file)
  113.     -/PC OS/2
  114.     Commadore/Amiga NetBSD 1.0
  115.     Dec/alpha OSF/1 v2.0 and v3.0
  116.     Dec/pmax Ultrix 4.2
  117.     Dec/vax Ultrix 2.2
  118.     Dec/vax 4.3BSD+NFS (MtXinu)
  119.     HP/pa HP-UX 9.01
  120.     MIPS/m120 RISC/os 5.0 (bsd43 environ)
  121.     Sun/sun4 SunOS 4.1.3
  122.     Sun/sun4 Solaris 2.3
  123.     Sun/sun386i SunOS 4.0.2
  124.     Sun/sun3 SunOS 4.0.3
  125.  
  126. Newer versions of pdksh may be available from ftp.cs.mun.ca:/pub/pdksh - you
  127. may want to check for one if you run into any problems, as the problem may
  128. already be fixed (you can get new release notifications automatically - see
  129. above).
  130.  
  131. You can send bug reports, fixes, and enchancements to pdksh@cs.mun.ca (please
  132. don't assume I will see bug reports that are posted to some newsgroup or
  133. mailing list - I probably won't).
  134. If you are reporting a bug (with or without a fix), please include
  135.     * the version of pdksh you are using (see version.c, or, if you are
  136.       running pdksh, try echo $KSH_VERSION),
  137.     * the machine, operating system and compiler you are using,
  138.     * and a description of how to repeat the bug (a small shell
  139.       script that demonstrates the bug is best).
  140. as well as the following, if relevant (if you aren't sure, include them)
  141.     * what options you are using (both options.h options and set -o options)
  142.     * the output of configure, with the verbose flag
  143.       (eg, ./configure --verbose)
  144.  
  145. Michael Rendell, michael@cs.mun.ca.
  146.