.\" -*- coding: utf-8 -*-
.TH XLSFONTS 1 2022-09-10 "xlsfonts 1.0.9" "X Version 11"
.SH "نام (NAME)"
xlsfonts \- فهرست کردن فونت‌های موجود در کارساز X
.SH "خلاصه دستور (SYNOPSIS)"
.ad l
.nf
\fBxlsfonts\fR [\fB\-display\fR \fIhost:dpy\fR] [\fB\-l\fR] [\fB\-ll\fR] [\fB\-lll\fR] [\fB\-m\fR] [\fB\-C\fR] [\fB\-1\fR]
    [\fB\-w\fR \fIwidth\fR] [\fB\-n\fR \fIcolumns\fR] [\fB\-u\fR] [\fB\-o\fR] [\fB\-fn\fR \fIpattern\fR] [\fB\-v\fR]
.fi
.SH "توضیحات (DESCRIPTION)"
دستور
.B xlsfonts
فونت‌های موجود روی یک کارساز X را که با الگوی ارائه‌شده مطابقت دارند، فهرست می‌کند.
از نویسهٔ عام «*» می‌توان برای تطبیق با هر دنباله‌ای از نویسه‌ها (شامل حالت تهی) و از «?» برای تطبیق با هر تک‌نویسه استفاده کرد.
اگر الگویی مشخص نشود، «*» در نظر گرفته می‌شود.
.PP
نویسه‌های «*» و «?» باید نقل‌قول (کوتیشن) شوند تا از گسترش آن‌ها توسط پوسته جلوگیری شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-display \fIhost:dpy\fB\fR
این گزینه کارساز X مورد نظر را برای ارتباط مشخص می‌کند.
.TP
\fB\-d \fIhost:dpy\fB\fR
مشابه \fB\-display \fIhost:dpy\fB\fR است.
.TP
\fB\-l\fR
علاوه بر نام فونت، برخی از ویژگی‌های آن را نیز در یک سطر فهرست می‌کند.
.TP
\fB\-ll\fR
علاوه بر خروجی \fB\-l\fR، ویژگی‌های پیشرفتهٔ فونت (properties) را نیز فهرست می‌کند.
.TP
\fB\-lll\fR
علاوه بر خروجی \fB\-ll\fR، مشخصات ابعادی نویسه‌ها (metrics) را نیز فهرست می‌کند.
.TP
\fB\-m\fR
این گزینه مشخص می‌کند که فهرست‌بندی‌های طولانی باید حد کمینه و بیشینهٔ هر فونت را نیز چاپ کنند.
.TP
\fB\-C\fR
این گزینه مشخص می‌کند که فهرست‌بندی باید در چندین ستون انجام شود.
این گزینه همانند \fB\-n 0\fR است.
.TP
\fB\-1\fR
این گزینه مشخص می‌کند که فهرست‌بندی باید تک‌ستونی باشد.
این گزینه همانند \fB\-n 1\fR است.
.TP
\fB\-w \fIwidth\fR
این گزینه عرض را بر حسب نویسه برای تعیین تعداد ستون‌های خروجی مشخص می‌کند.
مقدار پیش‌فرض 79 است.
.TP
\fB\-n \fIcolumns\fR
این گزینه تعداد ستون‌ها را برای نمایش خروجی مشخص می‌کند.
به‌طور پیش‌فرض، تلاش می‌شود تا جای ممکن ستون‌های نام فونت بیشتری در عرض مشخص‌شده توسط \fB\-w\fR \fIwidth\fR جای داده شوند.
.TP
\fB\-u\fR
این گزینه مشخص می‌کند که خروجی باید بدون مرتب‌سازی باقی بماند.
.TP
\fB\-o\fR
این گزینه مشخص می‌کند که \fBxlsfonts\fR به‌جای \fBListFonts\fR، از فراخوانی \fBOpenFont\fR (و در صورت نیاز \fBQueryFont\fR) استفاده کند.
این قابلیت زمانی مفید است که \fBListFonts\fR یا \fBListFontsWithInfo\fR در فهرست کردن یک فونت شناخته‌شده شکست بخورند (مانند برخی سامانه‌های فونت مقیاس‌پذیر).
.TP
\fB\-fn \fIpattern\fR
این گزینه الگوی نام فونت را برای تطبیق مشخص می‌کند.
.TP
.B -v
این گزینه نسخهٔ برنامه را چاپ کرده و خارج می‌شود.
.SH "محیط (ENVIRONMENT)"
.TP
.B DISPLAY
میزبان و نمایشگر پیش‌فرض برای استفاده در حالتی که هیچ‌یک از گزینه‌های \fB\-d\fR یا \fB\-display\fR تعیین نشده باشند.
.SH "گزارش باگ‌ها (BUGS)"
اجرای «xlsfonts -l» می‌تواند کارساز X شما را برای مدتی بسیار طولانی مسدود کند.
این در واقع یک نقص در کارسازهای تک‌رشته‌ای غیرقابل‌قبضه‌کردن (non-preemptable) است، نه در این برنامه.
.SH "همچنین ببینید (SEE ALSO)"
.BR X (7),
.BR Xserver (1),
.BR xset (1),
.BR xfd (1),
.BR xfontsel (1),
.I X Logical Font Description Conventions
.SH "نویسندگان (AUTHORS)"
Mark Lillibridge
.PP
Jim Fulton
.PP
Phil Karlton
.PP
Roland Mainz