3172
|
1 .TH KPSEWHICH 1 "4 January 1998" "Kpathsea @VERSION@" |
|
2 .\"===================================================================== |
|
3 .if n .ds MP MetaPost |
|
4 .if t .ds MP MetaPost |
|
5 .if n .ds MF Metafont |
|
6 .if t .ds MF M\s-2ETAFONT\s0 |
|
7 .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP |
|
8 .if n .ds TX TeX |
|
9 .ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP\" for troff |
|
10 .el .ds OX TeX\" for nroff |
|
11 .\" the same but obliqued |
|
12 .\" BX definition must follow TX so BX can use TX |
|
13 .if t .ds BX \fRB\s-2IB\s0\fP\*(TX |
|
14 .if n .ds BX BibTeX |
|
15 .\" LX definition must follow TX so LX can use TX |
|
16 .if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX |
|
17 .if n .ds LX LaTeX |
|
18 .\"===================================================================== |
|
19 .SH NAME |
|
20 kpsewhich \- standalone path lookup and and expansion for kpathsea |
|
21 .SH SYNOPSIS |
|
22 .B kpsewhich |
|
23 .RI [ options ] |
|
24 .RI [ filenames ] |
|
25 .\"===================================================================== |
|
26 .SH DESCRIPTION |
|
27 This manual page is not meant to be exhaustive. The complete |
|
28 documentation for this version of \*(TX can be found in the info file |
|
29 or manual |
|
30 .IR "Kpathsea: A library for path searching" . |
|
31 .PP |
|
32 .B kpsewhich |
|
33 is used as a standalone front-end of the kpathsea library that can be |
|
34 used to examine variables and find files. |
|
35 .\"===================================================================== |
|
36 .SH OPTIONS |
|
37 .B kpsewhich |
|
38 accepts the following options: |
|
39 .TP |
|
40 .BI --debug \ num |
|
41 .rb |
|
42 Set debugging flags. |
|
43 .TP |
|
44 .BI -D \ num |
|
45 .rb |
|
46 Use a base resolution of |
|
47 .IR num ; |
|
48 the default, set by the installer, is typically 600. |
|
49 .TP |
|
50 .BI --dpi \ num |
|
51 As |
|
52 .BR -D. |
|
53 .TP |
|
54 .BI --expand-braces \ string |
|
55 .rb |
|
56 Print variable and brace expansion of |
|
57 .IR string . |
|
58 .TP |
|
59 .BI --expand-path \ string |
|
60 .rb |
|
61 Print complete path expansion of |
|
62 .IR string . |
|
63 .TP |
|
64 .BI --expand-var \ string |
|
65 .rb |
|
66 Print variable expansion of |
|
67 .BR string . |
|
68 .TP |
|
69 .BI --format \ name |
|
70 .rb |
|
71 Use file type |
|
72 .IR name . |
|
73 See the info manual for a list of valid names, or use the |
|
74 .B --help |
|
75 option to print the list. |
|
76 .TP |
|
77 .B --help |
|
78 .rb |
|
79 Print help message and exit. |
|
80 .TP |
|
81 .B --interactive |
|
82 .rb |
|
83 Ask for additional filenames to look up. |
|
84 .TP |
|
85 .BI --mktex \ fmt |
|
86 .rb |
|
87 enable |
|
88 .RI mktex fmt |
|
89 generation. |
|
90 .RI ( fmt =pk/mf/tex/tfm) |
|
91 .TP |
|
92 .BI --mode \ string |
|
93 .rb |
|
94 Set device name for |
|
95 .I $MAKETEX_MODE |
|
96 to |
|
97 .IR string ; |
|
98 no default. |
|
99 .TP |
|
100 .B --must-exist |
|
101 .rb |
|
102 Search the disk as well as ls-R if necessary. |
|
103 .TP |
|
104 .BI --no-mktex \ fmt |
|
105 .rb |
|
106 disable |
|
107 .RI mktex fmt |
|
108 generation. |
|
109 .RI ( fmt =pk/mf/tex/tfm) |
|
110 .TP |
|
111 .BI --path \ string |
|
112 Search in the path |
|
113 .IR string . |
|
114 .TP |
|
115 .BI --progname \ string |
|
116 .rb |
|
117 Set program name to |
|
118 .IR string . |
|
119 .TP |
|
120 .B --separator \ string |
|
121 .rb |
|
122 .I string |
|
123 separates components in |
|
124 .B --path |
|
125 output; default is |
|
126 .I : |
|
127 on UNIX systems. |
|
128 .TP |
|
129 .BI --show-path \ name |
|
130 .rb |
|
131 Output search path for file type |
|
132 .IR name . |
|
133 See the info manual for a list of valid names, or use the |
|
134 .B --help |
|
135 option to print the list. |
|
136 .TP |
|
137 .B --version |
|
138 .rb |
|
139 Print version information and exit. |
|
140 .\"===================================================================== |
|
141 .SH "SEE ALSO" |
|
142 .BR mktexlsr (1), |
|
143 .BR mktexmf (1), |
|
144 .BR mktexpk (1), |
|
145 .BR mktextfm (1). |