.TH KPSEWHICH 1 "1 March 2011" "Kpathsea 6.4.2"
.\"=====================================================================
.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 \- جستجو و بسط مستقل مسیر برای kpathsea
.SH "خلاصه دستور (SYNOPSIS)"
.B kpsewhich
.RI [ options ]
.RI [ filenames ]
.\"=====================================================================
.SH "توضیحات (DESCRIPTION)"
این صفحهٔ راهنما جامع نیست. مستندات کامل این نسخه از \*(TX را می‌توان در فایل info یا راهنمای
.IR "Kpathsea: A library for path searching"
یافت.
.PP
دستور
.B kpsewhich
به‌عنوان یک پیشانهٔ مستقل برای کتابخانهٔ kpathsea استفاده می‌شود که می‌توان از آن برای بررسی متغیرها و یافتن فایل‌ها بهره برد. هنگامی که گزینهٔ
.B -format
داده نشده باشد، مسیر جستجوی مورد استفاده برای یافتن یک فایل، با بررسی پسوندهای شناخته‌شده از روی نام داده‌شده استنتاج می‌شود. اگر هیچ پسوند شناخته‌شده‌ای پیدا نشود، مسیر جستجو برای فایل‌های منبع \*(TX به کار می‌رود.
.\"=====================================================================
.SH "گزینه‌ها (OPTIONS)"
دستور
.B kpsewhich
گزینه‌های زیر را می‌پذیرد:
.TP
.BI -debug \ num
پرچم‌های اشکال‌زدایی را تنظیم می‌کند.
.TP
.BI -D \ num
از تفکیک‌پذیری پایهٔ
.IR num
استفاده می‌کند؛ مقدار پیش‌فرض که توسط نصاب تنظیم می‌شود معمولاً 600 است.
.TP
.BI -dpi \ num
مشابه
.BR -D .
.TP
.BI -engine \ string
مقدار
.I $engine
را در محیط تنظیم می‌کند که در برخی از مسیرهای جستجو به کار می‌رود.
.TP
.BI -expand-braces \ string
بسط متغیر و آکولاد
.IR string
را چاپ می‌کند.
.TP
.BI -expand-path \ string
بسط کامل مسیر
.IR string
را چاپ می‌کند.
.TP
.BI -expand-var \ string
بسط متغیر
.IR string
را چاپ می‌کند.
.TP
.BI -format \ name
از نوع فایل
.IR name
استفاده می‌کند. برای فهرستی از نام‌های معتبر به راهنمای info مراجعه کنید، یا از گزینهٔ
.B -help
برای چاپ این فهرست استفاده کنید.
.TP
.B -help
پیام راهنما را چاپ می‌کند و خارج می‌شود.
.TP
.B -interactive
نام‌های فایل بیشتری را برای جستجو درخواست می‌کند.
.TP
.BI -mktex \ fmt
تولید
.RI mktex fmt
را فعال می‌کند.
.RI ( fmt =pk/mf/tex/tfm)
.TP
.BI -mode \ string
نام دستگاه را برای
.I $MAKETEX_MODE
روی
.IR string
تنظیم می‌کند؛ بدون مقدار پیش‌فرض.
.TP
.B -must-exist
در صورت نیاز، علاوه بر ls-R دیسک را نیز جستجو می‌کند.
.TP
.BI -no-mktex \ fmt
تولید
.RI mktex fmt
را غیرفعال می‌کند.
.RI ( fmt =pk/mf/tex/tfm)
.TP
.BI -path \ string
در مسیر
.IR string
جستجو می‌کند.
.TP
.BI -progname \ string
نام برنامه را روی
.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
مسیر جستجو را برای نوع فایل
.IR name
در خروجی نمایش می‌دهد. برای فهرستی از نام‌های معتبر به راهنمای info مراجعه کنید، یا از گزینهٔ
.B -help
برای چاپ این فهرست استفاده کنید.
.TP
.BI -var-value \ variable
بسط
.IR variable
را چاپ می‌کند.
.TP
.B -version
اطلاعات نسخه را چاپ می‌کند و خارج می‌شود.
.\"=====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.BR mktexlsr (1),
.BR mktexmf (1),
.BR mktexpk (1),
.BR mktextfm (1).