'\" t
.\"     Title: fvwm-menu-xlock
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-28
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "FVWM\-MENU\-XLOCK" "1" "2026-06-28" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
fvwm\-menu\-xlock \- ساخت تعریف منوی xlock برای fvwm
.SH "خلاصه دستور (SYNOPSIS)"
.sp
fvwm\-menu\-xlock [ \fB\-\-help\fP|\fB\-h\fP|\fB\-?\fP ] [ \fB\-\-version\fP|\fB\-V\fP ]
[ \fB\-\-name\fP|\fB\-n\fP name ] [ \fB\-\-title\fP|\fB\-t\fP title ]
[ \fB\-\-item\fP format ] [ \fB\-\-icon\-title\fP icon ] [ \fB\-\-icon\-item\fP icon ]
[ \fB\-\-special\-first\fP|\fB\-s\fP ] [ \fB\-\-\fP xlock params ]
.SH "توضیحات (DESCRIPTION)"
.sp
یک اسکریپت ساده perl که خروجی xlock را برای ساخت تعریف منوی fvwm از تمامی حالت‌های xlock تجزیه می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-\-help\fP
.RS 4
نمایش راهنما و خروج.
.RE
.sp
\fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.sp
\fB\-\-name\fP \fIname\fP
.RS 4
تعیین نام منو در آرگومان بعدی. پیش‌فرض XLockMenu است.
.RE
.sp
\fB\-\-title\fP \fItitle\fP
.RS 4
تعیین عنوان منو در آرگومان بعدی. پیش‌فرض XLock Modes است.
.RE
.sp
\fB\-\-item\fP \fIformat\fP
.RS 4
تعیین قالب آیتم منو در آرگومان بعدی؛ پیش‌فرض \f(CR\*(Aq%n\(rst(%d)\*(Aq\fP است. کلید TAB را می‌توان به‌صورت \f(CR\*(Aq\(rst\*(Aq\fP مشخص کرد، اما در .fvwm2rc باید از یک بک‌اسلش دوتایی یا یک TAB واقعی استفاده کنید.
.sp
مشخص‌کننده‌های قالب:
.sp
.if n .RS 4
.nf
.fam C
%n \- نام حالت
%d \- شرح حالت
%D \- شرح حالت بدون پیشوند "Shows " در صورت وجود
.fam
.fi
.if n .RE
.sp
این مشخص‌کننده‌ها می‌توانند یک اندازه عددی صحیح و اختیاری دریافت کنند؛ مثبت برای راست‌چین کردن رشته یا منفی برای چپ‌چین کردن آن، برای مثال: \f(CR%8x\fP؛ و همچنین \f(CR*num\fP یا \f(CR*\-num\fP اختیاری که نشان می‌دهد تنها num نویسه اول یا آخر (در صورت منفی بودن) باقی بماند؛ مقدار num باید بزرگ‌تر از ۳ باشد، چرا که بخش حذف‌شده با .\|.\|. جایگزین می‌شود، برای مثال: \f(CR%*30x\fP. هر دو را می‌توان ترکیب کرد: \f(CR%\-10*\-20x\fP؛ این حالت تعیین می‌کند که تنها ۲۰ نویسه آخر دریافت شوند، اما اگر طول آن کمتر از ۱۰ باشد \- با حداکثر ۱۰ فاصله در سمت راست پر شود.
.RE
.sp
\fB\-\-icon\-title\fP \fIicon\fP
.RS 4
تعیین آیکون منو برای عنوان. پیش‌فرض بدون آیکون عنوان است (معادل با یک آرگومان خالی برای آیکون).
.RE
.sp
\fB\-\-icon\-item\fP \fIicon\fP
.RS 4
تعیین آیکون منو برای آیتم معمولی. پیش‌فرض بدون آیکون است (معادل با یک آرگومان خالی برای آیکون).
.RE
.sp
\fB\-\-wm\-icons\fP
.RS 4
تعیین نام‌های آیکون مناسب برای استفاده با بسته wm\-icons. در حال حاضر این معادل است با: \fB\-\-icon\-title \*(Aq\*(Aq \-\-icon\-item menu/lock.xpm\fP.
.RE
.sp
\fB\-\-special\-first\fP
.RS 4
دستور می‌دهد که حالت‌های ویژه (معمولاً black، bomb و random) در ابتدا قرار گیرند.
.RE
.sp
پارامترهای گزینه‌ها را می‌توان هم با استفاده از \*(Aq=\*(Aq و هم در آرگومان بعدی مشخص کرد. گزینه‌های کوتاه اگر مبهم نباشند مشکلی ندارند: \-h، \-t؛ اما در مورد گزینه‌های کوتاه محتاط باشید، چیزی که اکنون نامبهم است می‌تواند در نسخه‌های بعدی مبهم شود.
.sp
آرگومان‌های اضافی (پس از \fB\-\-\fP) به xlock منتقل خواهند شد.
.sp
لطفاً برای مشاهده گزینه‌های xlock به صفحه راهنمای \fBxlock\fP(1) مراجعه کنید.
.SH "نحوه استفاده (USAGE)"
.sp
این خطوط را به فایل پیکربندی fvwm خود اضافه کنید:
.sp
.if n .RS 4
.nf
.fam C
PipeRead \*(Aqfvwm\-menu\-xlock \-\-name MenuSSaver \-\-title "Screensaver" \(rs
  \-\-icon\-item mini\-bball.xpm \-\-special\-first \-\- \-nice 19 \-nolock\*(Aq
PipeRead \*(Aqfvwm\-menu\-xlock \-\-name MenuSLock \-\-title "Lock Screen" \(rs
  \-\-icon\-item mini\-rball.xpm \-\-special\-first \-\- \-nice 19\*(Aq
AddToMenu "Utilities" "Screensaver%mini\-monitor.xpm%" Popup MenuSSaver
AddToMenu "Utilities" "Screenlock%mini\-lock.xpm%" Popup MenuSLock
.fam
.fi
.if n .RE
.SH "نویسندگان (AUTHORS)"
.sp
Charles K. Hines \c
.MTO "chuck_hines\(atvnet.ibm.com" "" "،"
نسخه اولیه.
.sp
Mikhael Goikhman \c
.MTO "migo\(athomemail.com" "" "،"
از ۲۴ فوریه ۱۹۹۹.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
این اسکریپت تحت همان شرایط خود fvwm توزیع می‌شود. برای جزئیات به مجوز عمومی همگانی گنو (GNU General Public License) مراجعه کنید.
.SH "گزارش باگ‌ها (BUGS)"
.sp
به خروجی xlock وابسته است. در صورتی که ساختار خروجی تغییر کند، منویی خالی تولید خواهد کرد.
.sp
گزارش باگ‌ها به \c
.MTO "fvwm\-workers\(atfvwm.org" "" ""
یا
.URL "https://github.com/fvwmorg/fvwm3" "" "."