home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / utils / shell / dialog-0.000 / dialog-0 / dialog-0.6c / old / INSTALL < prev    next >
Encoding:
Text File  |  1994-11-07  |  3.2 KB  |  86 lines
  1. INSTALLATION
  2. ------------
  3.  
  4.     1.  cd ./src
  5.  
  6.     2.  Go to step 3 if your system has ncurses (e.g. Linux).
  7.         Edit Makefile and remove -DHAVE_NCURSES from DEFS. Also
  8.             remove rc.c from SRCS and rc.o from OBJS. Change LIBS as
  9.             appropriate (Usually, it should be '-lcurses -ltermcap').
  10.             Go to step 6.
  11.  
  12.     3.  Edit Makefile and remove -DBROKEN_WSCRL from DEFS if you
  13.             are using ncurses 1.8.3 or newer. Menu scrolling should
  14.             be faster. DON'T REMOVE IT IF YOU ARE NOT USING AT LEAST
  15.             VERSION 1.8.3 OF NCURSES.
  16.         
  17.         (Stuart's NOTE: I recommend that you use this with ncurses 1.8.5
  18.         or later.  You can get it from ftp.netcom.com, in
  19.         /pub/zmbenhal/ncurses/1.8.5.taz.  I've not tested this release
  20.         with any older versions of ncurses.)
  21.  
  22.         4.  Edit dialog.h and change USE_SHADOW to FALSE if you don't
  23.             want shadowed dialog boxes. Also change USE_COLORS to
  24.             FALSE if you don't want colors. Note that 'dialog' will
  25.             check if the terminal supports colors, and will use mono
  26.             settings if it doesn't, so USE_COLORS won't do any harm
  27.             even if you have a mono display. Also note that USE_SHADOW
  28.             implies USE_COLORS. These two options can be changed at
  29.             run-time using the run-time configuration file (see below).
  30.  
  31.     5.  Edit colors.h to change default color definitions if you
  32.             don't like the defaults. These are only compiled in defaults,
  33.             you can change them at run-time using the run-time
  34.             configuration file.
  35.  
  36.     6.  'make depend; make install' will compile and install the
  37.             binaries in /bin (change BINDIR in Makefile if you want to 
  38.         install elsewhere).
  39.         
  40.         (Stuart's NOTE: dialog now installs into /bin because
  41.         that's where it goes on Slackware.)
  42.  
  43.         7.  'make install.man' will install the man page to
  44.             /usr/local/man (change MANDIR in Makefile if you want to
  45.             install elsewhere).
  46.  
  47.         8.  You can then try the sample shell scripts in the samples
  48.             directory (make sure the environment variable DIALOG is
  49.             not set, the scripts use it to find the dialog binary, if
  50.             it's not set, "../src/dialog" will be used).
  51.  
  52.     9.  Don't forget to mail me (mail address at end of this file)
  53.             if you find any bugs, have some good color settings to
  54.             contribute or just want to tell me that you like it, Don't
  55.             mail me if you don't like it :-)
  56.  
  57.  
  58.  
  59. RUN-TIME CONFIGURATION
  60. ----------------------
  61.  
  62.     1.  Create a sample configuration file by typing:
  63.  
  64.                 "dialog --create-rc <file>"
  65.  
  66.         2.  At start, 'dialog' determines the settings to use as follows:
  67.  
  68.               a)  if environment variable DIALOGRC is set, it's value
  69.                   determines the name of the configuration file.
  70.  
  71.               b)  if the file in (a) can't be found, use the file
  72.                   $HOME/.dialogrc as the configuration file.
  73.  
  74.               c)  if the file in (b) can't be found, use compiled in
  75.                   defaults.
  76.  
  77.     3.  Edit the sample configuration file and copy it to some place
  78.             that 'dialog' can find, as stated in step 2 above.
  79.  
  80.  
  81.  
  82.  
  83. Comments and bug reports welcome.
  84.  
  85. - Savio Lam (lam836@cs.cuhk.hk)
  86.