'\" t
.\"     Title: fvwm-menu-desktop
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-28
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "FVWM\-MENU\-DESKTOP" "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-desktop \- پرونده‌های منوی XDG را خوانده و منوهای Fvwm ایجاد می‌کند
.SH "خلاصه دستور (SYNOPSIS)"
.sp
fvwm\-menu\-desktop [ \fB\-\-help\fP|\fB\-h\fP ] [ \fB\-\-version\fP ] [
\fB\-\-install\-prefix\fP \fIDIR\fP ] [ \fB\-\-desktop\fP \fINAME\fP ] [ \fB\-\-menu\-type\fP \fINAME\fP
] [ \fB\-\-theme\fP \fINAME\fP ] [ \fB\-\-with\-titles\fP|\fB\-w\fP ] [ \fB\-\-without\-titles\fP ]
[ \fB\-\-enable\-mini\-icons\fP ] [ \fB\-\-size\fP|\fB\-s\fP \fINUM\fP ] [ \fB\-\-mini\-icon\-dir\fP
\fIDIR\fP ] [ \fB\-\-app\-icon\fP \fINAME\fP ] [ \fB\-\-dir\-icon\fP \fINAME\fP ] [
\fB\-\-title\fP|\fB\-t\fP \fINAME\fP ] [ \fB\-\-insert\-in\-menu\fP \fINAME\fP ] [ \fB\-\-get\-menus\fP
\fIall\fP|\fIdesktop\fP ] [ \fB\-\-set\-menus\fP \fImenu_paths\fP ] [ \fB\-\-all\-menus\fP ] [
\fB\-\-include\-items\fP \fINAME\fP ] [ \fB\-\-regen\-cmd\fP \fICMD\fP ] [ \fB\-\-term\-cmd\fP \fICMD\fP
] [ \fB\-\-dynamic\fP ] [ \fB\-\-menu\-error\fP|\fB\-e\fP ] [ \fB\-\-verbose\fP|\fB\-v\fP ]
.SH "توضیحات (DESCRIPTION)"
.sp
این یک اسکریپت پایتون است که تعاریف منوهای XDG را برای ساخت منوهای متناظر در fvwm تجزیه می‌کند. اجرای این اسکریپت به python\-xdg وابسته است.
.SH "گزینه‌های اصلی (MAIN OPTIONS)"
.sp
\fB\-\-help\fP
.RS 4
نمایش راهنما و خروج.
.RE
.sp
\fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.sp
\fB\-\-get\-menus\fP \fIall\fP|\fIdesktop\fP
.RS 4
فهرستی از مسیرهای کامل منوهای یافت‌شده در سیستم را که با فاصله از هم جدا شده‌اند چاپ می‌کند.
\fIall\fP تمام منوهای موجود در سیستم به جز موارد خالی را چاپ می‌کند.
\fIdesktop\fP منو(هایی) را که توسط اسکریپت تولید می‌شوند چاپ خواهد کرد.
.sp
هیچ منویی تولید نخواهد شد.
.RE
.sp
\fB\-\-desktop\fP \fINAME\fP
.RS 4
پارامتر اختیاری برای تنظیم \fINAME\fP پرونده(های) منوی XDG (.menu) میزکار مورد استفاده. این گزینه هرگونه منوی پیش‌فرضی را که از طریق \fBFvwmForm\-XDGMenu\-Config\fP تنظیم شده باشد لغو می‌کند و باعث می‌شود اسکریپت به دنبال منوهایی بگردد که در آن‌ها \fINAME\fP بخشی از نام پرونده است. نام‌های ممکن عبارتند از: \fIgnome\fP، \fIkde\fP، \fIxfce\fP، \fIlxde\fP، \fIdebian\fP و غیره.
.sp
این گزینه می‌تواند همراه با \fB\-\-menu\-type\fP برای کنترل اینکه کدام پرونده(های) .menu استفاده شوند به کار رود.
.RE
.sp
\fB\-\-menu\-type\fP \fINAME\fP
.RS 4
پارامتر اختیاری برای تعیین \fINAME\fP نوع منوی XDG مورد استفاده. این گزینه هرگونه منوی پیش‌فرضی را که از طریق \fBFvwmForm\-XDGMenu\-Config\fP تنظیم شده باشد لغو می‌کند و باعث می‌شود اسکریپت به دنبال منوهایی بگردد که در آن‌ها \fINAME\fP بخشی از نام پرونده است. انواع ممکن برای \fINAME\fP می‌تواند مواردی چون: \fIapplications\fP، \fIsettings\fP، \fIpreferences\fP و غیره باشد.
.sp
هنگامی که همراه با \fB\-\-desktop\fP استفاده شود، تنها منوهایی که نام پرونده آن‌ها با \*(Aq\fBdestkop*menutype\fP\*(Aq تطابق دارد یافت می‌شوند. اگر هیچ منویی پیدا نشود، اسکریپت با یک خطا خارج می‌شود.
.RE
.sp
\fB\-\-all\-menus\fP
.RS 4
این گزینه تمام منوهای یافت‌شده در سیستم را می‌سازد. در صورت استفاده در ترکیب با \fB\-\-desktop\fP یا \fB\-\-menu\-type\fP، تمامی منوهای منطبق با آن تنظیمات ساخته خواهند شد.
.RE
.sp
\fB\-\-install\-prefix\fP \fIDIR\fP
.RS 4
پارامتر اختیاری برای تغییر مسیرهای استاندارد تعاریف منوی XDG. به \fBfvwm\-menu\-desktop\fP اعلام می‌کند که به جای مسیرهای استاندارد /etc/xdg/menus (و $HOME/.config/menus در صورت وجود)، در \fIDIR\fP به دنبال پرونده‌های .menu بگردد.
.RE
.sp
\fB\-\-with\-titles\fP|\fB\-w\fP
.RS 4
در صورت فعال بودن این گزینه، منوها با عنوان تولید می‌شوند. این حالت پیش‌فرض است. از این گزینه می‌توان برای لغو تنظیم پیش‌فرض \fBFvwmForm\-XDGMenu\-Config\fP استفاده کرد.
.RE
.sp
\fB\-\-without\-titles\fP
.RS 4
در صورت فعال بودن این گزینه، منوها بدون عنوان تولید می‌شوند. حالت پیش‌فرض، تولید منو با عنوان است.
.RE
.sp
\fB\-\-title\fP|\fB\-t\fP \fINAME\fP
.RS 4
گزینه‌ای برای تعیین عنوان منو (\fINAME\fP) بالاترین منوی مورد استفاده توسط دستورات \fBMenu\fP یا \fBPopup\fP در Fvwm. مقدار پیش‌فرض "XDGMenu" است.
.RE
.sp
\fB\-\-include\-items\fP \fINAME\fP
.RS 4
این گزینه مشخص می‌کند که آیا موارد منوی اضافی \*(AqRegenerate\*(Aq و \*(AqConfigure\*(Aq در منوی سطح بالا گنجانده شوند یا خیر. \fINAME\fP می‌تواند یکی از مقادیر \fIregenerate\fP، \fIconfig\fP، \fIboth\fP یا \fInone\fP باشد. مقدار پیش‌فرض \fIboth\fP است.
.RE
.sp
\fB\-\-regen\-cmd\fP \fICMD\fP
.RS 4
این گزینه دستور fvwm (\fICMD\fP) را که هنگام انتخاب مورد منوی \*(AqRegenerate\*(Aq اجرا می‌شود، تعیین می‌کند. مقدار پیش‌فرض "PipeRead `fvwm\-menu\-desktop`" است.
.RE
.sp
\fB\-\-term\-cmd\fP \fICMD\fP
.RS 4
این گزینه دستور شبیه‌ساز پایانه (\fICMD\fP) را تعیین می‌کند که برای اجرای برنامه‌های ترمینال استفاده می‌شود. \fICMD\fP باید به یک گزینه اجرا ختم شود، مانند گزینه \-e در xterm، که دستوری الحاق‌شده به \fICMD\fP را اجرا می‌کند. مقدار پیش‌فرض "xterm \-e" است.
.RE
.sp
\fB\-\-dynamic\fP
.RS 4
این گزینه برای ایجاد منوهای پویا با استفاده از \fBDynamicPopUpAction\fP و \fBDynamicPopDownAction\fP به کار می‌رود. این کار عبارت \*(Aqrecreate\*(Aq را به دستور \fBDestroyMenu\fP در منوی بالاترین سطح اضافه می‌کند تا در زمان بازتولید منو، آن کنش‌ها نابود (Destroy) نشوند.
.RE
.sp
\fB\-\-insert\-in\-menu\fP \fINAME\fP
.RS 4
گزینه‌ای برای درج منو(های) تولیدشده \fBدرون\fP منوی \fINAME\fP (عنوان سطح بالای آن). این گزینه سبب می‌شود منوی سطح بالا نابود (Destroy) نشود و موارد به انتهای آن اضافه شوند.
.sp
توجه داشته باشید منوهایی که با این گزینه بازتولید می‌شوند، موارد جدید را به انتهای منوی موجود الحاق خواهند کرد. هر بار که منو دوباره تولید شود موارد جدیدی ظاهر شده و منویی رو به رشد از گزینه‌های تکراری ایجاد می‌شود. برای رفع این مشکل باید کل منو را از طریق یک تابع بازتولید کنید یا fvwm را مجدداً راه‌اندازی نمایید. برای مشاهده راه‌حل‌ها به بخش \fBمثال‌ها (EXAMPLES)\fP در ادامه مراجعه کنید.
.RE
.sp
\fB\-\-set\-menus\fP \fImenu_paths\fP
.RS 4
تمام منوهای مشخص‌شده در فهرستی از مسیرهای کامل منو که با فاصله از هم جدا شده‌اند را تولید می‌کند. این گزینه تمامی مقادیر پیش‌فرض و تنظیمات \fB\-\-desktop\fP|\fB\-\-menu\-type\fP را لغو می‌کند.
.RE
.sp
\fB\-\-menu\-error\fP|\fB\-e\fP
.RS 4
در صورتی که این گزینه فعال باشد و python\-xdg یافت نشود، اسکریپت پیغام خطا را درون منوی تولیدشده چاپ می‌کند. در default\-config استفاده می‌شود.
.RE
.sp
\fB\-\-verbose\fP
.RS 4
چاپ اطلاعات بیشتر روی STDERR را فعال می‌کند.
.RE.SH "گزینه‌های آیکون (ICONS OPTIONS)"
.sp
به‌طور پیش‌فرض، fvwm\-menu\-desktop منوها را بدون آیکون‌های کوچک (mini\-icons) می‌سازد. برای
فعال‌سازی آیکون‌های کوچک از گزینه‌های زیر استفاده کنید.
.sp
اگر ImageMagick روی سیستم نصب باشد، این اسکریپت اندازه آیکون‌ها را تغییر داده و
آن‌ها را در $FVWM_USERDIR/.icons کپی می‌کند. این کار ممکن است کمی طول بکشد. هنگام
اولین بار ایجاد آیکون‌ها باید آماده صبر کردن باشید. پس از ایجاد آیکون‌ها، اسکریپت
باید سریع‌تر اجرا شود. اگر استفاده از آیکون‌ها هنوز هم بیش از حد کُند است، برای راه‌های
محدود کردن دفعات ایجاد منو جهت افزایش سرعت، به بخش \fBمثال‌ها (EXAMPLES)\fP مراجعه کنید.
.sp
\fB\-\-enable\-mini\-icons\fP
.RS 4
این گزینه mini\-iconها را در منوها فعال می‌کند. در صورت تنظیم، از آیکون‌های کوچک ۲۴x۲۴
استفاده می‌شود. اگر آیکون مشخص‌شده در آن اندازه نباشد، در صورت نصب بودن \fBImageMagick\fP
تبدیل شده و در $HOME/.fvwm/icons یا در دایرکتوری مشخص‌شده با گزینه \-\-mini\-icon\-dir
ذخیره می‌شود. در غیر این صورت هیچ آیکونی در منو برای آن مدخل نمایش داده نخواهد شد.
در بیشتر توزیع‌ها، تمام مدخل‌های منو mini\-iconهای مناسب با برنامه را خواهند داشت.
.RE
.sp
\fB\-\-theme\fP \fINAME\fP
.RS 4
پوسته (theme) آیکون مورد استفاده را مشخص می‌کند. مقدار پیش‌فرض \fIgnome\fP است، اما
همه پوسته‌های دیگر موجود در /usr/share/icons نیز می‌توانند استفاده شوند، به جز پوسته
\fIhicolor\fP؛ زیرا این پوسته در صورت پیدا نشدن آیکون، پوسته بازگشتی (fallback) پیش‌فرض است.
.RE
.sp
\fB\-\-size\fP|\fB\-s\fP \fINUM\fP
.RS 4
اگر \-\-enable\-mini\-icons استفاده شود، اندازه (\fIsize\fP) آیکون‌ها می‌تواند با این
پارامتر تغییر کند. مقدار پیش‌فرض 24 است.
.RE
.sp
\fB\-\-mini\-icon\-dir\fP \fIDIR\fP
.RS 4
زمانی که mini\-icon با اندازه مناسب در دسترس نباشد، fvwm\-menu\-desktop آیکون‌هایی با
اندازه مناسب در $HOME/.fvwm/icons ایجاد می‌کند. اگر نمی‌خواهید از دایرکتوری پیش‌فرض،
یعنی $HOME/.fvwm/icons استفاده کنید، از این گزینه برای تعیین پوشه‌ای دیگر استفاده کنید.
.RE
.sp
\fB\-\-app\-icon\fP \fINAME\fP
.RS 4
در صورت پیدا نشدن آیکون‌های دیگر، آیکون پیش‌فرض برنامه را تعیین می‌کند. مقدار پیش‌فرض
\*(Aqgnome\-applications\*(Aq است.
.RE
.sp
\fB\-\-dir\-icon\fP \fINAME\fP
.RS 4
در صورت پیدا نشدن آیکون‌های دیگر، آیکون پیش‌فرض دایرکتوری را تعیین می‌کند. مقدار پیش‌فرض
\*(Aqgnome\-fs\-directory\*(Aq است.
.RE
.SH "نحوه استفاده (USAGE)"
.sp
دستور \fBfvwm\-menu\-desktop\fP فایل‌های .menu استاندارد XDG را در قالب نحو (syntax) منوهای fvwm خروجی می‌دهد.
هنگامی که \fBfvwm\-menu\-desktop\fP بدون هیچ گزینه‌ای اجرا شود، مقادیر پیش‌فرض را
از فایل \fBFvwmForm\-XDGMenu\-Config\fP بارگذاری کرده (پایین را ببینید) و سپس سیستم شما را
برای فایل(های) منوی مناسب جستجو می‌کند. برای مشاهده اینکه چه منوهایی روی
سیستم شما موجود است دستور زیر را اجرا کنید:
.sp
.if n .RS 4
.nf
.fam C
fvwm\-menu\-desktop \-\-get\-menus all
.fam
.fi
.if n .RE
.sp
اگر هیچ منویی یافت نشد، ممکن است هیچ منویی روی سیستم شما نصب نشده باشد. به‌طور
پیش‌فرض منوها به صورت فایل‌های \fB.menu\fP در /etc/xdg/menus،
$HOME/.config/menus یا مکانی که در $XDG_MENU_PREFIX تنظیم شده ذخیره می‌شوند. می‌توانید از
\fB\-\-install\-prefix\fP برای تعیین مکان دیگری جهت جستجوی منوها استفاده کنید.
.sp
از طریق ترکیبی از گزینه‌های خط فرمان و تنظیمات \fBFvwmForm\-XDGMenu\-Config\fP، برنامه
\fBfvwm\-menu\-desktop\fP می‌تواند هر ترکیبی از منوهای یافت‌شده را تولید کند. برای دریافت
فهرستی از اینکه چه منو(هایی) تولید خواهند شد، از گزینه \fB\-\-get\-menus\fP \fIdesktop\fP استفاده کنید.
دستور زیر تمامی منوهایی را که در صورت اجرای \fBfvwm\-menu\-desktop\fP بدون هیچ گزینه‌ای تولید
می‌شدند فهرست می‌کند.
.sp
.if n .RS 4
.nf
.fam C
fvwm\-menu\-desktop \-\-get\-menus desktop
.fam
.fi
.if n .RE
.sp
برنامه \fBfvwm\-menu\-desktop\fP منو(های) قابل تولید را به صورت زیر تعیین می‌کند:
.sp
اگر هیچ فایل پیکربندی یافت نشود، به همه منوها وزن داده می‌شود و اسکریپت
بهترین منوی یافت‌شده (با بالاترین وزن) را تولید خواهد کرد.
.sp
اگر یک فایل پیکربندی یافت شود (و از گزینه‌های بازنویسی استفاده نشود)، اسکریپت
همه منوهای انتخاب‌شده در \fBFvwmForm\-XDGMenu\-Config\fP را تولید می‌کند.
.sp
گزینه‌های \fB\-\-desktop\fP، \fB\-\-menu\-type\fP، \fB\-\-set\-menus\fP و \fB\-\-all\-menus\fP بر
تمامی منوهای انتخاب‌شده در \fBFvwmForm\-XDGMenu\-Config\fP تقدم داشته و آن‌ها را بازنویسی می‌کنند.
.sp
گزینه‌های \fB\-\-desktop\fP و \fB\-\-menu\-type\fP فقط منوهایی را شامل می‌شوند که نام آن‌ها با
\*(Aq\fBdesktop*menutype\fP\*(Aq مطابقت داشته باشد. اگر همراه با \fB\-\-all\-menus\fP استفاده شوند، تمام منوهای
منطبق تولید می‌شوند. اگر بدون \fB\-\-all\-menus\fP استفاده شوند، تنها منویی که بالاترین وزن را دارد
تولید می‌شود.
.sp
گزینه \fB\-\-set\-menus\fP منوها را از فهرست نام فایل‌های منو با مسیر کامل تولید می‌کند.
.sp
گزینه \fB\-\-all\-menus\fP به تنهایی تمام منوهای یافت‌شده را تولید می‌کند.
.sp
به‌طور پیش‌فرض \fBfvwm\-menu\-desktop\fP منویی ایجاد می‌کند که نام بالاترین سطح آن
"XDGMenu" است. برای اینکه به fvwm بگویید خروجی \fBfvwm\-menu\-desktop\fP را برای ساخت منوی
XDGMenu بخواند، خط زیر را به فایل پیکربندی fvwm خود اضافه کنید:
.sp
.if n .RS 4
.nf
.fam C
PipeRead \*(Aqfvwm\-menu\-desktop\*(Aq
.fam
.fi
.if n .RE
.sp
\fBهشدار:\fP بسته به گزینه‌های استفاده‌شده این دستور ممکن است کُند باشد و
fvwm تا زمان کامل شدن این دستور متوقف خواهد شد. برای جزئیات بیشتر و
راه‌حل‌های احتمالی، به بخش \fBمثال‌ها (EXAMPLES)\fP در زیر مراجعه کنید.
.sp
پس از تولید منو، می‌توانید با استفاده از دستور "Menu XDGMenu" آن را باز کنید.
همچنین می‌توانید با دستور زیر آن را در منوی MenuFvwmRoot بگنجانید:
.sp
.if n .RS 4
.nf
.fam C
AddToMenu MenuFvwmRoot "XDG Menu" Popup XDGMenu
.fam
.fi
.if n .RE
.sp
دستور \fBfvwm\-menu\-desktop\fP می‌تواند هم از طریق گزینه‌های خط فرمان و هم از طریق یک
رابط کاربری گرافیکی \fBFvwmForm\fP پیکربندی شود تا منو(های) تولیدی را سفارشی‌سازی کند..SH "رابط کاربری گرافیکی (GUI)"
.sp
\fBFvwmForm\-XDGMenu\-Config\fP یک رابط \fBFvwmForm\fP است که می‌تواند برای
پیکربندی مقادیر پیش‌فرض \fBfvwm\-menu\-desktop\fP استفاده شود. می‌توانید از
طریق آیتم «Configure» در منوی سطح بالایی که تولید شده به آن دسترسی پیدا کنید
یا دستور زیر را از درون \fBFvwmCommand\fP یا \fBFvwmPrompt\fP اجرا نمایید:
.sp
.if n .RS 4
.nf
.fam C
Module FvwmPerl \-l fvwm\-menu\-desktop\-config.fpl
.fam
.fi
.if n .RE
.sp
از این فرم می‌توان برای انتخاب این‌که چه منو(هایی) به‌طور پیش‌فرض تولید شوند،
به همراه تنظیم بسیاری از (اما نه همهٔ) گزینه‌های موجود استفاده کرد. هنگامی که روی
«Save Settings» کلیک می‌کنید، این فرم یک فایل پیکربندی در مسیر
$FVWM_USERDIR/.FvwmForm\-XDGMenu\-Config می‌نویسد که \fBfvwm\-menu\-desktop\fP
در زمان اجرا، آن را برای مقادیر پیش‌فرض تجزیه خواهد کرد.
.sp
برای اطلاعات بیشتر، راهنمای درون \fBFvwmForm\-XDGMenu\-Config\fP را ببینید.
.SH "مثال‌ها (EXAMPLES)"
.sp
راه‌های زیادی برای تنظیم این‌که fvwm چه زمانی \fBfvwm\-menu\-desktop\fP را برای
تولید منو اجرا کند، وجود دارد. یک روش این است که صرفاً هنگام بارگذاری fvwm منو
تولید شود و سپس از ابزار پیکربندی گرافیکی برای تغییر هر یک از گزینه‌ها استفاده شود.
برای این کار، فقط کافی است موارد زیر را به فایل پیکربندی fvwm اضافه کنید:
.sp
.if n .RS 4
.nf
.fam C
AddToMenu MenuFvwmRoot "XDG Menu" Popup XDGMenu PipeRead
\*(Aqfvwm\-menu\-desktop\*(Aq
.fam
.fi
.if n .RE
.sp
منو یک بار هنگام بارگذاری fvwm ایجاد می‌شود. از آن‌جا که ساخت منو گاهی اوقات
ممکن است کُند باشد، این امر می‌تواند باعث شود بارگذاری fvwm بیش از حد انتظار
طول بکشد.
.sp
منو تنها هنگام شروع به کار fvwm تولید می‌شود. اگر نرم‌افزاری نصب یا حذف شود،
باید گزینهٔ \*(AqRegenerate\*(Aq را برای بازسازی منو انتخاب کنید.
.sp
یک روش برای افزایش سرعت این است که منو را در یک فایل ذخیره کرده و فقط
هنگامی که \*(AqRegenerate\*(Aq انتخاب شد، منو را تولید نمایید. برای این کار از
\fB\-\-regen\-cmd\fP برای فراخوانی یک تابع سفارشی استفاده کنید و با دستوری
مانند دستور زیر، منو را در یک فایل بنویسید:
.sp
.if n .RS 4
.nf
.fam C
fvwm\-menu\-desktop \-\-regen\-cmd XDGRegen > $FVWM_USERDIR/.XDGMenu
.fam
.fi
.if n .RE
.sp
سپس دستورهای زیر را به فایل پیکربندی fvwm اضافه کنید تا تابع XDGRegen
تعریف شود. خط یکی مانده به آخر، در صورتی که فایل منو هنگام شروع fvwm وجود
نداشته باشد، آن را تولید خواهد کرد.
.sp
.if n .RS 4
.nf
.fam C
DestroyFunc XDGRegen
AddToFunc\&   XDGRegen
+ I PipeRead \*(Aqfvwm\-menu\-desktop \-\-regen\-cmd XDGRegen > \(rs
    $[FVWM_USERDIR]/.XDGMenu; echo "Nop"\*(Aq
+ I Read $[FVWM_USERDIR]/.XDGMenu

Test (!f $[FVWM_USERDIR]/.XDGMenu) XDGRegen Read $[FVWM_USERDIR]/.XDGMenu
.fam
.fi
.if n .RE
.sp
علاوه بر ایجاد یک منوی سطح بالا، \fBfvwm\-menu\-desktop\fP می‌تواند با استفاده
از گزینهٔ \fB\-\-insert\-in\-menu\fP منو را درون یک منوی موجود درج کند. برای
مثال، می‌توان منوی MenuFvwmRoot را ایجاد کرده و آیتم‌های XDG را در انتهای آن
قرار داد.
.sp
.if n .RS 4
.nf
.fam C
DestroyMenu MenuFvwmRoot
AddToMenu\&   MenuFvwmRoot "Fvwm" Title
+ "Item1" Action1 ...
+ "ItemN" ActionN
+ "" Nop

PipeRead \*(Aqfvwm\-menu\-desktop \-\-insert\-in\-menu MenuFvwmRoot\*(Aq
.fam
.fi
.if n .RE
.sp
در این حالت، آیتم‌های منو در انتهای منوی MenuFvwmRoot درج می‌شوند. اگر هیچ
آیتمی در منو نباشد، این منو به MenuFvwmRoot تبدیل می‌شود. مشکل این‌جاست که
برای بازسازی (Regenerate) آن باید fvwm را مجدداً راه‌اندازی کنید یا کل منو را
از نو بسازید، زیرا آیتم‌های منو قابل حذف نیستند. برای انجام این کار می‌توانید از
تابعی مانند زیر استفاده کنید:
.sp
.if n .RS 4
.nf
.fam C
DestroyFunc XDGRegen
AddToFunc\&   XDGRegen
+ I DestroyMenu MenuFvwmRoot
+ I AddToMenu MenuFvwmRoot "Fvwm" Title
+ I AddToMenu MenuFvwmRoot "Item1" Action1 ...
+ I AddToMenu MenuFvwmRoot "ItemN" ActionN
+ I AddToMenu MenuFvwmRoot "" Nop
+ I PipeRead \*(Aqfvwm\-menu\-desktop \-\-insert\-in\-menu MenuFvwmRoot \(rs
    \-\-regen\-cmd XDGRegen\*(Aq
.fam
.fi
.if n .RE
.sp
همچنین fvwm می‌تواند با استفاده از \fBDynamicPopUpAction\fP و/یا
\fBDynamicPopDownAction\fP منوها را به‌صورت پویا ایجاد کند. این دستورها
هنگامی که به همراه یک منو استفاده شوند، در زمان باز شدن منو یک تابع را اجرا
می‌کنند. به عنوان مثال، می‌توان منوی XDGMenu را هنگام باز شدن آن با استفاده از
دستور زیر ایجاد کرد:
.sp
.if n .RS 4
.nf
.fam C
AddToMenu XDGMenu "XDGMenu" Title
+ DynamicPopUpAction PipeRead \*(Aqfvwm\-menu\-desktop\*(Aq
.fam
.fi
.if n .RE
.sp
این کار منو را هنگام باز شدن ایجاد می‌کند. یک مشکل در این‌جا این است که فقط
بار اولی که منو باز می‌شود ایجاد خواهد شد و برای دیدن تغییرات هنوز باید منو را
Regenerate کنید. برای این‌که منو هر بار که باز می‌شود ساخته شود، از گزینهٔ
\fB\-\-dynamic\fP استفاده کنید:
.sp
.if n .RS 4
.nf
.fam C
AddToMenu XDGMenu "XDGMenu" Title
+ DynamicPopUpAction PipeRead \*(Aqfvwm\-menu\-desktop \(rs
    \-\-dynamic \-\-include\-items config\*(Aq
+ DynamicPopDownAction DestroyMenu recreate XDGMenu
.fam
.fi
.if n .RE
.sp
این کار باعث می‌شود هنگام بسته شدن منو، دستور Destroy روی آن اجرا شود تا
دفعهٔ بعد که باز می‌شود دوباره ساخته شود. پرچم recreate منو را به‌طور کامل نابود
نمی‌کند و اکشن‌های DynamicPopUpAction و DynamicPopDownAction را حفظ
می‌نماید. پرچم \fB\-\-dynamic\fP گزینهٔ recreate را در منوهای تولیدشده
می‌گنجاند.
.sp
برای درج یک منو در MenuFvwmRoot و در عین حال پویا نگه داشتن آن، باید از
تابعی استفاده کنید که کل منو را تولید کند. برای مثال:
.sp
.if n .RS 4
.nf
.fam C
DestroyFunc GenRootMenu
AddToFunc GenRootMenu
+ I DestroyMenu recreate MenuFvwmRoot
+ I AddToMenu MenuFvwmRoot "Fvwm" Title
+ I AddToMenu MenuFvwmRoot "Item1" Action1 ...
+ I AddToMenu MenuFvwmRoot "ItemN" ActionN
+ I AddToMenu MenuFvwmRoot "" Nop
+ PipeRead `fvwm\-menu\-desktop \-\-insert\-in\-menu MenuFvwmRoot \(rs
    \-\-include\-items config`

AddToMenu MenuFvwmRoot "Fvwm" Title
+ DynamicPopUpAction GenRootMenu
+ DynamicPopDownAction DestroyMenu recreate MenuFvwmRoot
.fam
.fi
.if n .RE.SH "گزارش باگ‌ها (BUGS)"
.sp
کل فرایند ایجاد منوها از روی فایل‌ها کُند است. در غیر این صورت، باگ‌ها را به فهرست پستی fvwm\-workers گزارش دهید \c
.MTO "fvwm\-workers\(atfvwm.org" "" "."
.SH "نویسندگان (AUTHORS)"
.sp
این اسکریپت بر اساس fvwm\-xdg\-menu.py نوشته‌شده توسط Piotr Zielinski است
(\c
.URL "http://www.cl.cam.ac.uk/~pz215" "" ")"
که مجوز GPL 2 را در تاریخ 03.12.2005 برای آن تعیین کرده است.
.sp
این اسکریپت توسط fvwm\-workers بازنویسی شد تا جایگزین اسکریپت perl موجود fvwm\-menu\-desktop شود.
.SH "کپی‌رایت و تکثیر (COPYING)"
.sp
این اسکریپت تحت همان شرایط خود fvwm توزیع می‌شود. برای جزئیات، GNU General Public License را ببینید.