home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / gnu / pdksh-src.lha / src / amiga / pdksh / !README.AMIGA! next >
Text File  |  1993-12-01  |  3KB  |  76 lines
  1. This is the first release of the AmigaDOS port of pdksh, based on
  2. the official 4.5 release of pdksh.
  3.  
  4. Don't currently expect too much support for this, it's mainly for people
  5. who want a true /bin/sh compatible shell, and don't primarily want a
  6. replacement for the CLI SYSTEM SHELL.
  7.  
  8.  
  9. Notes to the sources
  10. ====================
  11. If you cross-check with MANIFEST you see that I didn't include the std/
  12. directory. This is simply because it's not needed with ixemul.library, and
  13. I didn't want to include something useless for AmigaDOS. If you plan to
  14. compile pdksh under an environment that would need std/, best thing is you
  15. get the original distribution from a site archiving comp.sources.misc.
  16.  
  17. DON'T FORGET TO SET THE PURE BIT ON KSH, archiving might have deleted it.
  18.  
  19.  
  20. Known problems
  21. ==============
  22. o This really is a problem of ixemul.library v39.41: vfork() crashes when
  23.   under kickstart 1.3. I don't know exactly what happend that made vfork()
  24.   crash under 1.3, it once worked. However, I don't feel like investigating
  25.   this to extremes, I don't use 1.3 any longer. If someone really wants
  26.   it fixed, contact me, and we'll find a way.
  27.  
  28. o don't stress ksh with ^C when in the commandline editor. Breaking usually
  29.   works to abort commands, don't use it when you already have the prompt.
  30.   This is probably a bug somewhere in select(), will need investigation.
  31.  
  32.  
  33. Debugging help
  34. ==============
  35. If you set the TRACE_LEVEL environment variable, ksh tells you the address
  36. of its main() function. This is extremely useful to interprete enforcer-
  37. output, since in vfork()d processes, hunk-o-matic won't work and enforcer
  38. doesn't output any hunk-offsets, just PC values. If you subtract the
  39. address of main() from that PC, you get a relative value, instead of an
  40. absolute, process dependant PC, which you can then use to look at the
  41. code in your favorite disassembler.
  42.  
  43.  
  44. libs/ixemul.library
  45. ===================
  46. This is the current version of the library, and it replaces the one
  47. distributed with gcc21-920420.lha. Don't use any old libraries, they are
  48. very buggy in those areas explored by ksh;-))
  49.  
  50.  
  51. ixpipe-handler/*
  52. ================
  53. This is the first version of a bridge between ixemul.library and 
  54. programs reading/writing to DOS filehandles. I'd be happy for comments
  55. on this! Be sure to mount the handler before trying to use I/O
  56. redirection on non-ixemul programs in ksh! Don't try to use it IXPIPE:
  57. like PIPE:, they're totally different! IXPIPE: is used automatically
  58. if a non-ixemul program is execve()'d for each file descriptor 0, 1 or
  59. 2 who's type is not that of a plain DOS file. A pipe would be an
  60. example of a non-dos type.
  61.  
  62.  
  63. Favorite usage
  64. ==============
  65. Setup a directory, assign BIN: to it, and copy ksh into BIN:sh. That way,
  66. you can have the usual
  67. SHELL=/bin/sh
  68. in your Makefile ;-))
  69.  
  70.  
  71. Happy testing!
  72.  
  73. -Markus Wild
  74.  
  75. <wild@nessie.cs.id.ethz.ch>  and  <wild@amiga.physik.unizh.ch>
  76.