मैन पेज

एक मैन पेज (मैन्युअल पेज के लिए संक्षिप्त) सॉफ्टवेयर प्रलेखन का एक रूप है जो आमतौर पर यूनिक्स या यूनिक्स जैसी ऑपरेटिंग सिस्टम पर पाया जाता है। कवर किए गए विषयों में कंप्यूटर प्रोग्राम ( पुस्तकालय (कम्प्यूटिंग) और सिस्टम कॉल सहित), औपचारिक मानक और परंपराएं और यहां तक ​​कि अमूर्त अवधारणाएं भी शामिल हैं। एक उपयोगकर्ता (कंप्यूटिंग) जारी करके एक मैन पेज का आह्वान कर सकता है   कमांड (कंप्यूटिंग)।

डिफ़ॉल्ट रूप से,  आमतौर पर एक टर्मिनल पेजर प्रोग्राम का उपयोग करता है जैसे   या   इसका आउटपुट प्रदर्शित करने के लिए।

मैन पेजों को अक्सर सॉफ्टवेयर दस्तावेज़ों के ऑन-लाइन या ऑनलाइन रूप के रूप में संदर्भित किया जाता है, यहां तक ​​कि भले ही  कमांड के लिए इंटरनेट एक्सेस की आवश्यकता नहीं होती है, उस समय से जब मुद्रित आउट-ऑफ-बैंड मैनुअल आदर्श थे।

इतिहास
यूनिक्स के इतिहास के पहले दो वर्षों में कोई दस्तावेज मौजूद नहीं था। यूनिक्स प्रोग्रामर मैनुअल पहली बार 3 नवंबर, 1971 को प्रकाशित हुआ था। डेनिस रिची और केन थॉम्पसन के आग्रह पर पहले वास्तविक मैन पेज लिखे गए थे।{{fact|date=February 2020}1971 में उनके प्रबंधक डगलस मेक्लोरी के }। मैन पेजों के अलावा, प्रोग्रामर के मैनुअल ने छोटे कागजात का एक सेट भी संचित किया, उनमें से कुछ ट्यूटोरियल (जैसे सामान्य यूनिक्स उपयोग के लिए, सी (प्रोग्रामिंग भाषा)  प्रोग्रामिंग लैंग्वेज, और टूल जैसे कि Yacc), और अन्य ऑपरेटिंग सिस्टम सुविधाओं का अधिक विस्तृत विवरण। मैनुअल का मुद्रित संस्करण शुरू में एक एकल बाइंडर में फिट होता है, लेकिन पीडब्ल्यूबी/यूनिक्स और  अनुसंधान यूनिक्स  के संस्करण 7 यूनिक्स के रूप में, इसे वॉल्यूम 1 बनाने वाले मुद्रित मैन पेजों के साथ दो खंडों में विभाजित किया गया था। प्रलेखन के बाद के संस्करणों ने पहले मैन पेजों की संक्षिप्तता की नकल की। रिची ने संस्करण 3 यूनिक्स परिचय के लिए कैसे शुरू करें अनुभाग जोड़ा, और लोरिंडा चेरी ने संस्करण 6 यूनिक्स और संस्करण 7 यूनिक्स संस्करणों के लिए पर्पल कार्ड पॉकेट संदर्भ प्रदान किया। सॉफ़्टवेयर के संस्करण मैनुअल के संशोधन के बाद नामित किए गए थे; यूनिक्स प्रोग्रामर मैनुअल का सातवां संस्करण, उदाहरण के लिए, यूनिक्स के 7वें संस्करण या संस्करण 7 के साथ आया था।

