
Introduction
============

This package contains assorted utilities taken from FreeBSD and
OpenBSD.  They have been modified to the extent that was necessary
to make them build without warnings under Linux.

Currently, the package contains the following programs:

	apply 
	bindent (*)
	c89
	error  
	fpr 
	fsplit 
	jot 
	lam
	nawk 
	rs 
	unifdef 
	unvis
	vis 
	what 

(*) Some (well, presently only one) of the commands have been renamed
due to name collisions with versions typically installed by Linux
distributions.  The use of a 'b' prefix is similar to the convention
typically used for Berkeley yacc (byacc). Note that the prefix can be
changed or left out.  How to do this is explained in the Installation
section of this document.


Installation
============

From the top-level directory:

	make
	su
	make install

By default, all executables are installed in /usr/bin and the manpages
in /usr/man/man1.  This can be changed by defining the BINDIR and MANDIR
make variables on the command line when installing.  Say, we want the
executables in /usr/local/bin and the manpages in /usr/local/man/man1:

	make BINDIR=/usr/local MANDIR=/usr/local/man install

Some of the programs live in separate source directories.  Presently,
error, indent, and nawk have their own directories.  The rest live
in cmds.  It is possible to install only a subset of the commands by
changing to the relevant source directories before doing make install.

Prefixes
--------

As mentioned in the introduction, some of the commands have been
renamed to avoid name clashes by prepending the letter 'b'.  It is
possible to change this when installing, by defining the make variable
PREFIX to the preferred string.  'make PREFIX= install' will
effectively disable the prefixing, there by installing the commands
and their corresponding manpages with their original BSD names.
Think twice before doing this, as it may very well result in
programs already installed being overwritten.



Torsten Poulin, July 1999
<torsten@diku.dk>
