<!-- MANCHA 1 -->

# NAME

mancha - view manual pages via cha(1)

# SYNOPSIS

**mancha** \[**-M** *path*\] \[*section*\] *name*\
**mancha** \[**-M** *path*\] \[*section*\] **-k** *keyword*\
**mancha** **-l** *file*

# DESCRIPTION

**mancha** enables viewing man pages using the Chawan browser.  It is
analogous to the **w3mman**(1) utility.

**mancha** executes **cha**(1) with the appropriate *man:*, *man-k:* or
*man-l:* URLs.  The protocol adapter then opens the man page and injects
markup into it, e.g. man page references are converted into *man:* links.

# OPTIONS

Command line options are:

**-M** *path*

: Set *path* as the MANPATH environment variable.  See **man**(1) for
  details of how this is interpreted.

**-k** *keyword*

: Use *keyword* for keyword-based man page search.

**-l** *file*

: Open the specified local *file* as a man page.

# ENVIRONMENT

Following environment variables are used:

**MANCHA_CHA**

: If set, the contents of the variable are used instead of *cha*.  (Note
  that the *cha* command is called through **system**(3), so you do not have
  to override it so long as *cha* is found in your **PATH**.)

**MANCHA_MAN**

: If set, the contents of the variable are used instead of */usr/bin/man*.

**MANCHA_APROPOS**

: If set, the contents of the variable are used instead of */usr/bin/man*.

  (This is not a typo; normally (except on FreeBSD), **mancha** assumes
  that **man**(1) is compatible with **apropos**(1) and accepts the *-s*
  parameter.  Overriding **MANCHA_MAN** therefore also overrides the command
  used for **man-k**, so long as **MANCHA_APROPOS** is not set.)

# SEE ALSO

**man**(1), **cha**(1), **cha-cgi**(5), **w3mman**(1)
