.TH coolman 1 "4 April 2005"
.\"SKIP_SECTION"
.SH NAME
coolman-3.17.17 \- Man page reader for the X Window System based
on the Coolwidget library.
.\"SKIP_SECTION"
.SH USAGE
.B coolman 
[options] [-c <man-command>] [<man-page>]
.SH DESCRIPTION
.LP
This man page reader just views the output of the man system command,
with a nice point and click, drag and drop, GUI.
.\".\"DONT_SPLIT"
.SH OPTIONS
.TP
.I "-d, -display <display>"
The X server and display you would like to display to.
.TP
.I "-f, -fn, -font <font-name>"
The font you would like to use.
.TP
.I "-dnd-old"
Use dnd version 0 instead of version 1. Many apps that support Dnd may
only support the older version. Use this option to force compatability.
.TP
.I "-c, -cmd, --command <man-command>"
This specifies the shell command to use to run man. The 
.B %m 
is replaced with
the name of the man page. The default is 
.BR "man -a %m", 
where 
.B -a 
specifies 
.I all 
man pages: the 
.B -a 
option may not be supported on some systems. Note that you can use 
.B coolman 'cat %m' <file-name> 
to use coolman to just view a regular file.
.TP
.I -h, -H, -?, --help
Print out commandline options summary.
.TP
.I -V, -v, --version
Print out version number.
.PP
.SH USAGE
.PP
If 
.B Coolman 
is envoked without arguments, it requests a man page on startup. Typical usage 
of 
.B Coolman 
would be to open one man page and then double click on key words or words in 
the 
.B SEE ALSO 
sections of man pages. This will cause 
.B Coolman 
to run 
.B man 
with the word that was double-clicked on. This will create a list of opened
man pages, which can be browsed with the 
.B Previous 
and 
.B Next 
buttons. You can search through the text 
by pressing 
.B F7 
and entering your search string - searching begins from the second line in the 
window, and is transparent to nroff formatting. To insert selected text from 
other applications into an input line, use 
.BR "Shift-Insert". 
You can also 
.I drag 
text from the man page by 
.IR "first highlighting the text with the mouse, and then dragging from within the highlighted text". 
Note that 
.I Drag and drop 
may not work if your Dnd version is incompatible. Envoke 
.B Coolman 
with 
.B -dnd-old 
to force compatability.
.PP
Finally, 
.B function key 
usage is analogous to 
.BR "Cooledit",
eg  
.B F10 
exits.
.PP
.SH COLORS
You can change the colors of 
.B coolman 
from 
.BR "cooledit"'s 
configuration file: 
.IR "~/cedit/.cooledit.ini". 
The lines of interest would look like this by default:
.PP
.nf
[Options]
option_text_fg_normal = 0
option_text_fg_bold = 17
option_text_fg_italic = 16
option_text_bg_normal = 22
option_text_bg_marked = 25
option_text_bg_highlighted = 12
.fi
.PP
.B Cooledit 
creates this file when it exits, but you can create a file that looks 
just like this if you don't have 
.BR "cooledit". 
The numbers represent a 3x3x3 RGB matrix, eg. black is 0, white is 26 
and, say, red is 18.
.PP
.SH LICENSE
This program is distributed under the terms of the GNU General Public
License as published by the Free Software Foundation. See the file
COPYING in the source distribution for details on the License and the
lack of warranty. Alternatively see the 'About' menu of the 
.B Cooledit 
program.
.PP
.SH AVAILABILITY
The latest public release of this program can be found at sunsite.unc.edu
in the directory /pub/Linux/Incoming, or /pub/Linux/apps/editors/X. The
latest development version can be found at 
.B lava.obsidian.co.za 
, in the directory 
.B /pub/unix/cooledit 
, all by anonymous ftp. 
.B Coolman 
is packed with the 
.B Cooledit 
distribution.
.SH SEE ALSO
scanf(3), cooledit(1), man(1), smalledit(1).
.PP
.SH AUTHORS
Paul Sheer (psheer /AT/ icon.co.za)