.\" install-log.1.in
.\"
.\" install-log's man page.
.\"
.\" $Id: install-log.1.in,v 1.2 2002/12/20 11:15:27 andy Exp $
.\"
.\" Copyright (C) 2002 Andy Goth <unununium@openverse.com>
.\" For more information visit http://ioioio.net/devel/install-log/
.\" 
.\" 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 Software Foundation, Inc.,
.\" 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
.\"
.TH "install-log" "1" "1.9" "Andy Goth and James Reeves" "System"
.SH "NAME"
.LP 
install\-log \- logs source installations
.SH "SYNTAX"
.LP 
install\-log <\fIpackage\fP> [\fIOPTIONS\fP]
.SH "DESCRIPTION"
.LP 
install\-log is a simple program to aid package management when installing from
source code. Run "install\-log <package\-name>" immediately after you type "make
install" (or whatever you do to install something), and it'll make a list of
all the changes to your filesystem to $(LOGDIR)/<package\-name> for you to
review when uninstalling, upgrading, or just simply taking account of your
system. It's also good for identifying the owner of a particular file; just
grep for it in $(LOGDIR)/*.
.SH "OPTIONS"
.LP 
.TP 
\fB\-e\fR, \fB\-\-edit\fR
Edit log.
.TP 
\fB\-E\fR, \fB\-\-editor=\fR\fICMD\fP
Use \fICMD\fP with \fB\-\-edit\fR.
.TP 
\fB\-f\fR, \fB\-\-force\fR
Replace existing installation log.
.TP 
\fB\-h\fR, \fB\-\-help\fR
Output a brief help message.
.TP 
\fB\-i\fR, \fB\-\-include=\fR\fIDIR1:DIR2:...\fP
Scan these directories.
.TP 
\fB\-l\fR, \fB\-\-logdir=\fR\fIDIR\fP
Put logs in \fIDIR\fP.
.TP 
\fB\-q\fR, \fB\-\-quiet\fR
Suppress output (except for error messages).
.TP 
\fB\-r\fR, \fB\-\-root=\fR\fIDIR\fP
Use \fIDIR\fP as the root directory.
.TP
\fB\-c\fR, \fB\-\-chrootvar=\fR\fINAME\fP
Use ${NAME} as the root directory.  \-\-root takes precedence over the value
of this variable.  Defaults to $(CHROOTVAR) (see below).
.TP 
\fB\-v\fR, \fB\-\-verbosity=\fR\fILEVEL\fP
Report progress with a given level of detail.
.TP 
\fB\-x\fR, \fB\-\-exclude=\fR\fIDIR1:DIR2:...\fP
Exclude these directories.
.SH "FILES"
.LP 
\fI/etc/install\-log.rc\fP 
.br 
\fI$(LOGDIR)\fP 
.SH "ENVIRONMENT VARIABLES"
.LP 
.TP 
\fB$(CHROOTVAR)\fP
If set, this is used as the root directory.  (Useful for installing Linux From
Scratch.)
.SH "EXAMPLES"
.LP 
To run this program the standard way type:
.LP 
install\-log mypackage
.SH "AUTHORS"
.LP 
Andy Goth <unununium@openverse.org>
.br
James Reeves <jreeves@fullcircuit.com>
.SH "SEE ALSO"
.LP 
touch(1), find(1L), xargs(1L)
.LP 
Homepage: http://ioioio.net/devel/install\-log/