.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "FC-CACHE" "1" "Aug 13, 2008" "" ""

.SH "نام (NAME)"
fc-cache \- ساخت فایل‌های کَش اطلاعات قلم
.SH "خلاصه دستور (SYNOPSIS)"

\fBfc-cache\fR [ \fB-EfrsvVh\fR ] [ \fB--error-on-no-fonts\fR ] [ \fB--force\fR ] [ \fB--really-force\fR ] [ \fB-y \fIdir\fB\fR | \fB--sysroot \fIdir\fB\fR ] [ \fB--system-only\fR ] [ \fB--verbose\fR ] [ \fB--version\fR ] [ \fB--help\fR ] [ \fB\fIdir\fB\fR\fI ...\fR ]

.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBfc-cache\fR دایرکتوری‌های قلم را در سیستم پویش کرده و برای برنامه‌هایی که از fontconfig جهت مدیریت قلم‌های خود بهره می‌برند، فایل‌های کَش اطلاعات قلم را می‌سازد.
.PP
در صورتی که آرگومان‌های دایرکتوری مشخص نشده باشند، \fBfc-cache\fR از تک‌تک دایرکتوری‌های موجود در پیکربندی جاری قلم استفاده می‌کند. هر دایرکتوری برای یافتن فایل‌های قلمِ قابل خواندن توسط FreeType پویش می‌شود. یک کَش ایجاد می‌گردد که شامل ویژگی‌های هر قلم و نام فایل مربوط به آن است. این کَش برای افزایش سرعت راه‌اندازی برنامه‌ها در زمان استفاده از کتابخانه fontconfig به کار می‌رود.
.PP
توجه داشته باشید که \fBfc-cache\fR باید برای هر معماری یک‌بار اجرا شود تا اطلاعات قلمِ سفارشی‌شده برای همان معماری تولید گردد.
.SH "گزینه‌ها (OPTIONS)"
.PP
این برنامه از قواعد معمول خط فرمان GNU پیروی می‌کند که در آن گزینه‌های طولانی با دو خط تیره (`-') آغاز می‌شوند. خلاصه‌ای از گزینه‌ها در زیر آمده است:
.TP
\fB-E --error-on-no-fonts \fR
در صورتی که قلمی در \fB\fIdir\fB\fR یا (در صورت مشخص نشدن آن) در دایرکتوری‌های پیکربندی وجود نداشته باشد، خطا صادر می‌کند.
.TP
\fB-f --force \fR
تولید مجدد فایل‌های کَشی را که ظاهراً به‌روز هستند تحمیل کرده و بررسی برچسب زمانی (timestamp) را نادیده می‌گیرد.
.TP
\fB-r --really-force \fR
تمام فایل‌های کَش موجود را پاک کرده و دوباره پویش می‌کند.
.TP
\fB-s --system-only \fR
تنها دایرکتوری‌های سراسری سیستم را پویش کرده و مسیرهای واقع در دایرکتوری خانگی کاربر را نادیده می‌گیرد.
.TP
\fB-v --verbose \fR
اطلاعات وضعیت را در حین انجام کار نمایش می‌دهد.
.TP
\fB-y -sysroot \fIdir\fB \fR
مسیر \fB\fIdir\fB\fR را به ابتدای تمام مسیرها جهت پویش اضافه می‌کند.
.TP
\fB-h --help \fR
خلاصه‌ای از گزینه‌ها را نمایش می‌دهد.
.TP
\fB-V --version \fR
نسخه برنامه را نمایش داده و خارج می‌شود.
.TP
\fB\fIdir\fB \fR
دایرکتوری مورد نظر برای پویش قلم‌ها.
.SH "وضعیت خروج (EXIT STATUS)"
.PP
در صورتی که کَش‌ها با موفقیت ایجاد شوند، \fBfc-cache\fR مقدار صفر و در غیر این صورت مقداری غیرصفر بازمی‌گرداند.
.SH "فایل‌ها (FILES)"
.TP
\fB\fI%cachedir%/*-%arch%\&.cache-%version%\fB\fR
این فایل‌ها توسط \fBfc-cache\fR تولید شده و شامل نگاشت‌هایی از نام فایل‌ها به ویژگی‌های قلم هستند. این فایل‌ها هنگام راه‌اندازی برنامه توسط کتابخانه fontconfig برای یافتن قلم‌های مناسب خوانده می‌شوند.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBfc-cat\fR(1)
\fBfc-list\fR(1)
\fBfc-match\fR(1)
\fBfc-pattern\fR(1)
\fBfc-query\fR(1)
\fBfc-scan\fR(1)
.PP
راهنمای کاربری fontconfig در <URL:https://fontconfig.pages.freedesktop.org/fontconfig/fontconfig-user.html>
.SH "نویسندگان (AUTHORS)"
.PP
این صفحه راهنما توسط Keith Packard
<keithp@keithp.com> و Josselin Mouette <joss@debian.org>\& نوشته شده است.