संस्करण 4 यूनिक्स संस्करण के लिए मैन पेज ट्राफ टाइपसेटिंग पैकेज का उपयोग करके स्वरूपित किए गए थे और इसका सेट   मैक्रोज़ (जो मैनुअल के छठे और सातवें संस्करणों के बीच पूरी तरह से संशोधित किए गए थे, लेकिन तब से बहुत ज्यादा नहीं बदला है)। उस समय, मैन्युअल पेज सिस्टम के माध्यम से ऑनलाइन दस्तावेज़ीकरण की उपलब्धता को एक बड़ी प्रगति माना जाता था। आज तक, लगभग हर यूनिक्स कमांड लाइन एप्लिकेशन एक मैन पेज के साथ आता है और कई यूनिक्स उपयोगकर्ता प्रोग्राम में मैन पेजों की कमी को निम्न गुणवत्ता के संकेत के रूप में देखते हैं; वास्तव में, कुछ परियोजनाएं, जैसे कि डेबियन, एक की कमी वाले कार्यक्रमों के लिए मैन पेज लिखने के लिए अपने रास्ते से बाहर जाती हैं। बर्कले सॉफ्टवेयर डिस्ट्रीब्यूशन के आधुनिक वंशज | 4.4BSD भी मैन पेजों को सिस्टम प्रलेखन के प्राथमिक रूपों में से एक के रूप में वितरित करते हैं (पुराने   नए के साथ मैक्रोज़  ).

मैन कमांड के मैन-डीबी संस्करण में एक छिपा हुआ ईस्टर अंडे (मीडिया)  था जो 00:30 पर चलने पर कमांड को गिम्मे गिम्मे गिम्मे वापस करने का कारण बनता था (एबीबीए गीत गिम्मे! गिम्मे! गिम्मे का एक संदर्भ! (ए) मैन आफ्टर मिडनाइट)। इसे 2011 में पेश किया गया था लेकिन पहले प्रतिबंधित और फिर 2017 में हटा दिया गया आखिरकार मिल जाने के बाद।

स्वरूपण
मैन पेजों का डिफ़ॉल्ट प्रारूप ट्रॉफ है, या तो ट्रॉफ मैक्रोज़ मैन (उपस्थिति उन्मुख) या एमडीओसी (सिमेंटिक ओरिएंटेड) के साथ। इससे मैन पेज को परिशिष्ट भाग, पोर्टेबल दस्तावेज़ प्रारूप, और देखने या प्रिंट करने के लिए कई अन्य प्रारूपों में टाइप करना संभव हो जाता है।

कुछ यूनिक्स प्रणालियों के लिए एक पैकेज होता है कमांड, जो उपयोगकर्ताओं को HTML ब्राउज़र का उपयोग करके अपने मैन पेजों को ब्राउज़ करने में सक्षम बनाता है। ग्रॉफ और मैन-डीबी वाले सिस्टम को उच्च गुणवत्ता वाले मूल HTML आउटपुट का उपयोग करना चाहिए  बजाय।

GNU Emacs प्रोग्राम WoMan (विदआउट मैन से) संपादक से मैन पेज ब्राउज़ करने की अनुमति देता है।

2010 में, ओपनबीएसडी ने पोस्टस्क्रिप्ट, एचटीएमएल, एक्सएचटीएमएल, और टर्मिनल में आउटपुट के लिए मूल समर्थन के साथ मैन पेजों के लिए एक विशेष कंपाइलर/फॉर्मेटर मैनडॉक के पक्ष में मैन पेजों को प्रारूपित करने के लिए ट्रॉफ को हटा दिया। यह केवल मैनुअल पेजों में उपयोग किए जाने वाले ट्रॉफ के एक सबसेट का समर्थन करने के लिए है, विशेष रूप से mdoc मैक्रोज़ का उपयोग करने वालों के लिए।

ऑनलाइन सेवाएं
बहुत सी वेबसाइटें विभिन्न यूनिक्स जैसी प्रणालियों से मैन्युअल पृष्ठों तक ऑनलाइन पहुंच प्रदान करती हैं।

फरवरी 2013 में, बीएसडी समुदाय ने एक नया खुला स्रोत mdoc.su सेवा शुरू की, जो एक अद्वितीय nginx- के माध्यम से प्रमुख आधुनिक बीएसडी परियोजनाओं की man.cgi स्क्रिप्ट तक पहुंच को एकीकृत और छोटा करता है। *BSD मैन पेजों के लिए नियतात्मक URL छोटा करना सेवा आधारित।

