.\"
.TH XKBCOMP 1 2025-03-31 "xkbcomp 1.5.0" "X Version 11"
.SH "نام (NAME)"
xkbcomp \- کامپایل توصیف صفحه‌کلید XKB
.SH "خلاصه دستور (SYNOPSIS)"
.B xkbcomp
.RI [ option "] " source " [" destination ]
.SH "توضیحات (DESCRIPTION)"
کامپایلر نگاشت کلید
.B xkbcomp
توصیف یک نگاشت کلید XKB را به یکی از چندین قالب خروجی تبدیل می‌کند.
رایج‌ترین کاربرد xkbcomp ایجاد یک فایل کامپایل‌شدهٔ نگاشت کلید
(با پسوند \fI.xkm\fP) است که می‌تواند مستقیماً توسط کارسازهای X یا ابزارهای مجهز به قابلیت XKB خوانده شود.
این کامپایلر همچنین می‌تواند فایل‌های هدر C یا فایل‌های منبع XKB را تولید کند.
فایل‌های هدر C تولیدشده توسط xkbcomp می‌توانند در کارسازهای X یا ابزارهایی که به نگاشت کلید پیش‌فرض داخلی نیاز دارند،
گنجانده (include) شوند.
فایل‌های منبع XKB تولیدشده توسط \fBxkbcomp\fP کاملاً تفکیک‌شده هستند و می‌توان از آن‌ها
برای اطمینان از ادغام صحیح فایل‌هایی که معمولاً یک نگاشت کلید XKB را تشکیل می‌دهند
یا برای ایجاد یک فایل واحد حاوی توصیف کامل نگاشت کلید استفاده کرد.
.PP
آرگومان \fIsource\fP ممکن است یک نمایشگر X (نمایشگر X display) یا یک فایل \fI.xkb\fP یا \fI.xkm\fP را مشخص کند؛
مگر اینکه صراحتاً تعیین شده باشد، قالب \fIdestination\fP به قالب منبع بستگی دارد.
کامپایل یک فایل \fI.xkb\fP (منبع نگاشت کلید) به‌طور پیش‌فرض یک فایل \fI.xkm\fP (فایل نگاشت کلید کامپایل‌شده) تولید می‌کند.
اگر منبع یک فایل \fI.xkm\fP یا یک نمایشگر X باشد،
\fBxkbcomp\fP به‌طور پیش‌فرض یک فایل منبع نگاشت کلید ایجاد می‌کند.
.PP
اگر \fIdestination\fP یک نمایشگر X باشد، نگاشت کلید آن نمایشگر
با نگاشت کلید کامپایل‌شده به‌روزرسانی می‌شود.
.PP
نام \fIdestination\fP معمولاً از روی نام منبع و با جایگزینی مناسب پسوند آن محاسبه می‌شود.
هنگام کامپایل یک نگاشت واحد از فایلی که شامل چندین نگاشت است،
\fBxkbcomp\fP نام فایل مقصد را با افزودن پسوند مناسب به نام نگاشت مورد استفاده می‌سازد.
.SH "گزینه‌ها (OPTIONS)"
.TP 8
.B \-a
نمایش تمام اطلاعات صفحه‌کلید، و گزارش اطلاعات ضمنی یا مشتق‌شده به‌صورت کامنت (توضیح).
فقط بر خروجی قالب \fI.xkb\fP تأثیر می‌گذارد.
.TP 8
.B \-C
تولید یک فایل هدر C به عنوان خروجی (با پسوند .h).
.TP 8
.B \-dflts
محاسبه مقادیر پیش‌فرض برای هر مؤلفهٔ ناموجود، مانند نام کلیدها.
.TP 8
.B \-em1 \fImsg\fP
چاپ \fImsg\fP قبل از نمایش اولین پیام خطا.
.TP 8
.B \-emp \fImsg\fP
چاپ \fImsg\fP در ابتدای هر خط از پیام‌ها.
.TP 8
.B \-eml \fImsg\fP
در صورت بروز هرگونه خطا، چاپ \fImsg\fP پیش از خروج.
.TP 8
.B \-help, -?
نمایش گزینه‌های موجود.
.TP 8
.B \-I\fIdir\fP
مشخص کردن دایرکتوری‌های سطح بالا برای جستجوی فایل‌های فراخوانی‌شده توسط توصیف نگاشت کلید.
پس از جستجوی تمام دایرکتوری‌های مشخص‌شده توسط گزینه‌های \fB\-I\fP، دایرکتوری جاری و در نهایت،
دایرکتوری پیش‌فرض xkb یعنی /usr/share/X11/xkb جستجو خواهند شد.
.sp
برای جلوگیری از جستجوی دایرکتوری جاری و دایرکتوری پیش‌فرض،
گزینهٔ \fB\-I\fP را به تنهایی (یعنی بدون دایرکتوری)
قبل از هر گزینهٔ \fB\-I\fP دیگری که دایرکتوری‌های مورد نظر شما را مشخص می‌کند، به کار ببرید.
.TP 8
.B \-i\ \fIdeviceid\fP
اگر \fIsource\fP یا \fIdestination\fP یک نمایشگر معتبر X باشد،
نگاشت کلید را از/به دستگاهی با شناسهٔ مشخص‌شده (نه نام آن) بارگذاری می‌کند.
.TP 8
.B \-l
فهرست کردن نگاشت‌هایی که الگوی \fImap\fP را در هر یک از فایل‌های ذکرشده در خط فرمان مشخص کرده‌اند (هنوز پیاده‌سازی نشده است).
.TP 8
.B \-m\ \fIname\fP
مشخص کردن نگاشتی که باید از فایلی با چندین مدخل کامپایل شود.
.TP 8
.B \-merge
ادغام اطلاعات کامپایل‌شده با نگاشت موجود در کارساز (هنوز پیاده‌سازی نشده است).
.TP 8
.B \-o\ \fIname\fP
تعیین نامی برای فایل خروجی تولیدشده.
پیش‌فرض، نام فایل منبع با پسوند مناسب برای قالب خروجی است.
.TP 8
.B \-opt\ \fIparts\fP
تعیین فهرستی از بخش‌های اختیاری.
خطاهای کامپایل در هر یک از بخش‌های اختیاری کشنده نیستند.
بخش‌ها می‌توانند از هر ترکیبی از حروف
.IR c "، " g "، " k "، " s " و " t
تشکیل شوند که به‌ترتیب نگاشت سازگاری (compatibility map)، هندسه (geometry)،
کدهای کلید (keycodes)، نمادها (symbols) و انواع (types) را مشخص می‌کنند.
.TP 8
.B -R\fIdir\fP
مشخص کردن دایرکتوری ریشه برای مسیرهای نسبی.
.TP 8
.B -synch
اجبار همگام‌سازی (synchronization) برای درخواست‌های X.
.TP 8
.B -version
چاپ شماره نسخه.
.TP 8
.B \-w\ \fIlvl\fP
کنترل گزارش هشدارها هنگام کامپایل. سطح هشدار
0 همهٔ هشدارها را غیرفعال می‌کند؛ سطح هشدار 10 همهٔ آن‌ها را فعال می‌سازد.
.TP 8
.B \-xkb
تولید توصیف منبع صفحه‌کلید به عنوان خروجی (با پسوند .xkb).
.TP 8
.B \-xkm
تولید فایل کامپایل‌شدهٔ نگاشت کلید به عنوان خروجی (با پسوند .xkm).
.SH "همچنین ببینید (SEE ALSO)"
.BR setxkbmap (1),
.BR X (7),
.BR xkeyboard\-config (7)
.SH "نویسندگان (AUTHORS)"
Erik Fortune, Silicon Graphics