صفحه راهنما

صفحه راهنما  ابزار مستندساز آنلاینی است که برای موجودیتی که عموماً سیستم‌عامل یونیکس یا شبه‌یونیکس می‌باشد وجود دارد. چنین موجودیت‌هایی شامل برنامه‌های کامپیوتری (کتابخانه‌ها فراخوان‌های سیستمی)، استانداردهای رسمی، اصطلاحات و قراردادها و حتی مفاهیم انتزاعی می‌باشند. کاربر می‌تواند با فراخوان دستور راهنما  صفحه راهنما را احضار کند.

کاربرد 

کاربر برای مطالعه صفحه راهنمای یک دستور در سیستم‌عامل یونیکس خواهد داشت:

man <command_name>

برای سهولت در پیمایش خروجی، دستور راهنما عموماً از ابزار دیگری به نام less استفاده می‌کند.

تاریخچه

بخش‌های راهنما 

راهنما به طور کلی به هشت بخش شماره‌گذاری شده تقسیم می‌شود، سازماندهی شده به صورت زیر (روی بی‌اس‌دی، یونیکس و لینوکس):

سامانه وی یونیکس با یک چینش متفاوت، از یک طرح مشابه شماره گذاری استفاده می‌کند:

بعضی از بخش‌های زیر در بعضی از سیستم‌ها موجود هستند:

برخی از نسخه‌های man نسخه‌های قالب بندی شده ای را که از همه بیشتر مشاهده شده‌اند، را ذخیره می‌کنند.

برای دیدن گزینه‌های بیشتر man , وارد کنید فرمان man man.

طرح 
تمام صفحات راهنما به دنبال یک طرح معمول که بهینه‌سازی شده برای ارائه روی یک صفحه نمایش متن اسکی ساده، که احتمالاً بدون هیچ گونه برجستگی یا کنترل فونت است هستند. بخش‌های حاضر شامل موارد زیر است:

 نام نام دستور یا تابع، و پس از آن توضیحاتی یک خطی از عملکرد دستور.
 خلاصه در مورد یک دستور، شما یک توصیف رسمی از چگونگی اجرا آن و چه گزینه‌های خط فرمانی را می‌گیرد، می‌بینید. برای توابع برنامه، فهرستی از پارامترها که هدر فایل شامل تعریف آن است. برای کاربران با تجربه، ممکن تمام مستنداتی باشد که آنها نیاز دارند.
 توضیحات شرح متنی عملکرد تابع یا دستور.
 نمونه‌ها بعضی از نمونه‌های کاربردی رایج.
 مشابه‌ها یک فهرست از دستورات یا توابع مرتبط.

سایر بخش‌ها ممکن است وجود داشته باشد، اما این‌ها استاندارد شده در سراسر صفحات راهنما نباشد. مثالهای متداول عبارتند از: گزینه‌ها، وضعیت خروج، محیط، اشکالات شناخته شده، فایل‌ها، نویسنده، گزارش اشکالات، تاریخچه و کپی رایت.

نوشتن صفحات راهنما

تبدیل صفحات راهنما

جستارهای وابسته 
 فهرست ابزارهای یونیکس

پیوند به بیرون 
 Unix Programmer's Manual of November 3, 1971 (همچنین ببینید original scans in PS and PDF format).
 History of UNIX Manpages متن اصلی تاریخچه صفحات راهنما یونیکس.
 Online man pages برای خیلی از نسخه‌های یونیکس، لینوکس، مکینتاش Darwin و سیستم عامل‌های مشابه.
 man: یک پیاده‌سازی متن‌باز؛ مورد استفاده در ردهت، فدورا، جنتو، اسلکور، مک اواس-ایکس و برخی دیگر.
 man-db: پیاده‌سازی جایگزین راهنما؛ مورد استفاده در دبیان/اوبونتو، سوزه و برخی دیگر.
 Practical UNIX Manuals: mdoc: راهنما برای نوشتن mdoc صفحات راهنما یونیکس.
 (man 1): قالب و صفحه نمایش برخط صفحات راهنما
 ManDrake: ویرایشگر متن‌باز صفحه راهنما برای مک‌اواس‌ایکس

منابع 
 ویکی‌پدیا انگلیسی

ابزارهای اس یو اس ۲۰۰۸ یونیکس
ارتباطات فنی
پلان ۹ از آزمایشگاه‌های بل
راهنمای آنلاین
یونیکس