[lwatch-cvs] files/doc lwatch.1.in,NONE,1.1

[<ar...@us...>]

Update of /cvsroot/lwatch/files/doc
In directory sc8-pr-cvs1:/tmp/cvs-serv16859

Added Files:
	lwatch.1.in 
Log Message:
 - docbook-to-man is not needed to compile & install from CVS


--- NEW FILE: lwatch.1.in ---
.\" This -*- nroff -*- file has been generated from
.\" DocBook SGML with docbook-to-man on Debian GNU/Linux.
...\"
...\"	transcript compatibility for postscript use.
...\"
...\"	synopsis:  .P! <file.ps>
...\"
.de P!
\\&.
.fl			\" force out current output buffer
\\!%PB
\\!/showpage{}def
...\" the following is from Ken Flowers -- it prevents dictionary overflows
\\!/tempdict 200 dict def tempdict begin
.fl			\" prolog
.sy cat \\$1\" bring in postscript file
...\" the following line matches the tempdict above
\\!end % tempdict %
\\!PE
\\!.
.sp \\$2u	\" move below the image
..
.de pF
.ie     \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie     !\\*(f4 \{\
.	ft \\*(f4
.	ds f4\"
'	br \}
.el .ie !\\*(f3 \{\
.	ft \\*(f3
.	ds f3\"
'	br \}
.el .ie !\\*(f2 \{\
.	ft \\*(f2
.	ds f2\"
'	br \}
.el .ie !\\*(f1 \{\
.	ft \\*(f1
.	ds f1\"
'	br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
'\" t 
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n  
.TH "lwatch" "1" 
.SH "NAME" 
\fBlwatch\fR  \(em syntax highlighting for syslog/syslog-ng file 
.SH "SYNOPSIS" 
.PP 
\fBlwatch\fP [-C \fIfilename\fP]  [--config \fIfilename\fP]  [-f \fIfilename\fP]  [--fifo \fIfilename\fP]  [-coh]  [--create-fifo]  [--omit-rc]  [--help]  
.SH "Description" 
.PP 
The lwatch is a log colorizer. It reads syslog/syslog-ng data 
from named fifo or from stdin and displays colored logs into 
stdout. 
.PP 
The lwatch is highly user-customizable. It reads configuration 
data from file @CONFDIR@/lwatch.conf or (if given) from file provided with option 
\fB-C\fP 
.PP 
The way it works is simple. It reads a line from input, splits it 
into four parts: date, hostname, service name (with PID, if available) 
and real message. Each part has its own default color. You can redefine 
them in configuration file. Default colors as the same as in loco(1) 
[see: http://zjuul.net/~jules/loco/]. But lwatch is not only a static log 
colorizer. It is something more. It can colorize your logs any way 
you wish. You are able to set a new color for any part (date, host, 
service, message) using regexp based patterns. 
.SH "Configuration file" 
.PP 
There is no documentation for configuration file as for now. Look at 
provided file, there are a lot of comments there. 
.PP 
I am going to make some changes in configuration file before 
1.0-stable release. I will also provide docs about how to configure lwatch 
in this release. 
.SH "Command line options" 
.PP 
Type lwatch -h for options and their description. 
.SH "Running" 
.PP 
Preferred way to run lwatch is to read syslog messages from named fifo or from standard input. 
.PP 
If you use syslog you really want to read messages from named fifo. 
To do it put a line: 
 
.PP 
.nf 
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
*.*                                        |/tmp/your_fifo 
 
.fi 
in your syslog.conf. Create apropriate fifo and restart syslog, then run 
lwatch. You can also run lwatch before starting syslog. 
.PP 
Remember: 
 
.IP "   \(bu" 6 
fifo must exists 
.IP "   \(bu" 6 
proper name must be put in @CONFDIR@/lwatch.conf      
.PP 
In syslog-ng you can run lwatch directly from syslog, i.e.: 
 
.PP 
.nf 
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
log { source(src); destination(console_all);}; 
destination console_all {program("/usr/bin/lwatch -f- > /dev/tty11"); }; 
 
.fi 
 
.SH "Copyright" 
.PP 
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. 
 
...\" created by instant / docbook-to-man, Mon 17 Mar 2003, 15:39