FC-CACHE(1)                                                        FC-CACHE(1)



نام (NAME)
       fc-cache - ساخت فایل‌های کَش اطلاعات قلم

خلاصه دستور (SYNOPSIS)
       fc-cache [ -EfrsvVh ] [ --error-on-no-fonts ] [ --force ] [ --really-
       force ] [ -y dir | --sysroot dir ] [ --system-only ] [ --verbose ] [
       --version ] [ --help ] [ dir ... ]


توضیحات (DESCRIPTION)
       دستور fc-cache دایرکتوری‌های قلم را در سیستم پویش کرده و برای برنامه‌هایی
       که از fontconfig جهت مدیریت قلم‌های خود بهره می‌برند، فایل‌های کَش اطلاعات
       قلم را می‌سازد.

       در صورتی که آرگومان‌های دایرکتوری مشخص نشده باشند، fc-cache از تک‌تک
       دایرکتوری‌های موجود در پیکربندی جاری قلم استفاده می‌کند. هر دایرکتوری
       برای یافتن فایل‌های قلمِ قابل خواندن توسط FreeType پویش می‌شود. یک کَش
       ایجاد می‌گردد که شامل ویژگی‌های هر قلم و نام فایل مربوط به آن است. این کَش
       برای افزایش سرعت راه‌اندازی برنامه‌ها در زمان استفاده از کتابخانه
       fontconfig به کار می‌رود.

       توجه داشته باشید که fc-cache باید برای هر معماری یک‌بار اجرا شود تا
       اطلاعات قلمِ سفارشی‌شده برای همان معماری تولید گردد.

گزینه‌ها (OPTIONS)
       این برنامه از قواعد معمول خط فرمان GNU پیروی می‌کند که در آن گزینه‌های
       طولانی با دو خط تیره (`-') آغاز می‌شوند. خلاصه‌ای از گزینه‌ها در زیر آمده
       است:

       -E --error-on-no-fonts
              در صورتی که قلمی در dir یا (در صورت مشخص نشدن آن) در
              دایرکتوری‌های پیکربندی وجود نداشته باشد، خطا صادر می‌کند.

       -f --force
              تولید مجدد فایل‌های کَشی را که ظاهراً به‌روز هستند تحمیل کرده و
              بررسی برچسب زمانی (timestamp) را نادیده می‌گیرد.

       -r --really-force
              تمام فایل‌های کَش موجود را پاک کرده و دوباره پویش می‌کند.

       -s --system-only
              تنها دایرکتوری‌های سراسری سیستم را پویش کرده و مسیرهای واقع در
              دایرکتوری خانگی کاربر را نادیده می‌گیرد.

       -v --verbose
              اطلاعات وضعیت را در حین انجام کار نمایش می‌دهد.

       -y -sysroot dir
              مسیر dir را به ابتدای تمام مسیرها جهت پویش اضافه می‌کند.

       -h --help
              خلاصه‌ای از گزینه‌ها را نمایش می‌دهد.

       -V --version
              نسخه برنامه را نمایش داده و خارج می‌شود.

       dir    دایرکتوری مورد نظر برای پویش قلم‌ها.

وضعیت خروج (EXIT STATUS)
       در صورتی که کَش‌ها با موفقیت ایجاد شوند، fc-cache مقدار صفر و در غیر این
       صورت مقداری غیرصفر بازمی‌گرداند.

فایل‌ها (FILES)
       %cachedir%/*-%arch%.cache-%version%
              این فایل‌ها توسط fc-cache تولید شده و شامل نگاشت‌هایی از نام
              فایل‌ها به ویژگی‌های قلم هستند. این فایل‌ها هنگام راه‌اندازی برنامه
              توسط کتابخانه fontconfig برای یافتن قلم‌های مناسب خوانده می‌شوند.

همچنین ببینید (SEE ALSO)
       fc-cat(1) fc-list(1) fc-match(1) fc-pattern(1) fc-query(1) fc-scan(1)

       راهنمای کاربری fontconfig در
       <URL:https://fontconfig.pages.freedesktop.org/fontconfig/fontconfig-
       user.html>

نویسندگان (AUTHORS)
       این صفحه راهنما توسط Keith Packard <keithp@keithp.com> و Josselin
       Mouette <joss@debian.org> نوشته شده است.

                                August 13, 2008                    FC-CACHE(1)