.\" Copyright (c) 2022 Stijn van Dongen
.TH "mcx" 1 "9 Oct 2022" "mcx 22-282" "USER COMMANDS "
.po 2m
.de ZI
.\" Zoem Indent/Itemize macro I.
.br
'in +\\$1
.nr xa 0
.nr xa -\\$1
.nr xb \\$1
.nr xb -\\w'\\$2'
\h'|\\n(xau'\\$2\h'\\n(xbu'\\
..
.de ZJ
.br
.\" Zoem Indent/Itemize macro II.
'in +\\$1
'in +\\$2
.nr xa 0
.nr xa -\\$2
.nr xa -\\w'\\$3'
.nr xb \\$2
\h'|\\n(xau'\\$3\h'\\n(xbu'\\
..
.if n .ll -2m
.am SH
.ie n .in 4m
.el .in 8m
..
.SH NAME
mcx \- perform various computations on graphs and matrices
.SH SYNOPSIS

.di ZV
.in 0
.nf \fC
   \fBmcx\fP <mode> [mode-options] [mode-files]
.fi \fR
.in
.di
.ne \n(dnu
.nf \fC
.ZV
.fi \fR

.SH DESCRIPTION

\fBmcx\fP implements a variety of computations on graphs and matrices\&. The
first argument to \fBmcx\fP should be a \fImode\fP, which is a string establishing
the type of computation to invoke\&. Each mode \fImode\fP is described in the
mcx\fImode\fP manual page\&. The currently available modes are
\fBconvert\fP, \fBdiameter\fP, \fBclcf\fP, \fBq\fP and \fBctty\fP\&.
The \fBconvert\fP mode is thus described in the
\fBmcxconvert\fP manual page\&.

Invoking \fBmcx\fP without arguments causes it to print out a list
of available modes with a short description of the type of
command line expected by that mode\&.

Invoking \fBmcx\fP with just a mode will print out a longer listing
of options available for that particular mode\&.
Modes that are able to function normally without arguments
can be invoked by adding the \fI--nop\fP argument\&.

Several options are shared between all \fBmcx\fP modes\&. Note that
these options are specified after the \fBmode\fP\&. See \fBOPTIONS\fP\&.

The \fB--version\fP causes \fBmcx\fP to print out version
and license information\&.

Issuing \fImcx help mode\fP will cause \fBmcx\fP to look for a manual page
describing \fImode\fP and display it if found\&. This requires that the
MANPATH environment variable contains the directory in which the MCL-edge
manual pages were installed\&. This will usually be \fCPREFIX/share\fP,
where \fCPREFIX\fP is the path with which the software was configured\&.
.SH OPTIONS

These are options that pertain to all modes\&. They should be specified
\fIafter\fP the mode argument\&.

.ZI 2m "\fB-h\fP (\fIsynopsis\fP)"
\&
'in -2m
.ZI 2m "\fB--help\fP (\fIsynopsis\fP)"
\&
'in -2m
'in +2m
\&
.br
List available options\&.
.in -2m

.ZI 2m "\fB--nop\fP (\fIno-op\fP)"
\&
.br
Not an option\&. This option has no effect then to increment
the argument count\&. This can be useful for \fBmcx\fP modes which are able to
function without any options\&. Such a mode typically reads from STDIN, writes
to STDOUT, and uses default settings\&. However, simply specifying a mode
without options leads \fBmcx\fP to output a list of available options for that
mode\&. This can be prevented by using the \fB--nop\fP option\&.
.in -2m

.ZI 2m "\fB-set\fP (\fIkey=val\fP)"
\&
.br
Sets the key\ \&\fBkey\fP to value\ \&\fBval\fP in the environment\&.
Some modes allow adjustment of settings in this manner\&.
.in -2m

.ZI 2m "\fB-progress\fP <num> (\fIprogress interval size\fP)"
\&
.br
Defines the interval that defines the progress frequency\&.
.in -2m

.ZI 2m "\fB--debug\fP (\fIturn on debugging\fP)"
\&
.br
Turn debugging on\&.
.in -2m

.ZI 2m "\fB--version\fP (\fIshow version\fP)"
\&
.br
Show version\&.
.in -2m
.SH AUTHOR

Stijn van Dongen\&.
.SH SEE ALSO

\fBmclfamily(7)\fP for an overview of all the documentation
and the utilities in the mcl family\&.