home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume23 / rc / part01 / README < prev   
Encoding:
Text File  |  1991-10-18  |  3.3 KB  |  83 lines
  1. This is release 1.2 of rc.
  2.  
  3. Read COPYRIGHT for copying information. All files are
  4.  
  5. Copyright 1991, Byron Rakitzis.
  6.  
  7. COMPILING
  8.  
  9. rc was written in portable ANSI C. For those without gcc or some other
  10. compiler which groks prototypes and (void *), there is a set of awk
  11. scripts which convert the source into old-style C. To do this, type
  12. "make C". This is a nondestructive operation; the new code will be
  13. placed in a subdirectory called "C".
  14.  
  15. Please read the Makefile, and make sure that the configuration parameters
  16. are appropriate for your system. Also, look at config.h and stddef.h.
  17.  
  18. To compile the history program, type "make history". This will create
  19. 1 binary and three soft links pointing at the binary. They are respectively
  20. named -, --, -p and --p.
  21.  
  22. BUGS
  23.  
  24. Send bug reports to byron@archone.tamu.edu. If a core dump is
  25. generated, sending me a backtrace will help me out a great deal. You
  26. can get a backtrace like this:
  27.  
  28.     ; gdb rc core
  29.     (gdb) where
  30.     <<<BACKTRACE INFO>>>
  31.     (gdb)
  32.  
  33. Also, always report the machine, compiler and OS used to make rc.  It's
  34. possible I may have access to a machine of that type, in which case it
  35. becomes much easier for me to track the bug down.
  36.  
  37. If you are using gcc, please make sure that you have a recent version of
  38. the compiler (1.39 and up) before you send me a note; I have found that
  39. older versions of gcc choke over rc and generate bad code on several
  40. architectures.
  41.  
  42. MAN PAGE
  43.  
  44. The man page works with nroff on my Sun, but I had to use groff in
  45. order to get the man page typeset for a laser printer. I am assuming
  46. that ditroff will also format rc.1 correctly for a printer. If anyone
  47. can tell me how to get BSD troff to do this, I would be grateful.
  48.  
  49. FEEPING CREATURISM
  50.  
  51. See the end of the man page, under "INCOMPATABILITIES" for (known?)
  52. differences from the "real" rc. Most of these changes were necessary
  53. to get rc to work in a reasonable fashion on a real UNIX system; a
  54. few were changes motivated by concern about some inadequacies in
  55. the original design.
  56.  
  57. CREDITS
  58.  
  59. This shell was written by me, Byron Rakitzis, but kudos go to Paul
  60. Haahr for letting me know what a shell should do and for contributing
  61. certain bits and pieces to rc (notably the limits code, most of which.c
  62. and the backquote redirection code), and to Hugh Redelmeier for running
  63. rc through his fussy ANSI compiler and thereby provoking interesting
  64. discussions about portability, and also for providing many valuable
  65. suggestions for improving rc's code in general. Finally, many thanks
  66. go to David Sanderson, for reworking the man page to format well with
  67. troff, and for providing many suggestions both for rc and its man page.
  68.  
  69. Thanks to Boyd Roberts for the original history.c, and to Hugh again
  70. for re-working parts of that code.
  71.  
  72. Of course, without Tom Duff's design of the original rc, I could not
  73. have written this shell (though I probably would have written *a*
  74. shell). Almost of all of the features, with minor exceptions, have been
  75. implemented as described in the Unix v10 manuals. Hats off to td for
  76. designing a C-like, minimal but very useful shell.
  77.  
  78. Tom Duff has kindly given permission for the paper he wrote for UKUUG
  79. to be distributed with this version of rc (called "plan9.ps"). Please
  80. read this paper bearing in mind that it describes a program that was
  81. written at AT&T and that the version of rc presented here differs in some
  82. respects.
  83.