home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / forut062.zip / ForUtil-0.62 / README < prev    next >
Text File  |  1996-08-21  |  4KB  |  101 lines

  1. MS-dos users, read msdos/readme.dos and lib/readme
  2. MS-windows users, read windows/readme.txt
  3.  
  4. Compilation & Installation Instructions
  5. ---------------------------------------
  6.  
  7. 1. Type configure at the top-level directory. 
  8.  
  9.    The file INSTALL contains information on how to run configure.
  10.  
  11.    By default, install will place binaries and manual pages in
  12.    /usr/local/bin and /usr/local/man/[man,cat]1. If you want them in
  13.    another directory, you can tell configure what directory make install
  14.    should use by running configure with the --prefix=PATH option. 
  15.  
  16.    If configure can't find libgdbm.a, it will give you a warning saying
  17.    just that. The consequence to this is that you will not be able to
  18.    compile the common utilities. If you do want to build them, you need
  19.    to get and compile gdbm. You can get gdbm from a large number of ftp
  20.    sites around the world. Compiling gdbm is simple, just follow the 
  21.    instructions that come with it.
  22.  
  23. 2. Check the top-level makefile and, if necessary, set appropriate values
  24.    for CCFLAGS, LDFLAGS, INCLUDES and LOADLIBES
  25.  
  26.    For HPUX, you do need to set -Aa (for ansi compatibility) as well as
  27.    -D_HPUX_SOURCE and -D_POSIX_SOURCE.
  28.    If the compilation fails, most of the time it has something to do with
  29.    adding the proper defines, such as -D_POSIX_SOURCE.
  30.  
  31.    By default, CFLAGS is set to -g. You might want to use -O or -O2 instead
  32.    since the performance loss by using -g is quite considerable.
  33.  
  34.    If you only want to build a certain part of the source tree, say you
  35.    only want to build ffscan and fflow, you can do this by changing the
  36.    SUBDIRS line in the toplevel makefile until it reads:
  37.      SUBDIRS= lib fflow ffscan
  38.  
  39.    Never remove ``lib'' from this line.
  40.  
  41. 3. Type make at the top-level directory to build everything.
  42.  
  43. 4. Type make install to install the binaries
  44.  
  45. 5. Install the manual pages. You have two options here:
  46.    make install.cat will install preformatted manual pages in man/cat1
  47.    make install.man will install the raw groff manual pages in man/man1
  48.  
  49.    Alternatively, you can type
  50.        make install.all
  51.    which will install the binaries, groff source manpages and formatted 
  52.    man pages.
  53.  
  54. 6. Type make clean or remove the entire source tree.
  55.  
  56.  
  57. Other things to mention
  58. -----------------------
  59.  
  60. gdbm:
  61.    If you have build gdbm and you have set INCLUDES to point to the
  62.    path where you have build libgdbm, be _sure_ to remove or rename 
  63.    the autoconf.h file in the gdbm directory. 
  64.    If you do not do this, make will get confused and will not know what 
  65.    autoconf.h it must use when compiling ForUtil.
  66.  
  67.  
  68. Man pages:
  69.    ForUtil comes with four different types of manual pages, all of them 
  70.    are in the man/ directory:
  71.  
  72.    - doc; contains plain text versions of the manual pages
  73.    - html; contains html versions of the manual pages
  74.    - man; contains the groff source for the manual pages
  75.    - preformat; contains formatted manual pages.
  76.  
  77.    MSDOS users might want to get a copy of less for MSDOS, which is capable 
  78.    of showing formatted unix manual pages.
  79.  
  80.  
  81. flex:
  82.    If you do not have flex, do not touch any of the .l files.
  83.    Make will try to create .c files out of these and fail because you do
  84.    not have flex.
  85.  
  86. If you are completely and utterly unable to compile these programs, contact
  87. me and I will try to get you a binary.
  88.  
  89. The latest source (and binaries) are available at the following URL:
  90. http://www.xs4all.nl/~ripley/RSD/ForUtil.html
  91.  
  92. Koen D'Hondt.
  93. Ripley Software Development.
  94. -------------------------------------------------------------------------------
  95. Reach Out At:     email: ripley@xs4all.nl
  96. Surf The Web:    http://www.xs4all.nl/~ripley
  97. -------------------------------------------------------------------------------
  98. $Source: /usr/local/rcs/ForUtil/toplevel/RCS/README,v $
  99. $Revision: 1.1 $
  100. -------------------------------------------------------------------------------
  101.