लिनक्स के लिए, एक man7.org सेवा को सिस्टम के लिए विशिष्ट मैनुअल प्रदान करने के लिए स्थापित किया गया है। ManKier सेवा व्यापक चयन प्रदान करती है, और TLDR पृष्ठों को भी एकीकृत करती है।

कमांड उपयोग
यूनिक्स कमांड के लिए मैन्युअल पेज पढ़ने के लिए, उपयोगकर्ता टाइप कर सकता है: पृष्ठों को परंपरागत रूप से नोटेशन नाम (अनुभाग) का उपयोग करने के लिए संदर्भित किया जाता है: उदाहरण के लिए,. यह खंड अलग-अलग तरीकों से संदर्भित करता है कि विषय को संदर्भित किया जा सकता है - उदाहरण के लिए, सिस्टम कॉल के रूप में, या शेल (कमांड लाइन) कमांड या पैकेज, या पैकेज की कॉन्फ़िगरेशन फ़ाइल, या कोडिंग निर्माण / हेडर के रूप में।

मैन्युअल के एक से अधिक अनुभागों में एक ही पृष्ठ का नाम दिखाई दे सकता है, जैसे कि जब सिस्टम कॉल, उपयोगकर्ता कमांड (कंप्यूटिंग) या ट्रॉफ मैक्रो के नाम मिलते हैं। उदाहरण हैं और, या  और. गैर-डिफ़ॉल्ट मैनुअल सेक्शन तक पहुँचने के लिए सिंटैक्स अलग-अलग मैन कार्यान्वयन के बीच भिन्न होता है।

सोलारिस और इलुमोस पर, उदाहरण के लिए, पढ़ने के लिए सिंटैक्स है: लिनक्स और बीएसडी डेरिवेटिव पर समान मंगलाचरण होगा: जो मैन पेज के सेक्शन 3 में printf  की खोज करता है।

मैनुअल सेक्शन
मैनुअल को आम तौर पर आठ क्रमांकित वर्गों में विभाजित किया जाता है, जो निम्नानुसार व्यवस्थित होता है (अनुसंधान यूनिक्स, बीएसडी, मैकोज़। लिनक्स, और ओरेकल सोलारिस 11.4 पर): POSIX API दोनों सेक्शन 2 और 3 में मौजूद हैं, जहाँ सेक्शन 2 में वे API शामिल हैं जिन्हें सिस्टम कॉल के रूप में लागू किया गया है और सेक्शन 3 में वे API शामिल हैं जिन्हें लाइब्रेरी रूटीन के रूप में लागू किया गया है।

यूनिक्स सिस्टम वी एक अलग क्रम को छोड़कर एक समान नंबरिंग योजना का उपयोग करता है: कुछ प्रणालियों पर निम्नलिखित में से कुछ खंड उपलब्ध हैं: कुछ खंडों को प्रत्यय के माध्यम से और उप-विभाजित किया गया है; उदाहरण के लिए, कुछ प्रणालियों में, धारा 3C C लाइब्रेरी कॉल के लिए है, 3M गणित लाइब्रेरी के लिए है, और इसी तरह। इसका एक परिणाम यह है कि धारा 8 (सिस्टम एडमिनिस्ट्रेशन कमांड्स) को कभी-कभी मुख्य कमांड्स सेक्शन के 1M उपखंड में स्थानांतरित कर दिया जाता है। कुछ उपखंड प्रत्यय का वर्गों में सामान्य अर्थ होता है: (धारा 3 अलग-अलग भाषाओं के कई प्रत्ययों के साथ अपवाद है।)

के कुछ संस्करण  देखे गए पिछले कई पृष्ठों के स्वरूपित संस्करणों को कैश करें। एक फॉर्म कैट पेज है, जिसे केवल डिस्प्ले के लिए पेजर पर पाइप किया जाता है।

