.\" t .\" .TH XMAN 1 "xman 1.2.0" "X Version 11" .SH "نام (NAME)" xman \- برنامه نمایش صفحات راهنما برای سامانه پنجره X .SH "خلاصه دستور (SYNOPSIS)" .B xman [ .I \-options \&.\|.\|. ] .SH "توضیحات (DESCRIPTION)" دستور .I Xman یک مرورگر صفحات راهنما است. اندازه پیش‌فرض پنجره اولیه \fIxman\fP کوچک است تا بتوانید آن را در تمام طول نشست ورود به سیستم باز نگه دارید. در پنجره اولیه سه دکمه وجود دارد: \fIHelp\fP پنجره‌ای با راهنمای برخط باز می‌کند، \fIQuit\fP خارج می‌شود، و \fIManual Page\fP پنجره‌ای باز می‌کند که یک مرورگر صفحات راهنما درون آن قرار دارد. فشردن Control-S پنجره‌ای باز می‌کند که صفحه راهنمای خاصی را برای نمایش درخواست می‌کند. می‌توانید هم‌زمان بیش از یک پنجره مرورگر صفحه راهنما را از یک بار اجرای \fIxman\fP نمایش دهید. .PP برای اطلاعات بیشتر در مورد استفاده از \fIxman\fP، لطفاً اطلاعات راهنمای برخط را مطالعه کنید. بیشتر این راهنما به شخصی‌سازی \fIxman\fP خواهد پرداخت. .SH "گزینه‌ها (OPTIONS)" .PP برنامه Xman از تمام آرگومان‌های استاندارد خط فرمان جعبه‌ابزار پشتیبانی می‌کند (نگاه کنید به \fIX\fP(7)). آرگومان‌های تکمیلی زیر نیز پشتیبانی می‌شوند. .sp .IP "\fB\-helpfile\fP \fIfilename\fP" یک فایل راهنما به غیر از فایل پیش‌فرض برای استفاده مشخص می‌کند. .IP \fB\-bothshown\fP امکان نمایش هم‌زمان صفحه راهنما و دایرکتوری راهنما روی صفحه را فراهم می‌کند. .IP \fB\-notopbox\fP برنامه را بدون منوی بالایی (Top Menu) شامل سه دکمه اجرا می‌کند. .IP "\fB\-geometry\fP \fIWxH+X+Y\fP" اندازه و مکان منوی بالایی حاوی سه دکمه را تنظیم می‌کند. .IP "\fB\-pagesize\fP \fIWxH+X+Y\fP" اندازه و مکان تمامی صفحات راهنما را تنظیم می‌کند. .IP "\fB\-help\fP" پیام راهنمای استفاده را چاپ کرده و خارج می‌شود. .IP "\fB\-version\fP" نسخه برنامه را چاپ کرده و خارج می‌شود. .SH "شخصی‌سازی XMAN (CUSTOMIZING XMAN)" .PP .I Xman امکان شخصی‌سازی دایرکتوری‌های مورد جستجو برای صفحات راهنما، و همچنین نامی که هر دایرکتوری در منوی \fISections\fP به آن نگاشت می‌شود را فراهم می‌کند. Xman با خواندن متغیر محیطی \fIMANPATH\fP مشخص می‌کند که چه دایرکتوری‌هایی را جستجو کند. اگر متغیر \fIMANPATH\fP یافت نشود، در سیستم‌های POSIX دایرکتوری /usr/man جستجو می‌شود. این متغیر محیطی باید فهرستی از دایرکتوری‌ها باشد که با دونقطه (:) از هم جدا شده‌اند تا xman آنها را جستجو کند. .sp .nf setenv MANPATH /mit/kit/man:/usr/man .fi .PP به‌طور پیش‌فرض، .I xman هر یک از دایرکتوری‌های زیر را (در هر کدام از دایرکتوری‌های مشخص‌شده در MANPATH کاربر) برای یافتن صفحات راهنما جستجو می‌کند. اگر صفحات راهنمایی در آن دایرکتوری وجود داشته باشند، به فهرست صفحات راهنما برای آیتم منوی متناظر اضافه می‌شوند. یک آیتم منو تنها برای بخش‌هایی نمایش داده می‌شود که واقعاً دارای صفحات راهنما باشند. .TS l l. Directory Section Name - - man1 (1) User Commands man2 (2) System Calls man3 (3) Subroutines man4 (4) Devices man5 (5) File Formats man6 (6) Games man7 (7) Miscellaneous man8 (8) Sys. Administration manl (l) Local mann (n) New mano (o) Old .TE برای نمونه، کاربری سه دایرکتوری در مسیر راهنمای خود دارد و هر یک حاوی دایرکتوری‌ای به نام \fIman3\fP هستند. زمانی که کاربر آیتم منویی با عنوان \fI(3) Subroutines\fP را انتخاب می‌کند، تمامی این صفحات راهنما با مرتب‌سازی الفبایی ظاهر می‌شوند. اگر در هیچ‌کدام از دایرکتوری‌های موجود در MANPATH کاربر دایرکتوری‌ای به نام \fImano\fP وجود نداشته باشد، یا هیچ صفحه راهنمایی در هیچ‌یک از دایرکتوری‌های \fImano\fP نباشد، هیچ آیتم منویی برای بخش \fI(o) Old\fP نمایش داده نخواهد شد. .SH "سیستم‌های BSD و لینوکس (BSD AND LINUX SYSTEMS)" .PP در سیستم‌های جدیدتر BSD و لینوکس، \fIXman\fP به دنبال فایلی به نام \fI/etc/man.conf\fP می‌گردد که حاوی فهرست دایرکتوری‌های شامل صفحات راهنما است. برای شرح کامل قالب این فایل، به \fIman.conf\fP(5) مراجعه کنید. .SH "فایل MANDESC (THE MANDESC FILE)" .PP با استفاده از فایل \fImandesc\fP، کاربر یا مدیر سیستم می‌تواند کنترل دقیق‌تری روی صفحات راهنمایی داشته باشد که در هر یک از بخش‌های نمایش‌یافته توسط آیتم‌های منو در منوی \fISections\fP ظاهر می‌شوند. این قابلیت تنها بر اساس بخش به بخش در دسترس است و صفحات راهنمای انفرادی را نمی‌توان به این شیوه مدیریت کرد. (اگرچه استفاده سخاوتمندانه از پیوندهای نمادین \(em به \fIln\fP(1) مراجعه کنید \(em تقریباً هر پیکربندی قابل تصوری را ممکن می‌سازد.) .PP قالب فایل mandesc شامل یک نویسه است که به دنبال آن یک برچسب می‌آید. نویسه مشخص می‌کند که کدام یک از بخش‌ها زیر این برچسب افزوده خواهند شد. به عنوان مثال، فرض کنید می‌خواهید یک آیتم منوی اضافی ایجاد کنید که شامل تمام زیرروال‌های برنامه‌نویس باشد. این برچسب باید شامل تمام صفحات راهنما در هر دو بخش دو و سه باشد. فایل \fImandesc\fP بدین صورت خواهد بود: .nf 2Programmer Subroutines 3Programmer Subroutines .fi این کار یک آیتم منو به منوی \fISections\fP اضافه می‌کند که فهرستی از تمامی صفحات راهنما در بخش‌های دو و سه Programmers Manual را نمایش می‌دهد. از آنجا که نام‌های برچسب‌ها \fIدقیقاً\fP یکسان هستند، به همان بخش اضافه خواهند شد. با این حال توجه داشته باشید که بخش‌های اصلی همچنان پابرجا خواهند بود. .PP اگر می‌خواهید بخش‌های پیش‌فرض را در یک دایرکتوری راهنما به‌طور کامل نادیده بگیرید، خط زیر را: .nf no default sections .fi در هر کجای فایل mandesc خود اضافه کنید. این کار مانع از جستجوی بخش‌های پیش‌فرض راهنما توسط xman \fIفقط در آن دایرکتوری\fP می‌شود. به عنوان مثال، فرض کنید می‌خواهید همان کار بالا را انجام دهید، اما به نظر شما وجود بخش‌های \fISystem Calls\fP یا \fISubroutines\fP دیگر مفید نیست. باید ورودی‌های پیش‌فرض را تکرار کرده و ورودی جدید خود را نیز اضافه کنید: .nf no default sections 1(1) User Commands 2Programmer Subroutines 3Programmer Subroutines 4(4) Devices 5(5) File Formats 6(6) Games 7(7) Miscellaneous 8(8) Sys. Administration l(l) Local n(n) New o(o) Old .fi برنامه Xman هر بخشی را که به صورت \fIman\fP باشد می‌خواند، که در آن یک حرف بزرگ یا کوچک انگلیسی (به‌طور متمایز در نظر گرفته می‌شوند) یا یک رقم (0-9) است. با این حال هشدار داده می‌شود که man(1) و catman(8) دایرکتوری‌هایی را که غیراستاندارد باشند جستجو نخواهند کرد..SH "ویجت‌ها (WIDGETS)" برای تعیین منابع (resources)، دانستن سلسله‌مراتب ویجت‌هایی که \fIxman\fR را تشکیل می‌دهند مفید است. در نمادگذاری زیر، تورفتگی نشان‌دهندهٔ ساختار سلسله‌مراتبی است. ابتدا نام کلاس ویجت و به دنبال آن نام نمونهٔ (instance) ویجت آمده است. .sp .nf .ft CW Xman xman \fI(این ویجت هرگز استفاده نمی‌شود)\fP TopLevelShell topBox Form form Label topLabel Command helpButton Command quitButton Command manpageButton TransientShell search DialogWidgetClass dialog Label label Text value Command manualPage Command apropos Command cancel TransientShell pleaseStandBy Label label TopLevelShell manualBrowser Paned Manpage_Vpane Paned horizPane MenuButton options MenuButton sections Label manualBrowser Viewport directory List directory List directory . . (یکی برای هر بخش، . که در لحظه ایجاد می‌شود) . ScrollByLine manualPage SimpleMenu optionMenu SmeBSB displayDirectory SmeBSB displayManualPage SmeBSB help SmeBSB search SmeBSB showBothScreens SmeBSB removeThisManpage SmeBSB openNewManpage SmeBSB showVersion SmeBSB quit SimpleMenu sectionMenu SmeBSB <نام بخش> . . (یکی برای هر بخش) . TransientShell search DialogWidgetClass dialog Label label Text value Command manualPage Command apropos Command cancel TransientShell pleaseStandBy Label label TransientShell likeToSave Dialog dialog Label label Text value Command yes Command no TopLevelShell help Paned Manpage_Vpane Paned horizPane MenuButton options MenuButton sections Label manualBrowser ScrollByLine manualPage SimpleMenu optionMenu SmeBSB displayDirectory SmeBSB displayManualPage SmeBSB help SmeBSB search SmeBSB showBothScreens SmeBSB removeThisManpage SmeBSB openNewManpage SmeBSB showVersion SmeBSB quit .ft .fi .SH "منابع برنامه (APPLICATION RESOURCES)" برنامهٔ \fIxman\fP دارای منابع اختصاصی زیر است که امکان سفارشی‌سازی‌های منحصربه‌فرد برای \fIxman\fP را فراهم می‌کنند. .PP .TP 18 \fBmanualFontNormal\fP (کلاس \fBFont\fP) قلم مورد استفاده برای متن عادی در صفحات راهنما. .TP 18 \fBmanualFontBold\fP (کلاس \fBFont\fP) قلم مورد استفاده برای متن پررنگ (bold) در صفحات راهنما. .TP 18 \fBmanualFontItalic\fP (کلاس \fBFont\fP) قلم مورد استفاده برای متن کج (italic) در صفحات راهنما. .TP 18 \fBdirectoryFontNormal\fP (کلاس \fBFont\fP) قلم مورد استفاده برای متن دایرکتوری. .TP 18 \fBbothShown\fP (کلاس \fBBoolean\fP) مقدار `true' یا `false'، مشخص می‌کند که آیا می‌خواهید هر دو بخش دایرکتوری و صفحهٔ راهنما در هنگام راه‌اندازی نمایش داده شوند یا خیر. .TP 18 \fBdirectoryHeight\fP (کلاس \fBDirectoryHeight\fP) ارتفاع دایرکتوری بر حسب پیکسل، هنگامی که دایرکتوری و صفحهٔ راهنما به‌طور هم‌زمان نمایش داده می‌شوند. .TP 18 \fBtopCursor\fP (کلاس \fBCursor\fP) مکان‌نمای مورد استفاده در کادر بالا (top box). .TP 18 \fBhelpCursor\fP (کلاس \fBCursor\fP) مکان‌نمای مورد استفاده در پنجرهٔ راهنما. .TP 18 \fBmanpageCursor\fP (کلاس \fBCursor\fP) مکان‌نمای مورد استفاده در پنجرهٔ صفحهٔ راهنما. .TP 18 \fBsearchEntryCursor\fP (کلاس \fBCursor\fP) مکان‌نمای مورد استفاده در ویجت متنی ورودی جستجو. .TP 18 \fBpointerColor\fP (کلاس \fBForeground\fP) رنگ تمام مکان‌نماها (اشاره‌گرها) که در بالا مشخص شده‌اند. این نام برای سازگاری با xterm انتخاب شده است. .TP 18 \fBhelpFile\fP (کلاس \fBFile\fP) استفاده از این مورد به‌جای فایل راهنمای پیش‌فرض سیستم. .TP 18 \fBtopBox\fP (کلاس \fBBoolean\fP) مقدار `true' یا `false'، تعیین می‌کند که در هنگام راه‌اندازی، کادر بالا (شامل دکمه‌های راهنما، خروج و صفحهٔ راهنما) روی صفحه نمایش داده شود یا یک صفحهٔ راهنما. مقدار پیش‌فرض true است. .TP 18 \fBverticalList\fP (کلاس \fBBoolean\fP) مقدار `true' یا `false'، تعیین می‌کند که فهرست دایرکتوری به‌صورت عمودی سازمان‌دهی شود یا افقی. مقدار پیش‌فرض افقی (false) است..SH "کنش‌های سراسری (GLOBAL ACTIONS)" \fIXman\fP تمام تعاملات کاربر را از طریق کنش‌های سراسری تعریف می‌کند. این امر به کاربر اجازه می‌دهد تا جدول ترجمه (translation table) هر ویجت را تغییر داده و هر رویدادی را به کنش جدید کاربر متصل کند. فهرست کنش‌های پشتیبانی‌شده توسط \fIxman\fP عبارت‌اند از: .TP 1.5i .B GotoPage(\fIpage\fB) هنگامی که در یک پنجرهٔ نمایش صفحه راهنما استفاده شود، به کاربر امکان می‌دهد میان نمایش دایرکتوری و صفحه راهنما جابه‌جا شود. آرگومان \fIpage\fP می‌تواند \fBDirectory\fP یا \fBManualPage\fP باشد. .TP 1.5i .B Quit() این کنش می‌تواند در هر جایی استفاده شود و از xman خارج خواهد شد. .TP 1.5i .B Search(\fItype\fB, \fIaction\fB) تنها هنگامی که در پنجرهٔ بازشوی جستجو استفاده شود مفید است؛ این کنش باعث می‌شود ویجت جستجو نوع جستجوی مشخص‌شده را بر روی رشتهٔ موجود در ویجت مقدارِ پنجرهٔ جستجو انجام دهد. این کنش همچنین پنجرهٔ بازشوی جستجو را می‌بندد. آرگومان \fItype\fP می‌تواند \fBApropos\fP، \fBManpage\fP یا \fBCancel\fP باشد. اگر برای \fIaction\fP مقدار \fBOpen\fP مشخص شده باشد، xman یک صفحه راهنمای جدید برای نمایش نتایج جستجو باز خواهد کرد، در غیر این صورت xman تلاش می‌کند نتایج را در والدِ پنجرهٔ بازشوی جستجو نمایش دهد. .TP 1.5i .B PopupHelp() این کنش می‌تواند در هر جایی استفاده شود و ویجت راهنما را به صورت بازشو نمایش می‌دهد. .TP 1.5i .B PopupSearch() این کنش می‌تواند در هر جایی به‌جز پنجرهٔ راهنما استفاده شود. این کنش باعث می‌شود پنجرهٔ بازشوی جستجو بر روی صفحه فعال و نمایان شود و به کاربر امکان جستجوی یک صفحه راهنما را می‌دهد. .TP 1.5i .B CreateNewManpage() این کنش می‌تواند در هر جایی استفاده شود و یک پنجرهٔ نمایش صفحه راهنمای جدید ایجاد می‌کند. .TP 1.5i .B RemoveThisManpage() این کنش می‌تواند در هر پنجرهٔ نمایش صفحه راهنما یا پنجرهٔ راهنما استفاده شود. هنگام فراخوانی، پنجره را حذف کرده و تمام منابع مرتبط با آن را پاک‌سازی می‌کند. .TP 1.5i .B SaveFormattedPage(\fIaction\fP) این کنش تنها می‌تواند در ویجت بازشوی \fBlikeToSave\fP استفاده شود و به xman اعلام می‌کند که ذخیره‌سازی صفحه راهنمای تازه قالب‌بندی‌شده را \fBSave\fP (ذخیره) یا \fBCancel\fP (لغو) کند. .TP 1.5i .B ShowVersion() این کنش می‌تواند از هر پنجرهٔ نمایش صفحه راهنما یا پنجرهٔ راهنما فراخوانی شود و باعث می‌شود خط نمایش اطلاعات، نسخهٔ کنونی xman را نشان دهد. .SH "فایل‌ها (FILES)" .IP "\fI\fP/man<\fIcharacter\fP>" 2.5i .IP "\fI\fP/cat<\fIcharacter\fP>" .IP "\fI\fP/mandesc" .IP /usr/share/X11/app-defaults/Xman منابع مورد نیاز را مشخص می‌کند. .IP /tmp برنامهٔ .I Xman فایل‌های موقت را در /tmp برای تمام صفحات راهنمای قالب‌بندی‌نشده و تمام جستجوهای apropos ایجاد می‌کند. .SH "همچنین ببینید (SEE ALSO)" .IR X (7), .IR man (1), .IR apropos (1), .IR catman (8), .I "Athena Widget Set" .SH "محیط (ENVIRONMENT)" .TP 1.5i .B DISPLAY میزبان و نمایشگر پیش‌فرض برای استفاده. .TP 1.5i .B MANPATH مسیر جستجو برای صفحات راهنما. دایرکتوری‌ها با دو‌نقطه از یکدیگر جدا می‌شوند (مانند /usr/man:/mit/kit/man:/foo/bar/man). .TP 1.5i .B XENVIRONMENT برای دریافت نام فایل منبعی که منابع سراسری ذخیره‌شده در ویژگی RESOURCE_MANAGER را بازنویسی می‌کند. .TP 1.5i .B XAPPLRESDIR رشته‌ای که «Xman» به انتهای آن افزوده خواهد شد. این رشته مسیر کامل فایل app-defaults کاربر خواهد بود تا پس از فایل app-defaults سیستم و پیش از منابع متصل به نمایشگر، در پایگاه‌داده منابع ادغام شود. .SH "نویسندگان (AUTHORS)" کریس پیترسون (Chris Peterson)، کنسرسیوم MIT X بر اساس نسخهٔ V10 نوشته‌شده توسط بری شین (Barry Shein) سابقاً از دانشگاه بوستون. رفع باگ‌ها و پشتیبانی از لینوکس توسط کارلوس ای. ام. دوس سانتوس (Carlos A M dos Santos)، برای پروژهٔ The XFree86 Project.