توثيق6.1.1. الصفحات اليدوية
تحتوي الصفحات اليدوية، على الرغم من أسلوبها المقتضب نسبيًا، على قدر كبير من المعلومات الأساسية. لعرض صفحة دليل، اكتب ببساطة رجل دليل الصفحة. تتزامن صفحة الدليل عادةً مع اسم الأمر. على سبيل المثال، للتعرف على الخيارات الممكنة لـ cp الأمر، سوف تكتب رجل cp في موجه الأوامر.
لا تقوم صفحات الدليل بتوثيق البرامج التي يمكن الوصول إليها من سطر الأوامر فحسب، بل أيضًا ملفات التكوين واستدعاءات النظام ووظائف مكتبة C وما إلى ذلك. في بعض الأحيان يمكن أن تتعارض الأسماء. على سبيل المثال،
القشرة اقرأ الأمر له نفس اسم اقرأ مكالمة النظام. ولهذا السبب تم تنظيم الصفحات اليدوية في الأقسام المرقمة التالية:
1. الأوامر التي يمكن تنفيذها من سطر الأوامر
2. استدعاءات النظام (الوظائف التي توفرها النواة)
3. وظائف المكتبة (التي تقدمها مكتبات النظام)
4. الأجهزة (في الأنظمة المشابهة لنظام Unix، تكون هذه ملفات خاصة، وعادةً ما يتم وضعها في ملف / ديف / الدليل)
5. ملفات التكوين (التنسيقات والاصطلاحات)
6. الألعاب
7. مجموعات من وحدات الماكرو والمعايير
8. أوامر إدارة النظام
9. إجراءات النواة
يمكنك تحديد قسم صفحة الدليل الذي تبحث عنه: لعرض الوثائق الخاصة بـ اقرأ استدعاء النظام، سوف تكتب رجل 2 قراءة. عندما لا يتم تحديد أي قسم بشكل صريح، سيتم عرض القسم الأول الذي يحتوي على صفحة دليل بالاسم المطلوب. هكذا، ظل الرجل عائدات الظل(5) لأنه لا توجد صفحات دليل ل ظل في الأقسام 1-4.
بالطبع، إذا كنت لا تعرف أسماء الأوامر، فلن يكون الدليل مفيدًا لك كثيرًا. دخول سديد الأمر، الذي يبحث في الصفحات اليدوية (أو بشكل أكثر تحديدًا أوصافها المختصرة) عن أي كلمات رئيسية تقدمها. ال سديد يقوم الأمر بعد ذلك بإرجاع قائمة بالصفحات اليدوية التي يشير ملخصها إلى الكلمات الأساسية المطلوبة بالإضافة إلى ملخص مكون من سطر واحد من صفحة الدليل. إذا اخترت كلماتك الرئيسية جيدًا، فستجد اسم الأمر الذي تحتاجه.
مثال 6.1 العثور على cp مع سديد
$ بخصوص "نسخ الملف"
cp (1) - نسخ الملفات والدلائل
cpio (1) - نسخ الملفات من وإلى الأرشيف
gvfs-copy (1) - نسخ الملفات
gvfs-move (1) - نسخ الملفات
hcopy (1) - نسخ الملفات من أو إلى تثبيت وحدة تخزين HFS (1) - نسخ الملفات وتعيين السمات ntfscp (8) - نسخ الملف إلى وحدة تخزين NTFS.
$ بخصوص "نسخ الملف"
cp (1) - نسخ الملفات والدلائل
cpio (1) - نسخ الملفات من وإلى الأرشيف
gvfs-copy (1) - نسخ الملفات
gvfs-move (1) - نسخ الملفات
hcopy (1) - نسخ الملفات من أو إلى تثبيت وحدة تخزين HFS (1) - نسخ الملفات وتعيين السمات ntfscp (8) - نسخ الملف إلى وحدة تخزين NTFS.
توثيق التصفح تحتوي العديد من صفحات الدليل على قسم "انظر أيضًا"، والذي يكون عادةً بالقرب من نهاية المستند. عن طريق الروابط التالية والتي تشير إلى صفحات دليل أخرى ذات صلة بأوامر مماثلة، أو بالوثائق الخارجية. يمكنك استخدام هذا القسم للعثور على الوثائق ذات الصلة حتى عندما يكون
الخيار الأول ليس الأمثل
توثيق التصفح تحتوي العديد من صفحات الدليل على قسم "انظر أيضًا"، والذي يكون عادةً بالقرب من نهاية المستند. عن طريق الروابط التالية والتي تشير إلى صفحات دليل أخرى ذات صلة بأوامر مماثلة، أو بالوثائق الخارجية. يمكنك استخدام هذا القسم للعثور على الوثائق ذات الصلة حتى عندما يكون
الخيار الأول ليس الأمثل
بالإضافة إلى رجل، يمكنك استخدام كونكرور (في كيدي) و عواء (في جنوم) للبحث في صفحات الدليل أيضًا.