home *** CD-ROM | disk | FTP | other *** search
/ The UNIX CD Bookshelf / OREILLY_TUCB_UNIX_CD.iso / upt / examples / SOURCES / GLIMPSE / GLI40SRC.Z / GLI40SRC / glimpse-4.0.src / README.install < prev    next >
Encoding:
Text File  |  1996-11-22  |  6.2 KB  |  143 lines
  1. /* Copyright (c) 1994 Sun Wu, Udi Manber, Burra Gopal.  All Rights Reserved. */
  2. This is version 3.5 of the glimpse package - a tool to search
  3. entire file systems.  Please send any comments to glimpse@cs.arizona.edu.
  4. Check the file CHANGES for the changes since version 3.0 (there are
  5. many of them).  The files glimpse.1, glimpseindex.1, and 
  6. glimpseserver.1 are the manual pages.
  7.  
  8. Instructions for installing glimpse, glimpseindex, glimpseserver, and agrep:
  9.  
  10. 1. Both the agrep and index directories have individual Makefiles 
  11.    which you can use independently. You can make everything 
  12.    by just typing make in the root glimpse directory.
  13.  
  14. 2. To make individual binaries in a subdirectory "ddd", do the following:
  15.     cd ./ddd ; make ; cd ..
  16.  
  17. 3. To rebuild everything from scratch, do the following:
  18.     make clean
  19.    This however does not remove the binaries that currently exist in ./bin
  20.    You can then proceed with the above steps. However, see (4) below.
  21.  
  22. 4. A small quirk when making clean: if you make clean from the glimpse-root
  23.    directory, it will cleanup all subdirectories except the subdirectory
  24.    "libtemplate". You must do:
  25.     cd libtemplate ; make clean ; cd ..
  26.    to cleanup that subdirectory. This was necessary so that Glimpse's
  27.    makefiles could be kept independent of "libtemplate"'s makefiles (which
  28.    are a part of the Harvest source distribution).
  29.  
  30. 5. Binaries for SunOS, Solaris, and Dec Alpha OSF/1 are currently
  31.    available for version 3.5.  Binaries for other platforms are
  32.    available for 3.0, and will soon be posted for 3.5. 
  33.    (NOTE: we provide Solaris, Dec OSF/1, HP, Linux, NeXT, IBM-RS6000 and
  34.    SGI makefiles. To compile for these platforms, use:
  35.     make -f Makefile.solaris
  36.    or
  37.     make -f Makefile.alpha
  38.    or
  39.     make -f Makefile.hp
  40.    or
  41.     make -f Makefile.linux # (can work for FreeBSD too)
  42.    or
  43.     make -f Makefile.NeXT
  44.    or
  45.     make -f Makefile.rs6000
  46.    or
  47.     make -f Makefile.sgi
  48.    respectively).
  49.    
  50.    We will try to make this more convenient in the future by distributing an
  51.    autoconf script so that the individual makefiles will not be necessary.
  52.    (We have a script "configure" in our distribution but we haven't tested
  53.    it as much as we would have liked: however, it MAY work on your system.)
  54.  
  55. NOTES:
  56. ------
  57.  
  58.    People in our mailing list have commented that the make files we provide
  59.    work on many other architectures too. We recommend that you do a pairwise
  60.    "diff" of these makefiles to find out whether they support the options you
  61.    need before trying to modify makefiles to suit your environment. Often a
  62.    few changes to compiler options, etc., are enough to port glimpse to a
  63.    new architecture / OS. Source code modifications are usually not necessary.
  64.  
  65.    We request you to mail us any changes to the Makefile (or the source) that
  66.    are necessary to port glimpse to your architecture, and the corresponding
  67.    binaries, so that we can include it in our distribution. We will appreciate
  68.    any suggestions and will duly acknowledge all contributions.
  69.  
  70. Some comments about portability:
  71. --------------------------------
  72.  
  73. 6. You must define HAVE_DIRENT_H in agrep/Makefile, index/Makefile, compress/Makefile
  74.    to be 1 or 0 depending on whether your machine has /usr/include/dirent.h
  75.    or /usr/include/sys/dir.h. We found that on most machines/OSs like SunOS4.1,
  76.    Solaris, Ultrix, AIX, OSF/1, HPUX and SGI IRIX 5.3, HAVE_DIRENT_H should be 1.
  77.    On NeXT, HAVE_SYS_DIR_H should be 1 (the rest should be 0).
  78.  
  79. 7. On Solaris, "RANLIB" should be define to be "true" in
  80.    agrep/Makefile.solaris and compress/Makefile.solaris.
  81.  
  82. 8. On Solaris (at least the version we have), the library archive 
  83.    program "ar" is in /usr/ccs/bin/ar instead of /usr/bin/ar. 
  84.    You must define "AR" in agrep/Makefile.solaris and compress/Makefile.solaris
  85.    appropriately or set your PATH to include the appropriate directory name.
  86.  
  87. 9. On Solaris you have to link the glimpse executables with the
  88.    socket and nls libraries by specifying "-lsocket" and "-lnsl" to the
  89.    make rules for "glimpse" and "glimpseserver".
  90.  
  91. 10. On the DEC ALPHA and HP, the make variable "CC" was changed from
  92.    "gcc" to "cc".
  93.  
  94. 11. If you have the utime() routine and <utime.h>, define the make variable
  95.    UTIME to 1 in glimpse/Makefile and compress/Makefile. Else define it to 0.
  96.  
  97. 12. If you want to support the international character set (ISO_CHAR_SET), define
  98.    the make variable ISO_CHAR_SET to 1 in glimpse/Makefile. Else define it to 0.
  99.  
  100. 13. If you have the function strerr() on your system, #define HAVE_STRERROR to 1
  101.    in libtemplate/autoconf.h, else #undef it (or leave the definition in /**/).
  102.    This is necessary on some BSD systems (some of our users have said so)
  103.    and on NeXT (Gerald Wildgruber, gewil@ue801be.ppp).
  104.  
  105. 14. If you need to add any new macros or flags, you can edit the file:
  106.     glimpse/agrep/config.h
  107.    and add whatever is needed to make porting easy on your machine / OS.
  108.    This file is included throughout glimpse source code.
  109.  
  110. 15. On BSD, it may be necessary to define DONTUSESORT_T_OPTION in the
  111.    Makefile for glimpseindex since -T in some BSD systems is defined as
  112.    an alternative record separator rather than to specify a directory
  113.    other than /tmp to store sort-temporary files.
  114.     
  115.  
  116. Porting to other platforms, special contributions:
  117. --------------------------------------------------
  118. We provide and maintain the binaries for the following platforms:
  119. a. SUNOS4.1.1
  120. b. SUNOS4.1.3
  121. c. Solaris 5.3
  122. d. Dec OSF/1 Alpha
  123. You can address all questions regarding them to "glimpse@cs.arizona.edu".
  124.  
  125. With glimpse-3.0, we are also distributing the following binaries/Makefiles
  126. that some of the people in our mailing list have sent us. We would like to
  127. extend special thanks to them for providing us with binaries for platforms for
  128. which we do not have access. We request you to contact them if you need any
  129. porting tips to these platforms or have any questions regarding these binaries.
  130.  
  131. Platform ported to    Person to contact
  132. e. AIX-3.2.5        stamer@merlin.physik.uni-oldenburg.DE (Heinrich Stamerjohanns)
  133. f. HPPA, HPMC68K    Chris Dalton <crd@hplb.hpl.hp.com>
  134. g. IBM-RS6000        "CHRISM" <cmelikian@VNET.IBM.COM> (0)
  135. h. Linux        Jim Hurley <hurleyj@arachnaut.org>
  136. i. SGI            "Piroz Mohseni" <mohseni@shemp.tip.ameslab.gov>
  137. j. NeXT            gross@stimpy.ame.nd.edu
  138.  
  139. Thanks for your interest in glimpse.
  140.  
  141. Udi Manber, Burra Gopal, and Sun Wu.
  142.  
  143.