.TH FISG "1" "Sep. 12, 2004" "fisg 0.3.12" ""
.SH "NAME"
.B fisg 
\- generates web pages from IRC logs
.SH "SYNOPSIS"
.B fisg
.RI [ options ] 
.RI [ source#1 ] 
.RI [ source#2... ]
.br 

.SH "DESCRIPTION"
.B Fisg 
is a free utility to generate nice looking web page(s) from your IRC logs,
containing various interesting statistics and amusing facts based on
the computed statistical information.

.B Fisg
has been designed for speed, simplicity and small memory footprint.
It is written in ANSI-C and only depends on standard libc (runtime), so it
can be compiled and used in very wide range of systems.
 
.SH "OPTIONS"
\fB\-?, \fB\-\-help\fR
Shows a brief help
.TP
\fB\-V, \fB\-\-version\fR
Show version information
.TP
\fB\-o, \fB\-\-output\fR <file> 
Specify output file (default: stdout)
.TP
\fB\-u, \fB\-\-user\-file\fR <file>
Specify users\-file (default: users.cfg)
.TP
\fB\-f, \fB\-\-format\fR <format>
Specify input format. Currently irssi, eggdrop and mIRC are supported. (no default)
.TP
\fB\-O, \fB\-\-output\-format\fR <format>
Specify output format. Currently xhtml (XHTML/CSS) and xhtmls (XHTML/CSS with table borders)
.TP
\fB-L, \fB\-\-list\-formats\fR
Show list of predefined log\- and output\-formats.
.TP
\fB-c, \fB\-\-config\fR <file>
Specify configuration file (no default)
.TP
\fB-q, \fB\-\-quiet\fR
Use multiple times for more silence.
.TP
\fB-d, \fB\-\-dump\-userfile\fR
Dump internal user information to given file.
This option can be used to create initial users-file or to debug
fisg's functionality related to automagic user-handling.

.SH "EXAMPLES"
If you have log for channel #kewlchan produced by Irssi in directory
"~/irclogs/IRCNet/"  (aka under your home directory), you could use
the following command:

\&	fisg -c kewlchan.cfg -f irssi ~/irclogs/IRCNet/#kewlchan.log -o kewlstats.html


If there are multiple logfiles, you need to specify them all. Under UNIX
you might wish to use find(1) -command, for example:

\&	fisg -c kewlchan.cfg -f irssi `find ~/irclogs -iname "*kewlchan.*"` -o kewlstats.html

.SH "SEE ALSO"
The full documentation for
.B fisg

.SH "REPORTING BUGS"
Report
Bugs should be reported via bug tracker system, see FISG homepage (http://www.tnsp.org/fisg.php) for details. In case you don't want
to use BTS, send reports via e-mail to <ccr@tnsp.org>. Problems with Debian- or other packages should be reported to appropriate package maintainers.

.SH "AUTHOR"
.B fisg
was written by Matti Hämäläinen <ccr@tnsp.org>. This manpage was written by Alexander Wirt <formorer@debian.org> for the Debian Distribution.