.TH COLRCONV 1
.SH NAME
colrconv \- hamradio convers client with sound and ncurses color support
.SH SYNOPSIS
.B colrconv
.I "[options]"
.I "<host>"
.I "[<service>]"
.SH DESCRIPTION
This manual page documents briefly the
.BR colrconv
commands.

This manual page was written for the Debian GNU/Linux distribution
because the original program does not have a manual page.
.PP

.B Colrconv 
is a modified version of VA3DP's ttylink client. In addition to the
basic split screen session it gives you color and sound support 
plus some line editing capabilities, a scroll buffer and a status line.
Also the default service is changed to 3600 (convers). 

A new color is assigned to each user the first time he sends text 
and this color is used when displaying any subsequent text from this 
user. Available colors are green, yellow, cyan, magenta, blue and red.
These are used twice, the second time with BOLD attribute on. After 
the colors run out they are used again.

Bold red is reserved for special messages (starting with ***) and
for private messages (eg. <*oh2bns*>: Hello!).

.B Colrconv 
plays certain sound files when it receives text from the convers bridge.
The files are: callsign.au (eg. oh2bns.au), unknown.au, signedon.au
says.au and pingpong.au. This feature is still a bit experimental
and only works with older convers servers. Also you have to make
your own .au file. The rsynth package is good at this. See the readme
for details. Sound files should go into /usr/lib/colrconv.


.SH OPTIONS
.TP
.B \-nocolor
Start colrconv in black and white, even if terminal has color support.
.TP
.B \-c channel
Connect to channel number 'channel' at startup.
.TP
.B \-n name
Send a '/n name' when connected. When -n is omitted the user's login
name is used.


.SH LINE EDITING COMMANDS

.TP
.B Ctrl-A 
Goto beginning of line.
.TP
.B Ctrl-B and Left arrow
Go one character backward.
.TP
.B Ctrl-D
Delete character under cursor.
.TP
.B Ctrl-E
Goto end of line.
.TP
.B Ctrl-F and Right arrow 
Go one character forward.
.TP
.B Ctrl-K
Kill from cursor to end of line (and store to kill buffer).
.TP
.B Ctrl-L
Repaints the whole screen.
.TP
.B Ctrl-N and Down arrow
Scroll Down.
.TP
.B Ctrl-P and Up arrow
Scroll Up.
.TP
.B Ctrl-R 
Reprint current line.
.TP
.B Ctrl-U 
Delete current line in total.
.TP
.B Ctrl-W 
Erase last word.
.TP
.B Ctrl-Y
Yank kill buffer.

.PP
The scroll buffer can be browsed with arrow keys Up and Down (or Ctrl-P 
and Ctrl-N), PageUp, PageDown, Home and End keys.

.SH FILES
If 
.B ~/.conversrc 
exists, it is sent to the server after logging in.  Handy for automatically 
sending commands like /notify, /who, etc.

.SH SEE ALSO
/usr/share/doc/colrconv/README.colrconv.

.SH AUTHOR
This manual page was written by Joop Stakenborg <pa3aba@debian.org>,
for the Debian GNU/Linux system (but may be used by others).