लेआउट
सभी मैन पेज एक सामान्य लेआउट का अनुसरण करते हैं जो एक साधारण ASCII पाठ प्रदर्शन पर प्रस्तुति के लिए अनुकूलित है, संभवतः बिना किसी प्रकार के हाइलाइटिंग या फ़ॉन्ट नियंत्रण के। मौजूद वर्गों में शामिल हो सकते हैं:
 * NAME: कमांड या फ़ंक्शन का नाम, उसके बाद यह क्या करता है इसका एक-पंक्ति विवरण।
 * SYNOPSIS: एक कमांड के मामले में, इसे कैसे चलाना है और इसके लिए कौन से कमांड लाइन विकल्प लगते हैं, इसका एक औपचारिक विवरण। प्रोग्राम फ़ंक्शंस के लिए, फ़ंक्शन द्वारा लिए जाने वाले पैरामीटर की एक सूची और किस हेडर फ़ाइल में इसकी घोषणा होती है।
 * विवरण: कमांड या फ़ंक्शन के कामकाज का एक पाठ्य विवरण।
 * उदाहरण: सामान्य उपयोग के कुछ उदाहरण।
 * यह भी देखें: संबंधित कमांड या कार्यों की एक सूची।

अन्य खंड मौजूद हो सकते हैं, लेकिन ये मैन पेजों पर अच्छी तरह से मानकीकृत नहीं हैं। सामान्य उदाहरणों में शामिल हैं: विकल्प, निकास स्थिति, वापसी मूल्य, पर्यावरण, बग, फ़ाइलें, लेखक, रिपोर्टिंग बग, इतिहास और कॉपीराइट।

संलेखन
मैनुअल पेज या तो पुराने में लिखे जा सकते हैं man मैक्रोज़, नया doc मैक्रोज़, या दोनों का संयोजन (mandoc). {{code|man}an}} मैक्रो सेट शीर्षक पंक्ति, सेक्शन हेडर, (बोल्ड, छोटे या इटैलिक) फोंट, पैराग्राफ और इंडेंटेशन को जोड़ने/घटाने के निर्देशों के साथ न्यूनतम रिच पाठ  फ़ंक्शंस प्रदान करता है। नया mdoc भाषा प्रकृति में अधिक सिमेंटिक है, और अधिकांश मानक वर्गों जैसे प्रोग्राम नाम, सारांश, फ़ंक्शन नाम और लेखकों के नाम के लिए विशेष मैक्रो शामिल हैं। इस जानकारी का उपयोग मैनडॉक जैसे कार्यक्रमों द्वारा मैनुअल के लिए सिमेंटिक खोज को लागू करने के लिए किया जा सकता है। हालाँकि इसमें स्टाइल को सीधे नियंत्रित करने के निर्देश भी शामिल हैं, यह उम्मीद की जाती है कि विशेष मैक्रोज़ अधिकांश उपयोग-मामलों को कवर करेंगे। मैंडॉक और ग्रॉफ दोनों परियोजनाओं पर विचार किया जाता है mdoc नए दस्तावेजों के लिए पसंदीदा प्रारूप।

यद्यपि मैन पेज 10-बिंदु रोमन प्रकार का उपयोग करते हुए ट्रॉफ के लिए निर्धारित पाठ हैं, यह अंतर आम तौर पर विवादास्पद है क्योंकि मैन पेज पेपर पर रखे जाने के बजाय टर्मिनल (टीटीवाई) में देखे जाते हैं। नतीजतन, छोटे फ़ॉन्ट मैक्रो का शायद ही कभी उपयोग किया जाता है। दूसरी ओर, बोल्ड और इटैलिक टेक्स्ट टर्मिनल द्वारा ECMA-48 और ग्रॉफ के माध्यम से समर्थित है grotty जब यह एक सहायक टर्मिनल का पता लगाता है तो अनुरोध के अनुसार उन्हें उत्सर्जित करता है। बीएसडी मैनडॉक हालांकि टाइपराइटर बैकस्पेस-फिर-ओवरस्ट्राइक अनुक्रम के माध्यम से केवल बोल्ड और रेखांकित (इटैलिक के प्रतिस्थापन के रूप में) टेक्स्ट का समर्थन करता है, जिसे ईसीएमए-48 में अनुवादित करने की आवश्यकता है less.

