build(tardy)					     build(tardy)



NAME
       tardy - a tar post-processor
       Copyright  (C)  1993,  1994, 1995, 1996,	1998, 1999, 2000,
       2001, 2002 Peter	Miller;
       All rights reserved.

       The tardy program is distributed	under the  terms  of  the
       GNU  General  Public  License.	See  the LICENSE section,
       below, for more details.

       tardy a., slow to act, behind time.

SPACE REQUIREMENTS
       You will	need about 500KB to unpack and	build  the  tardy
       program.	 Your mileage may vary.

SITE CONFIGURATION
       The  tardy program is configured	using the configure shell
       script included in this distribution.

       The configure shell script attempts to guess correct  val-
       ues  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 configu-
       ration.

       Normally,  you just cd to the directory containing tardy'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 run-
       ning,  it prints	some messages that tell	what it	is doing.
       If you don't want to see	the messages, run configure using
       the --quiet option; for example,
	      %	./configure --quiet
	      %

       By  default,  configure	will arrange for the make install
       command	to  install  the   tardy   program's   files   in
       /usr/local/bin  and  /usr/local/man.   You  can specify an
       installation prefix other than /usr/local by  giving  con-
       figure the option --prefix=PATH.

       You  can	specify	separate installation prefixes for archi-
       tecture-specific	files and architecture-independent files.
       If  you	give  configure	the option --exec-prefix=PATH the
       tardy 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	tardy 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  over-
       ride 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 instruc-
       tions  to  the  author so that they can be included in the
       next release.

BUILDING TARDY
       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  one	file: tardy.  The
       tardy program is	a tar post-processor.

       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	etc/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	TARDY
       The tardy program comes with a test suite.   To	run  this
       test suite, use the command
	      %	make sure
	      ...lots of output...
	      Passed All Tests
	      %

       The  tests  take	 a  about  a minute each, with a few very
       fast, and a  couple  very  slow,	 but  it  varies  greatly
       depending on your CPU.

INSTALLING TARDY
       The  tardy  program 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 tardy program 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
       bypass the configure script.

       The above procedure assumes that	the soelim(1) command  is
       somewhere  in the command search	PATH.  The soelim(1) com-
       mand is available as part of the	GNU Roff package.

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

PRINTED	MANUALS
       This distribution contains the sources to all of	the docu-
       mentation for tardy.  The author	used the GNU groff  pack-
       age and a postscript printer to prepare the documentation.
       If you do not have this software, you will need to substi-
       tute commands appropriate to your site.

       To  print  copies  of  the README, and BUILDING files, the
       following commands may be used
	      %	groff -t -man etc/*.man	| lpr
	      %
       This will produce about 4 pages.	 The "-t" flag means pre-
       process with tbl(1).

       To  print  copies  of the manual	entry, the following com-
       mands may be used
	      %	cd man1
	      %	groff -s -t -man *.1 | lpr
	      %	cd ..
	      %
       This will produce about 3 pages.	 The "-s" flag means pre-
       process with soelim(1), and the "-t" flag means preprocess
       with tbl(1).

GETTING	HELP
       If you need assistance with the tardy program,  please  do
       not hesitate to contact the author at
	      Peter Miller <millerp@canb.auug.org.au>
       Any and all feedback is welcome.

       When reporting problems,	please include the version number
       given by	the
	      %	tardy -version
	      tardy version a.b.cccc
	      ...
	      %
       command.



LICENSE
       The tardy 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  Founda-
       tion; either version 2 of the License, or (at your option)
       any later version.

       The tardy 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  PAR-
       TICULAR	PURPOSE.   See the GNU General Public License for
       more details.

       It should be in the LICENSE file	included in this  distri-
       bution.

AUTHOR
       Peter Miller   EMail:   millerp@canb.auug.org.au
       /\/\*		WWW:   http://www.canb.auug.org.au/~millerp/



						     build(tardy)
