1 .\"
   2 .\" This file and its contents are supplied under the terms of the
   3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4 .\" You may only use this file in accordance with the terms of version
   5 .\" 1.0 of the CDDL.
   6 .\"
   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\"
  12 .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
  13 .\"
  14 .Dd Jul 16, 2014
  15 .Dt CATAMN 1M
  16 .Os
  17 .Sh NAME
  18 .Nm catman
  19 .Nd generate
  20 .Nm whatis
  21 database files
  22 .Sh SYNOPSIS
  23 .Nm
  24 .Op Fl M Ar path
  25 .Sh DESCRIPTION
  26 The
  27 .Nm
  28 utility generates a set of
  29 .Nm whatis
  30 database files suitable for use with
  31 .Xr apropos 1
  32 and
  33 .Xr whatis 1 .
  34 It is supplied for compatibility reasons.  The same databases can
  35 be generated using the
  36 .Fl w
  37 option with
  38 .Xr man 1 ,
  39 and that command should be used instead.
  40 .Bl -tag -width ".Fl d"
  41 .It Fl M Ar path
  42 Generate the
  43 .Nm whatis
  44 database files within the specified colon separated manual paths.
  45 Overrides the
  46 .Ev MANPATH
  47 environment variable.
  48 .El
  49 .Sh ENVIRONMENT
  50 The following environment variables affect the execution of
  51 .Nm :
  52 .Bl -tag -width ".Ev MANPATH"
  53 .It Ev MANPATH
  54 Used to specify a colon seperated list of manual paths within
  55 which to generate
  56 .Nm whatis
  57 database files.
  58 .El
  59 .Sh DIAGNOSTICS
  60 The
  61 .Nm
  62 utility exits 0 on success, and non-zero otherwise.
  63 .Sh INTERFACE STABILITY
  64 .Nm "Obsolete Committed" .
  65 .Sh CODE SET INDEPENDENCE
  66 Enabled.
  67 .Sh SEE ALSO
  68 .Xr apropos 1 ,
  69 .Xr man 1 ,
  70 .Xr whatis 1