.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH NAGZILLAC 1 "2009-06-03"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
nagzillac \- jabber relay bot client
.SH SYNOPSIS
.B nagzillac
.IR type ^ JID ^ message
.SH DESCRIPTION
This manual page documents briefly the
.B nagzillac
command.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
.\" respectively.
\fBnagzillac\fP is the client for nagzilla that takes the data you hand
it as argument and sends it over to the nagzilla daemon that will send
the message along.
.PP
.SH OPTIONS
\fBnagzillac\fP only takes one options that consists of three
arguments. They are seperated by the carret character(`\fI^\fP'),
although the last argument may contain carrets without any troubles.
Here is an explenation of the different parts:
.TP
.B type
This is the type of the message. It can be either room (which will send
the message to a jabber conference room) or chat (target should be a
jabber ID).
.TP
.B JID
This is the target for the message. If you choose \fIroom\fP type it
has to be a conference room name or complete ID. A single room without
any @ in it will get sent to the configured conference server. If you
choose the \fIchat\fP type the JID has to be the jabber ID of the user
to receive the message, either just the user part which will get added
the jabber server as domain part, or a full jabber ID.
.TP
.B message
The final part is the message that will get sent. At the moment it will
be put into the body as plain text. Please notice that you will have to
quote or escape special characters in the message like white space.
.SH FILES
.TP
.B /etc/nagzillac/nagzillac.cfg
The configuration file for the nagzilla client. Please see the comments
in the file for informations on what to tweak.
.SH EXAMPLE
The following sends a chat message to the rhonda user on the default
server:

.RS
nagzillac "chat^rhonda^hi there"
.RE

This will send a message to a conference room on a different server:

.RS
nagzillac "room^monitor@jabber.doma.in^alert \- do something"
.RE

.SH SEE ALSO
.BR nagzillad (1).
.br
.SH AUTHOR
nagzillac was written by Bill Mathews.
.PP
This manual page was written by Rhonda D'Vine <rhonda@debian.org>
for the Debian project (and may be used by others).