.\" Automatically generated by Pandoc 3.7.0.1
.\"
.TH "MANCHA" "1"
.SH NAME
mancha \- view manual pages via cha(1)
.SH SYNOPSIS
\f[B]mancha\f[R] [\f[B]\-M\f[R] \f[I]path\f[R]] [\f[I]section\f[R]]
\f[I]name\f[R]
.PD 0
.P
.PD
\f[B]mancha\f[R] [\f[B]\-M\f[R] \f[I]path\f[R]] [\f[I]section\f[R]]
\f[B]\-k\f[R] \f[I]keyword\f[R]
.PD 0
.P
.PD
\f[B]mancha\f[R] \f[B]\-l\f[R] \f[I]file\f[R]
.SH DESCRIPTION
\f[B]mancha\f[R] enables viewing man pages using the Chawan browser.
It is analogous to the \f[B]w3mman\f[R](1) utility.
.PP
\f[B]mancha\f[R] will call \f[B]cha\f[R](1) with the appropriate
\f[I]man:\f[R], \f[I]man\-k:\f[R] or \f[I]man\-l:\f[R] URLs.
The protocol adapter then opens the man page and injects markup into it,
e.g.\ man page references are converted into \f[I]man:\f[R] links.
.SH OPTIONS
Command line options are:
.TP
\f[B]\-M\f[R] \f[I]path\f[R]
Set \f[I]path\f[R] as the MANPATH environment variable.
See \f[B]man\f[R](1) for details of how this is interpreted.
.TP
\f[B]\-k\f[R] \f[I]keyword\f[R]
Use \f[I]keyword\f[R] for keyword\-based man page search.
.TP
\f[B]\-l\f[R] \f[I]file\f[R]
Open the specified local \f[I]file\f[R] as a man page.
.SH ENVIRONMENT
Following environment variables are used:
.TP
\f[B]MANCHA_CHA\f[R]
If set, the contents of the variable are used instead of \f[I]cha\f[R].
(Note that the \f[I]cha\f[R] command is called through
\f[B]system\f[R](3), so you do not have to override it so long as
\f[I]cha\f[R] is found in your \f[B]PATH\f[R].)
.TP
\f[B]MANCHA_MAN\f[R]
If set, the contents of the variable are used instead of
\f[I]/usr/bin/man\f[R].
.TP
\f[B]MANCHA_APROPOS\f[R]
If set, the contents of the variable are used instead of
\f[I]/usr/bin/man\f[R].
.PP
(This is not a typo; normally (except on FreeBSD), \f[B]mancha\f[R]
assumes that \f[B]man\f[R](1) is compatible with \f[B]apropos\f[R](1)
and accepts the \f[I]\-s\f[R] parameter.
Overriding \f[B]MANCHA_MAN\f[R] therefore also overrides the command
used for \f[B]man\-k\f[R], so long as \f[B]MANCHA_APROPOS\f[R] is not
set.)
.SH SEE ALSO
\f[B]man\f[R](1), \f[B]cha\f[R](1), \f[B]cha\-localcgi\f[R](5),
\f[B]w3mman\f[R](1)