TH KPSEWHICH 1 "1 March 2011" "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. When the
B -format
option is not given, the search path used when looking for a file is
inferred from the name given, by looking for a known extension. If
no known extension is found, the search path for \*(TX source files is
used.
\"=====================================================================
SH OPTIONS
B kpsewhich
accepts the following options:
TP
BI -debug \ num
Set debugging flags.
TP
BI -D \ num
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 -engine \ string
Set
I $engine
in the environment, which is used in some search paths.
TP
BI -expand-braces \ string
Print variable and brace expansion of
IR string .
TP
BI -expand-path \ string
Print complete path expansion of
IR string .
TP
BI -expand-var \ string
Print variable expansion of
IR string .
TP
BI -format \ name
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
Print help message and exit.
TP
B -interactive
Ask for additional filenames to look up.
TP
BI -mktex \ fmt
enable
RI mktex fmt
generation.
RI ( fmt =pk/mf/tex/tfm)
TP
BI -mode \ string
Set device name for
I $MAKETEX_MODE
to
IR string ;
no default.
TP
B -must-exist
Search the disk as well as ls-R if necessary.
TP
BI -no-mktex \ fmt
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
Set program name to
IR string .
\" .TP
\" .BI -separator \ string
\" .rb
\" .I string
\" separates components in
\" .B -path
\" output; default is
\" .I :
\" on UNIX systems.
TP
BI -show-path \ name
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
BI -var-value \ variable
Print the expansion of
IR variable .
TP
B -version
Print version information and exit.
\"=====================================================================
SH "SEE ALSO"
BR mktexlsr (1),
BR mktexmf (1),
BR mktexpk (1),
BR mktextfm (1).
