.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "ICEWM-PROGRAMS 5" .TH ICEWM-PROGRAMS 5 2026-08-06 "icewm\ 4.1.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" .IX Subsection "NAME" icewm\-programs \- فایل پیکربندی برنامه‌های icewm .SH "خلاصه دستور (SYNOPSIS)" .IX Subsection "SYNOPSIS" .Vb 5 \& $ICEWM_PRIVCFG/programs \& $XDG_CONFIG_HOME/icewm/programs \& $HOME/.icewm/programs \& /usr/etc/icewm/programs \& /usr/share/icewm/programs .Ve .SH "توضیحات (DESCRIPTION)" .IX Subsection "DESCRIPTION" فایل \fIprograms\fR یک فایل پیکربندی فهرست (منو) برنامه‌های نصب‌شده است که به‌طور خودکار تولید می‌شود. این فایل باید توسط xdg_menu، wmconfig (ردهت)، menu (دبیان) یا icewm\-menu\-fdo، احتمالاً به عنوان بخشی از توالی ورود به سیستم یا راه‌اندازی X تولید شود. .SS "ساختار (FORMAT)" .IX Subsection "FORMAT" قالب این فایل شامل یکی از ساختارهای دستوری خطوط زیر است: .IP "\fBprog\fR \fB""\fR\fItitle\fR\fB""\fR \fIicon\fR \fIprogram\fR \fIoptions\fR" 4 .IX Item "prog ""title"" icon program options" برنامه‌ای را مشخص می‌کند که هنگام انتخاب آیتم فهرست، اجرا می‌شود. .IP "\fBrestart\fR \fB""\fR\fItitle\fR\fB""\fR \fIicon\fR \fIprogram\fR \fIoptions\fR" 4 .IX Item "restart ""title"" icon program options" برنامه‌ای را مشخص می‌کند که هنگام انتخاب آیتم فهرست، جایگزین مدیر پنجره می‌شود. این گزینه برای راه‌اندازی سایر مدیرهای پنجره از داخل \fBicewm\fR\|(1) کاربرد دارد. .IP "\fBrunonce\fR \fB""\fR\fItitle\fR\fB""\fR \fIicon\fR \fB""\fR[\fIname\fR][\fB.\fR\fIclass\fR]\fB""\fR \fIprogram\fR \fIoptions\fR" 4 .IX Item "runonce ""title"" icon ""[name][.class]"" program options" برنامه‌ای را برای اجرا در هنگام انتخاب آیتم فهرست مشخص می‌کند؛ با این حال، اگر پنجره‌ای با \fIname\fR و \fIclass\fR مشخص‌شده در حال حاضر وجود داشته باشد، برنامه دوباره اجرا نخواهد شد. .IP "\fBmenu\fR \fB""\fR\fItitle\fR\fB""\fR \fIicon\fR \fB{\fR # contained items \fB}\fR" 4 .IX Item "menu ""title"" icon { # contained items }" یک زیرفهرست را مشخص می‌کند. خطوطی که بین آکولادها قرار می‌گیرند می‌توانند هر یک از آیتم‌های فهرست شرح داده‌شده در اینجا باشند. .IP "\fBmenufile\fR \fB""\fR\fItitle\fR\fB""\fR \fIicon\fR \fB""\fR\fIfilename\fR\fB""\fR" 4 .IX Item "menufile ""title"" icon ""filename""" فایلی را مشخص می‌کند که آیتم‌های زیرفهرست (خطوط) از آن جمع‌آوری شده و در این نقطه از فهرست قرار می‌گیرند. .IP "\fBmenuprog\fR \fB""\fR\fItitle\fR\fB""\fR \fIicon\fR \fIprogram\fR \fIoptions\fR" 4 .IX Item "menuprog ""title"" icon program options" برنامه‌ای را مشخص می‌کند که آیتم‌های زیرفهرست را در خروجی استاندارد چاپ خواهد کرد و این آیتم‌ها جمع‌آوری شده و در این نقطه در زیرفهرست قرار می‌گیرند. .IP "\fBmenuprogreload\fR \fB""\fR\fItitle\fR\fB""\fR \fIicon\fR \fItimeout\fR \fIprogram\fR \fIoptions\fR" 4 .IX Item "menuprogreload ""title"" icon timeout program options" مشابه \fBmenuprog\fR است، اما پس از حداقل \fItimeout\fR ثانیه، فهرست دوباره تولید می‌شود. .IP "\fBinclude\fR \fB""\fR\fIfilename\fR\fB""\fR" 4 .IX Item "include ""filename""" مدخل‌های اضافی را از فایل \fIfilename\fR می‌خواند. .IP "\fBincludeprog\fR \fIprogram\fR \fIoptions\fR" 4 .IX Item "includeprog program options" مدخل‌های اضافی را از خروجی \fIprogram\fR \fIoptions\fR می‌خواند. .IP \fBseparator\fR 4 .IX Item "separator" یک جداکننده برای آیتم‌های فهرست. .PP به طوری که: .IP "\fBprog\fR, \fBrestart\fR, \fBrunonce\fR, \fBmenu\fR, \fBmenufile\fR, \fBmenuprog\fR, \fBmenuprogreload\fR, \fBinclude\fR, \fBincludeprog\fR, \fBseparator\fR" 4 .IX Item "prog, restart, runonce, menu, menufile, menuprog, menuprogreload, include, includeprog, separator" این‌ها کلیدواژه‌های رشته‌ای صریح (literal) هستند. .IP "\fB""\fR\fItitle\fR\fB""\fR" 4 .IX Item """title""" رشتهٔ \fItitle\fR مرتبط با آیتم فهرست است که در فهرست نمایش داده می‌شود. هنگامی که \fItitle\fR شامل فاصله باشد، عنوان باید درون علامت نقل‌قول دوتایی (\f(CW\*(C`"\*(C'\fR) قرار گیرد. .IP \fIicon\fR 4 .IX Item "icon" نام فایل آیکون (با یا بدون پسوند) یا مسیر کامل به یک فایل آیکون است. .IP "\fB""\fR[\fIname\fR][\fB.\fR\fIclass\fR]\fB""\fR" 4 .IX Item """[name][.class]""" \&\fIname\fR نام منبع پنجره‌ای است که توسط \fIprogram\fR اجرا شده و \fIclass\fR کلاس منبع پنجره است. تنها مشخص کردن یکی از \fIname\fR یا \fIclass\fR کافی است. این مقدار برای تشخیص اینکه آیا برنامه از قبل در حال اجرا است یا خیر استفاده می‌شود و همراه با کلیدواژهٔ \fBrunonce\fR به کار می‌رود. .IP "\fIprogram\fR \fIoptions\fR" 4 .IX Item "program options" \&\fIprogram\fR نام فایل اجرایی یا مسیر کامل به فایل اجرایی است که در پاسخ به انتخاب آیتم فهرست اجرا خواهد شد. هنگامی که با کلیدواژهٔ \fBmenuprog\fR استفاده می‌شود، \fIprogram\fR باید محتوای فهرست را در خروجی استاندارد چاپ کند که برای فهرست‌های پویا استفاده می‌شود. .Sp \&\fIoptions\fR گزینه‌ها و آرگومان‌هایی است که عیناً به \fIprogram\fR فرستاده می‌شوند. .IP \fIfilename\fR 4 .IX Item "filename" \&\fIfilename\fR نام فایل به صورت نسبی نسبت به یکی از دایرکتوری‌های پیکربندی \fBicewm\fR\|(1) یا مسیر کامل به یک فایل است. این فایل با کلیدواژهٔ \fBmenufile\fR استفاده می‌شود و فایلی را مشخص می‌کند که آیتم‌های بیشتر فهرست از آن خوانده شوند. .SH "مثال‌ها (EXAMPLES)" .IX Subsection "EXAMPLES" در ادامه یک نمونه فایل \fIprograms\fR که همراه با \fBicewm\fR\|(1) ارائه می‌شود آمده است: .PP .Vb 10 \& # This file is intended to be customized by the distributions. \& # (they should place it in /etc/X11/icewm) \& # \& # mostly obsolete, fixme \& menu Editors folder { \& prog vim vim gvim \& prog emacs emacs emacs \& prog Lyx emacs lyx \& } \& menu "WWW" folder { \& prog Galeon galeon galeon \& prog Arena arena arena \& prog Lynx lynx xterm \-e lynx \& prog Links lynx xterm \-e links \& } \& menu "Document Viewers" folder { \& prog "DVI Previewer" xdvi xdvi \& prog "Ghostview" ghostview gv \& } \& menu Graphics folder { \& prog Gimp gimp gimp \& prog XV xv xv \& prog XPaint xpaint xpaint \& prog XFig xfig xfig \& } \& menu Games folder { \& prog Xboard xboard xboard \& prog "Tux Racer" tuxracer tuxracer \& } \& menu System folder { \& prog "Control Panel" redhat control\-panel \& } \& menu Utilities folder { \& prog XPlayCD xplaycd xplaycd \& prog XMixer xmixer xmixer \& prog Clock xclock xclock \& prog Magnify xmag xmag \& prog Calculator xcalc xcalc \& prog Colormap xcolormap xcmap \& prog Clipboard xclipboard xclipboard \& prog xkill bomb xkill \& prog xload xload xload \& prog xosview xosview xosview \& separator \& prog "Screen Saver" xlock xlock \-nolock \& prog "Screen Lock" xlock xlock \& } \& menu "Window Managers" folder { \& restart icewm \- icewm \& restart metacity \- metacity \& restart wmaker \- wmaker \& restart fluxbox \- fluxbox \& restart blackbox \- blackbox \& restart enlightenment \- enlightenment \& restart fvwm2 \- fvwm2 \& restart fvwm \- fvwm \& restart sawfish \- sawfish \& restart sawfish2 \- sawfish2 \& } .Ve .SH "فایل‌ها (FILES)" .IX Subsection "FILES" مکان‌های فایل \fIprograms\fR به شرح زیر است: .PP .Vb 5 \& $ICEWM_PRIVCFG/programs \& $XDG_CONFIG_HOME/icewm/programs \& $HOME/.icewm/programs \& /usr/etc/icewm/programs \& /usr/share/icewm/programs .Ve .PP مکان‌ها به ترتیبی که فهرست شده‌اند جستجو می‌شوند؛ اولین فایل یافت‌شده خوانده می‌شود و از بقیه صرف‌نظر خواهد شد. .SH "همچنین ببینید (SEE ALSO)" .IX Subsection "SEE ALSO" \&\fBicewm\fR\|(1), \&\fBicewm\-menu\fR\|(5), \&\fBicewm\-menu\-fdo\fR\|(1). .SH "نویسندگان (AUTHORS)" .IX Subsection "AUTHOR" Brian Bidulock . .SH "مجوز (LICENSE)" .IX Subsection "LICENSE" \&\fBIceWM\fR تحت «مجوز عمومی همگانی کتابخانه گنو» (GNU Library General Public License) منتشر شده است. فایل \fICOPYING\fR را در بستهٔ توزیع ببینید.