


building(fhist)					  building(fhist)


NAME
       fhist - file history and	comparison tools
       Copyright (C) 1991, 1992, 1993, 1994 Peter Miller.
       All rights reserved.

       Portions	of this	program	are
       Copyright (C) 1990 David	I. Bell.

       The fhist package is distrributed under the terms of the
       GNU General Public License, see the LICENSE section,
       below, for more information.

SPACE REQUIREMENTS
       You will	need about 600K	to unpack and build the	fhist
       package.	 (This is the worst case seen so far, most
       systems have binaries about 60% as big as this, 400K is
       more typical.)  Your mileage may	vary.

SITE CONFIGURATION
       The fhist package is configured using the configure shell
       script included in this distribution.

       The configure shell script attempts to guess correct
       values for various system-dependent variables used during
       compilation, and	creates	the Makefile and common/config.h
       files.  It also creates a shell script config.status that
       you can run in the future to recreate the current
       configuration.

       Normally, you just cd to	the directory containing fhist's
       source code and type
	      %	./configure
	      ...lots of output...
	      %
       If you're using csh on an old version of	System V, you
       might need to type
	      %	sh configure
	      ...lots of output...
	      %
       instead to prevent csh from trying to execute configure
       itself.

       Running configure takes a minute	or two.	 While it is
       running,	it prints some messages	that tell what it is
       doing.  If you don't want to see	the messages, run
       configure with its standard output redirected to
       /dev/null; for example,
	      %	./configure > /dev/null
	      %

       By default, configure will arrange for the make install
       command to install the fhist package's files in
       /usr/local/bin and /usr/local/man.  You can specify an
       installation prefix other than /usr/local by giving



								1





building(fhist)					  building(fhist)


       configure the option --prefix=PATH.

       You can specify separate	installation prefixes for
       architecture-specific files and architecture-independent
       files.  If you give configure the option	--exec-
       prefix=PATH the fhist package will use PATH as the prefix
       for installing programs and libraries.  Data files and
       documentation will still	use the	regular	prefix.
       Normally, all files are installed using the same	prefix.

       configure ignores any other arguments that you give it.

       On systems that require unusual options for compilation or
       linking that the	fhist package's	configure script does not
       know about, you can give	configure initial values for
       variables by setting them in the	environment.  In Bourne-
       compatible shells, you can do that on the command line
       like this:
	      $	CC='gcc	-traditional' LIBS=-lposix ./configure
	      ...lots of output...
	      $
       Here are	the make variables that	you might want to
       override	with environment variables when	running
       configure.

       Variable: CC
	       C compiler program.  The	default	is cc.

       Variable: INSTALL
	       Program to use to install files.	 The default is
	       install if you have it, cp otherwise.

       Variable: LIBS
	       Libraries to link with, in the form -lfoo -lbar.
	       The configure script will append	to this, rather
	       than replace it.

       If you need to do unusual things	to compile the package,
       the author encourages you to figure out how configure
       could check whether to do them, and mail	diffs or
       instructions to the author so that they can be included in
       the next	release.

BUILDING FHIST
       All you should need to do is use	the
	      %	make
	      ...lots of output...
	      %
       command and wait.  When this finishes you should	see a
       directory called	bin containing four files: fcomp, fhist,
       fmerge and txt2c.

       fcomp   The fcomp program is user to compare two	text
	       files.



								2





building(fhist)					  building(fhist)


       fhist   The fhist program is used to maintain and edit
	       history of a text file.

       fmerge  The fmerge program is used to merge together edits
	       from two	descendants of a file.

       txt2c   The txt2c program is a utility used to build the
	       fhist package; it is not	intended for general use
	       and should not be installed.

       You can remove the program binaries and object files from
       the source directory by using the
	      %	make clean
	      ...lots of output...
	      %
       command.	 To remove all of the above files, and also
       remove the Makefile and common/config.h and config.status
       files, use the
	      %	make distclean
	      ...lots of output...
	      %
       command.

       The file	aux/configure.in is used to create configure by	a
       GNU program called autoconf.  You only need to know this
       if you want to regenerate configure using a newer version
       of autoconf.

TESTING	FHIST
       The fhist package is accompanied	by a test suite.  To run
       this test suite,	use the	following command:
	      %	make sure
	      ...lots of output...
	      %

       This is successful if the last line of the test output
       reads "Passed All Tests".

       Please let the author know if any of the	tests fail, and
       why if you can work that	out.

INSTALLING FHIST
       As explained in the SITE	CONFIGURATION section, above, the
       fhist package is	installed under	the /usr/local tree by
       default.	 Use the --prefix=PATH option to configure if you
       want some other path.

       All that	is required to install the fhist package is to
       use the
	      %	make install
	      ...lots of output...
	      %
       command.	 Control of the	directories used may be	found in
       the first few lines of the Makefile file	if you want to



								3





building(fhist)					  building(fhist)


       bypass the configure script.

       The above procedure assumes that	the soelim(1) command is
       somewhere in the	command	search PATH.  The soelim(1)
       command is available as part of the GNU Roff package,
       mentioned previously in the PRINTED MANUALS section.  If
       you don't have it, but you do have the cook package, then
       a link from roffpp to soelim will also work.

       The above procedure also	assumes	that the
       $(prefix)/man/man1 and $(prefix)/man/man5 directories
       already exist.  If they do not, you will	need to	mkdir
       them manually.

PRINTED	MANUALS
       This distribution contains the sources to all of	the
       documentation for fhist.	 The author used the GNU groff
       package and a postscript	printer	to prepare the
       documentation.  If you do not have this software, you will
       need to substitute commands appropriate to your site.

       To print	copies of the README and BUILDING files, the
       following commands may be used
	      %	cd aux
	      %	groff -s -t -man *.man | lpr
	      %	cd ..
	      %
       This will produce about 6 pages.	 The "-s" flag means
       preprocess with the soelim(1) filter and	the "-t" flag
       means preprocess	with the tbl(1)	filter.

       To print	copies of the manual entries, the following
       commands	may be used
	      %	cd man1
	      %	groff -s -t -man *.1 | lpr
	      %	cd ..
	      %
       This will produce about 15 pages.

LICENSE
       This program is free software; you can redistribute it
       and/or modify it	under the terms	of the GNU General Public
       License as published by the Free	Software Foundation;
       either version 2	of the License,	or (at your option) any
       later version.

       This program is distributed in the hope that it will be
       useful, but WITHOUT ANY WARRANTY; without even the implied
       warranty	of MERCHANTABILITY or FITNESS FOR A PARTICULAR
       PURPOSE.	 See the GNU General Public License for	more
       details.

       You should have received	a copy of the GNU General Public
       License along with this program;	if not,	write to the Free



								4





building(fhist)					  building(fhist)


       Software	Foundation, Inc., 675 Mass Ave,	Cambridge, MA
       02139, USA.

       It should be in the LICENSE file	included in this
       distribution.

AUTHORS
       Peter Miller    UUCP    uunet!munnari!bmr.gov.au!pmiller
       /\/\*	       CSNET   pmiller@bmr.gov.au

       David I.	Bell   UUCP    uunet!munnari!pdact.pd.necisa.oz.au!dbell
		       CSNET   dbell@pdact.pd.necisa.oz.au













































								5


