INSTALL 3.3 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192
  1. --------------------------------------------------------------------------
  2. Using GNU autoconfig
  3. --------------------------------------------------------------------------
  4. 1. If you retrieved a CVS version of this package, you need the GNU
  5. autoconf package to generate the configure script. This is done
  6. by running ./.prebuild in this directory which will automatically
  7. run autoconf with the appropriate options.
  8. 2. Run ./configure to generate config.h and the various Makefiles.
  9. ./configure --help gives a list of possible options with slightly
  10. longer descriptions in README.configure
  11. Note that configure options have changed since 2.6.x series.
  12. Some systems require unusual options for compilation or linking that
  13. the `configure' script does not know about. You can give `configure'
  14. initial values for variables by setting them in the environment. Using
  15. a Bourne-compatible shell, you can do that on the command line like
  16. this:
  17. CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure
  18. Or on systems that have the `env' program, you can do it like this:
  19. env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure
  20. Or if you're using a non Bourne-compatible shell, you can do:
  21. sh -c 'CFLAGS="-O2 -g" ./configure
  22. If you are making different versions of rxvt you can configure them
  23. to be installed with different names using configure arguments, e.g.
  24. ./configure --enable-languages --program-transform-name='s,rxvt,kxvt,;'
  25. 3. set any other main preferences:
  26. Edit "src/feature.h"
  27. Edit "config.h" if you didn't use ./configure options
  28. If you're cross-compiling, edit the following in "config.h"
  29. NO_XLOCALE
  30. SIZEOF_* # sizeof some types
  31. 4. Build it (repeat step 2 as desired):
  32. make
  33. 5. build rclock (small xclock with biff & appointments) and
  34. optionally edit rclock/feature.h to add/remove features:
  35. make clock
  36. 6. Install both rxvt and rclock:
  37. make install
  38. or install them separately
  39. (cd src; make install)
  40. (cd rclock; make install)
  41. you may also want to install doc/etc/rxvt.terminfo and
  42. doc/etc/rxvt.termcap
  43. 7 a. If compiled with UTMP_SUPPORT, you may need to install rxvt setuid
  44. root or setuid/setgid to match the file permissions on /etc/utmp
  45. 7 b. You may need to install setuid root anyway for some systems so that
  46. they can give you ownership of the tty devices.
  47. 8. On systems which dislike doc/rxvt.1
  48. (cd doc; rm rxvt.1; make rxvt.1)
  49. ===================================
  50. NB: If you were able to compile OK but running rxvt prints out
  51. "rxvt: could not obtain control of tty"
  52. running "make tests" from this directory (or from src/test)
  53. should give you a breakdown of the failure point which is
  54. useful to the developers in fixing the problem
  55. NB: SunOS (with/without gcc?) gets reported by configure as
  56. #undef STDC_HEADERS
  57. #define HAVE_SYS_IOCTL_H 1
  58. but the ioctl() defines aren't protected against multiple
  59. inclusion, in this case by <termios.h> so use a hack in
  60. "feature.h" to avoid the problem.
  61. Gave up checking for `STDC_HEADERS', since they really should be
  62. there and I don't want to deal with the problems when they don't
  63. exist.
  64. SunOS users might complain to the right places and get their
  65. system headers fixed so that one day the rest of us won't have
  66. to keep compensating :(
  67. SVR4 users (that aren't using gcc) will have to add -DSVR4 to
  68. CPPFLAGS for configure.
  69. --
  70. EOF