man manual-page
— وعادة ما يكون اسم صفحة الدليل نفس اسم الأمر الذي تبحث عن وثائقه. مثلاً، للتعرف على الخيارات المتوفرة للأمر cp
، سنتكتب الأمر man cp
في مفسر الأوامر (انظر الملاحظة الجانبية أساسيات الصدَفَة، مفسر سطر الأوامر).
read
له نفس اسم نداء النظام read
. ولهذا تُنَظَّم صفحات الدليل في أقسام مرقَّمة:
/dev/
)؛
read
، سوف نكتب man 2 read
. عند عدم تحديد أي قسم صراحة، سيُعرَض أول قسم يحوي صفحة للاسم المطلوب. بالتالي، الأمر man shadow
يعرض shadow(5) لعدم وجود صفحات للاسم shadow في الأقسام من 1 إلى 4.
apropos
، الذي يساعدك في البحث في صفحات الدليل، أو بالأحرى في أوصافها المختصرة؛ إذ تبدأ كل صفحة دليل أساساً بملخص من سطر واحد. يعيد الأمر apropos
قائمة بصفحات الدليل التي تذكر الكلمات المفتاحية المطلوبة في ملخصها، فإذا كان اختيارك لهذه الكلمات موفقاً، ستجد اسم الأمر الذي تريد.
مثال 7.1. العثور على cp
باستخدام apropos
$
apropos "copy file"
cp (1) - copy files and directories cpio (1) - copy files to and from archives gvfs-copy (1) - Copy files gvfs-move (1) - Copy files hcopy (1) - copy files from or to an HFS volume install (1) - copy files and set attributes ntfscp (8) - copy file to an NTFS volume.
man
الوسيلة الوحيدة لقراءة صفحات الدليل،حيث يقدم برنامج konqueror
(في KDE) وبرنامج yelp
(في GNOME) هذه الميزة أيضًا. كما توجد واجهة وب أيضًا، تقدمها الحزمة man2html
، التي تسمح لك باستعراض صفحات الدليل في متصفح وب. إذا كانت الحزمة مثبتة على الحاسوب، افتح العنوان التالي للوصول إلى هذه الواجهة:
info
) أعقد قليلاً. من الاختيارات الجيدة أن تستخدم pinfo
بدلاً منه (من الحزمة pinfo).
pinfo
بدون متغيرات، فسوف يعرض قائمة بالعقد المتوفرة في المستوى الأول. عادة ما تحمل العقد اسم الأوامر المرتبطة بها.
pinfo
سهل عبر مفاتيح الأسهم. أو يمكنك أيضاً استخدام متصفح رسومي، فهو أسهل استخداماً بكثير. مرة أخرى نقول، إن konqueror
وyelp
مناسبان؛ وهناك أيضاً info2www
الذي يوفر واجهة وب.
man
. بالتالي فإن وثائق info تُكتَب بالإنكليزية دائماً تقريباً. وبالرغم من هذا، عندما تطلب من برنامج pinfo
عرض صفحة info غير موجودة، سوف يلجأ إلى صفحة man ذات الاسم نفسه (في حال وجودها)، والتي قد تكون مترجمة.
README
يحوي بعض المعلومات المفيدة وأحياناً المهمة. يُثَبَّتُ التوثيق في المجلد /usr/share/doc/package/
(حيث يمثل package اسم الحزمة). إذا كان التوثيق كبيراً على وجه الخصوص، فقد لا يرفق ضمن حزمة البرنامج الرئيسة، بل يمكن أن ينقل إلى حزمة مخصصة تُسمَّى عادة package-doc
. ”توصي“ (recommend) الحزمة الرئيسة عموماً بثبيت حزمة التوثيق حتى تستطيع العثور عليها بسهولة.
/usr/share/doc/package/
وهي تكمل التوثيق من خلال وصف خصوصيات الحزمة أو تحسيناتها مقارنة بالنسخة التقليدية من البرمجية. حيث يبين الملف README.Debian
جميع التغييرات التي أُجريَت في سبيل التوافق مع سياسة دبيان. ويسمح الملف changelog.Debian.gz
للمستخدم بتتبع التعديلات التي أجريت على الحزمة عبر الزمن: هذا الملف مفيد جداً عند محاولة فهم ما تَغيَّر بين نسختين مثبتتين من البرنامج ليس لهما السلوك نفسه. أخيراً، يوجد أحياناً ملف NEWS.Debian.gz
الذي يوثّق التغيُّرات الكبيرة في البرنامج والتي قد تُهـِمُّ مدير النظام بشكل مباشر.
debian
لتحديد النتائج واستهداف المعلومات المطلوبة.
Homepage
في البيانات الفوقية (meta-information) الخاصة بالحزمة (apt-cache show package
). أو قد يحتوي وصف الحزمة على رابط لموقع البرنامج الرسمي. إذا لم تجد أي عنوان، انظر في /usr/share/doc/package/copyright
. عادة ما يبين مشرف حزمة دبيان في هذا الملف المكان الذي حصل منه على شفرة البرنامج المصدرية، ويحتمل أن يكون هذا الموقع هو الذي تحتاج إليه. إذا لم تثمر أبحاثك حتى الآن، استشر فهرساً للبرمجيات الحرة، مثل دليل البرمجيات الحرة الذي تنشره FSF، أو ابحث مباشرة في محرك بحث عام، مثل Google أو DuckDuckGo أو Yahoo، الخ.