.TH KPSEWHICH 1 "4 January 1998" "Kpathsea @VERSION@"
.\"=====================================================================
.if n .ds MP MetaPost
.if t .ds MP MetaPost
.if n .ds MF Metafont
.if t .ds MF M\s-2ETAFONT\s0
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP\" for troff
.el .ds OX TeX\" for nroff
.\" the same but obliqued
.\" BX definition must follow TX so BX can use TX
.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
.if n .ds BX BibTeX
.\" LX definition must follow TX so LX can use TX
.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
.if n .ds LX LaTeX
.\"=====================================================================
.SH NAME
kpsewhich \- standalone path lookup and and expansion for kpathsea
.SH SYNOPSIS
.B kpsewhich
.RI [ options ]
.RI [ filenames ]
.\"=====================================================================
.SH DESCRIPTION
This manual page is not meant to be exhaustive.  The complete
documentation for this version of \*(TX can be found in the info file
or manual
.IR "Kpathsea: A library for path searching" .
.PP
.B kpsewhich
is used as a standalone front-end of the kpathsea library that can be
used to examine variables and find files.
.\"=====================================================================
.SH OPTIONS
.B kpsewhich
accepts the following options:
.TP
.BI --debug \ num
.rb
Set debugging flags.
.TP
.BI -D \ num
.rb
Use a base resolution of
.IR num ;
the default, set by the installer, is typically 600.
.TP
.BI --dpi \ num
As
.BR -D.
.TP
.BI --expand-braces \ string
.rb
Print variable and brace expansion of
.IR string .
.TP
.BI --expand-path \ string
.rb
Print complete path expansion of
.IR string .
.TP
.BI --expand-var \ string
.rb
Print variable expansion of
.BR string .
.TP
.BI --format \ name
.rb
Use file type
.IR name .
See the info manual for a list of valid names, or use the
.B --help
option to print the list.
.TP
.B --help
.rb
Print help message and exit.
.TP
.B --interactive
.rb
Ask for additional filenames to look up.
.TP
.BI --mktex \ fmt
.rb
enable
.RI mktex fmt
generation.
.RI ( fmt =pk/mf/tex/tfm)
.TP
.BI --mode \ string
.rb
Set device name for
.I $MAKETEX_MODE
to
.IR string ;
no default.
.TP
.B --must-exist
.rb
Search the disk as well as ls-R if necessary.
.TP
.BI --no-mktex \ fmt
.rb
disable
.RI mktex fmt
generation.
.RI ( fmt =pk/mf/tex/tfm)
.TP
.BI --path \ string
Search in the path
.IR string .
.TP
.BI --progname \ string
.rb
Set program name to
.IR string .
.TP
.B --separator \ string
.rb
.I string
separates components in
.B --path
output; default is
.I :
on UNIX systems.
.TP
.BI --show-path \ name
.rb
Output search path for file type
.IR name .
See the info manual for a list of valid names, or use the
.B --help
option to print the list.
.TP
.B --version
.rb
Print version information and exit.
.\"=====================================================================
.SH "SEE ALSO"
.BR mktexlsr (1),
.BR mktexmf (1),
.BR mktexpk (1),
.BR mktextfm (1).