man manual-page
— the manual page usually goes by the same name as the command whose documentation is sought. For example, to learn about the possible options for the cp
command, you would type the man cp
command at the shell prompt (see sidebar أساسيات الصدَفَة، مفسر سطر الأوامر).
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
) is also slightly more complex. You would be well advised to use pinfo
instead (from the pinfo package).
pinfo
without parameters, it will display a list of the nodes available at the first level. Usually, nodes bear the name of the corresponding commands.
pinfo
navigating between these nodes is easy to achieve with the arrow keys. Alternatively, you could also use a graphical browser, which is a lot more user-friendly. Again, konqueror
and yelp
work; the info2www
also provides a web interface.
man
page system. info documents are thus almost always in English. However, when you ask the pinfo
program to display a non-existing info page, it will fall back on the man page by the same name (if it exists), which might be translated.
README
يحوي بعض المعلومات المفيدة وأحياناً المهمة. يُثَبَّتُ التوثيق في المجلد /usr/share/doc/package/
(حيث يمثل package اسم الحزمة). إذا كان التوثيق كبيراً على وجه الخصوص، فقد لا يرفق ضمن حزمة البرنامج الرئيسة، بل يمكن أن ينقل إلى حزمة مخصصة تُسمَّى عادة package-doc
. ”توصي“ (recommend) الحزمة الرئيسة عموماً بثبيت حزمة التوثيق حتى تستطيع العثور عليها بسهولة.
/usr/share/doc/package/
وهي تكمل التوثيق من خلال وصف خصوصيات الحزمة أو تحسيناتها مقارنة بالنسخة التقليدية من البرمجية. حيث يبين الملف README.Debian
جميع التغييرات التي أُجريَت في سبيل التوافق مع سياسة دبيان. ويسمح الملف changelog.Debian.gz
للمستخدم بتتبع التعديلات التي أجريت على الحزمة عبر الزمن: هذا الملف مفيد جداً عند محاولة فهم ما تَغيَّر بين نسختين مثبتتين من البرنامج ليس لهما السلوك نفسه. أخيراً، يوجد أحياناً ملف NEWS.Debian.gz
الذي يوثّق التغيُّرات الكبيرة في البرنامج والتي قد تُهـِمُّ مدير النظام بشكل مباشر.
debian
to limit results and target relevant information.
Homepage
field in the package's meta-information (apt-cache show package
). Alternately, the package description may contain a link to the program's official website. If no URL is indicated, look at /usr/share/doc/package/copyright
. The Debian maintainer generally indicates in this file where they got the program's source code, and this is likely to be the website that you need to find. If at this stage your search is still unfruitful, consult a free software directory, such as FSF's Free Software Directory, or search directly with a search engine, such as Google, DuckDuckGo, Yahoo, etc.