कुछ उपकरणों का उपयोग दस्तावेजों को कम विकसित प्रारूप में मैन्युअल पृष्ठों में बदलने के लिए किया गया है। उदाहरणों में जीएनयू शामिल हैं help2man, जो एक लेता है --help आउटपुट और कुछ अतिरिक्त सामग्री एक मैनुअल पेज उत्पन्न करने के लिए। उक्त आउटपुट की तुलना में मैनुअल बमुश्किल अधिक उपयोगी होगा, लेकिन GNU प्रोग्राम के लिए यह कोई समस्या नहीं है क्योंकि texinfo मुख्य प्रलेखन प्रणाली है। pandoc, रोन और एमडी2मैन सहित कई टूल  markdown से मैन्युअल पेजों में रूपांतरण का समर्थन करते हैं। ये सभी उपकरण उत्सर्जित करते हैं man प्रारूप, क्योंकि मार्कडाउन शब्दार्थ सामग्री से मेल खाने के लिए पर्याप्त अभिव्यंजक नहीं है mdoc. मैंडॉक के लेखक के अनुसार, डॉकबुक में एक इनबिल्ट मैन (7) कन्वर्टर है-जो कि खराब गुणवत्ता का है जिन्होंने एक अलग mdoc(7) कन्वर्टर लिखा था।

मैन पेज आमतौर पर अंग्रेजी में लिखे जाते हैं, लेकिन सिस्टम पर अन्य भाषाओं में अनुवाद उपलब्ध हो सकते हैं। जीएनयू man-db और मैंडॉक man को उपनिर्देशिकाओं के अंतर्गत स्थानीयकृत मैन्युअल पृष्ठों की खोज करने के लिए जाना जाता है।

विकल्प
के लिए कुछ विकल्प  जीएनयू प्रोजेक्ट|जीएनयू प्रोजेक्ट के संभावित अपवाद के साथ, बहुत लोकप्रियता का आनंद लिया है प्रणाली, एक प्रारंभिक और सरल हाइपरटेक्स्ट प्रणाली। एक तृतीय-पक्ष प्रयास भी है जिसे TLDR पेज के रूप में जाना जाता है  जो  प्रवंचक पत्रक  के समान सामान्य उपयोग के मामलों के लिए सरल उदाहरण प्रदान करता है। इसके अलावा, कुछ यूनिक्स ग्राफिकल यूज़र इंटरफ़ेस  एप्लिकेशन (विशेष रूप से वे जो सूक्ति और  कहाँ  विकास वातावरण का उपयोग करके बनाए गए हैं) अब एचटीएमएल में एंड-यूजर प्रलेखन प्रदान करते हैं और इसमें एम्बेडेड एचटीएमएल व्यूअर शामिल हैं जैसे   आवेदन के भीतर मदद पढ़ने के लिए। Emacs में एक HTML सिस्टम भी texinfo को बदलने के लिए तैयार है।

यह भी देखें

 * यूनिक्स कमांड की सूची
 * योजना 9 अनुप्रयोगों की सूची
 * पढ़ें
 * आरटीएफएम
 * ManOpen - NeXT/macOS ग्राफिकल मैन यूटिलिटी
 * आरटीएफएम
 * ManOpen - NeXT/macOS ग्राफिकल मैन यूटिलिटी

बाहरी संबंध

 * History of UNIX Manpages for a primary-source history of UNIX man pages.
 * UNIX and Linux Man Page Repository with nearly 300,000 well formatted man pages.
 * What do the numbers in a man page mean?
 * FreeBSD Manual Pages, freebsd.org – has also man pages for Darwin, Debian, HP-UX, IRIS, NetBSD, OpenBSD, NextSTEP, SunOS and more