मैन पेज: Difference between revisions

From Vigyanwiki
No edit summary
No edit summary
Line 1: Line 1:
{{short description|Unix software documentation}}
{{short description|Unix software documentation}}


[[File:Man page on Linux screenshot.png|thumb|मैन पेज चालू है {{tt|man(1)}}, जैसा कि विभिन्न Linux वितरणों में देखा गया है। यह संस्करण man-db.|330x330px से है]]एक '''मैन पेज''' (मैन्युअल पेज के लिए संक्षिप्त) सॉफ्टवेयर प्रलेखन का एक रूप है जो आमतौर पर [[यूनिक्स]] या यूनिक्स जैसी [[ऑपरेटिंग सिस्टम]] पर पाया जाता है। कवर किए गए विषयों में [[कंप्यूटर प्रोग्राम]] ([[ पुस्तकालय (कम्प्यूटिंग) ]] और [[सिस्टम कॉल]] सहित), औपचारिक मानक और परंपराएं और यहां तक ​​कि अमूर्त अवधारणाएं भी शामिल हैं। एक [[उपयोगकर्ता (कंप्यूटिंग)]] जारी करके एक मैन पेज का आह्वान कर सकता है <code>man</code> [[कमांड (कंप्यूटिंग)]]।
[[File:Man page on Linux screenshot.png|thumb|मैन पेज चालू है {{tt|man(1)}}, जैसा कि विभिन्न Linux वितरणों में देखा गया है। यह संस्करण man-db.|330x330px से है]]एक '''मैन पेज''' (मैन्युअल पेज के लिए संक्षिप्त) सॉफ्टवेयर प्रलेखन का एक रूप है जो आमतौर पर [[यूनिक्स]] या यूनिक्स जैसी [[ऑपरेटिंग सिस्टम]] पर पाया जाता है। कवर किए गए विषयों में [[कंप्यूटर प्रोग्राम]] ([[ पुस्तकालय (कम्प्यूटिंग) ]] और [[सिस्टम कॉल]] सहित), औपचारिक मानक और परंपराएं और यहां तक ​​कि अमूर्त अवधारणाएं भी सम्मिलित हैं। एक [[उपयोगकर्ता (कंप्यूटिंग)]] जारी करके एक मैन पेज का आह्वान कर सकता है <code>man</code> [[कमांड (कंप्यूटिंग)]]।


डिफ़ॉल्ट रूप से, <code>man</code> आमतौर पर एक [[टर्मिनल पेजर]] प्रोग्राम का उपयोग करता है जैसे <code>[[more (command)|more]]</code> या <code>[[less (Unix)|less]]</code> इसका आउटपुट प्रदर्शित करने के लिए।
डिफ़ॉल्ट रूप से, <code>man</code> आमतौर पर एक [[टर्मिनल पेजर]] प्रोग्राम का उपयोग करता है जैसे <code>[[more (command)|more]]</code> या <code>[[less (Unix)|less]]</code> इसका आउटपुट प्रदर्शित करने के लिए।
Line 9: Line 9:


== इतिहास ==
== इतिहास ==
[[File:Screenshot of "Xman" program.png|thumb|xman, मैन्युअल पृष्ठों को देखने के लिए एक प्रारंभिक [[X11]] अनुप्रयोग]]
[[File:Screenshot of "Xman" program.png|thumb|एक्स मैन, मैन्युअल पृष्ठों को देखने के लिए एक प्रारंभिक [[X11]] अनुप्रयोग|link=index.php?title=File:Screenshot_of_%22Xman%22_program.png]]
[[File:OpenBSD Manpages Section 8 Intro.png|thumb|[[OpenBSD]] सेक्शन 8 इंट्रो मैन पेज, एक टेक्स्ट कंसोल में प्रदर्शित]]यूनिक्स के इतिहास के पहले दो वर्षों में कोई दस्तावेज मौजूद नहीं था।<ref name="reader">{{cite techreport |first1=M. D. |last1=McIlroy |author-link1=Doug McIlroy |year=1987 |url=http://www.cs.dartmouth.edu/~doug/reader.pdf |title=A Research Unix reader: annotated excerpts from the Programmer's Manual, 1971–1986 |series=CSTR |number=139 |institution=Bell Labs |access-date=2015-02-01 |archive-date=2017-11-11 |archive-url=https://web.archive.org/web/20171111151817/http://www.cs.dartmouth.edu/~doug/reader.pdf |url-status=live }}</ref> [http://man.cat-v.org/unix-1st/ यूनिक्स प्रोग्रामर मैनुअल] पहली बार 3 नवंबर, 1971 को प्रकाशित हुआ था। [[डेनिस रिची]] और [[केन थॉम्पसन]] के आग्रह पर पहले वास्तविक मैन पेज लिखे गए थे।{{fact|date=February 2020}1971 में उनके प्रबंधक डगलस मेक्लोरी के }। मैन पेजों के अलावा, प्रोग्रामर के मैनुअल ने छोटे कागजात का एक सेट भी संचित किया, उनमें से कुछ [[ट्यूटोरियल]] (जैसे सामान्य यूनिक्स उपयोग के लिए, [[ सी (प्रोग्रामिंग भाषा) ]] प्रोग्रामिंग लैंग्वेज, और टूल जैसे कि [[Yacc]]), और अन्य ऑपरेटिंग सिस्टम सुविधाओं का अधिक विस्तृत विवरण। मैनुअल का मुद्रित संस्करण शुरू में एक एकल बाइंडर में फिट होता है, लेकिन पीडब्ल्यूबी/यूनिक्स और [[ अनुसंधान यूनिक्स ]] के [[संस्करण 7 यूनिक्स]] के रूप में, इसे वॉल्यूम 1 बनाने वाले मुद्रित मैन पेजों के साथ दो खंडों में विभाजित किया गया था।<ref name="evolution">{{cite web |url=http://www.collyer.net/who/geoff/history.html |title=UNIX Evolution: 1975-1984 Part I - Diversity |last1=Darwin |first1=Ian |last2=Collyer |first2=Geoffrey |access-date=22 December 2012 |archive-date=17 July 2012 |archive-url=https://web.archive.org/web/20120717002523/http://www.collyer.net/who/geoff/history.html |url-status=live }} Originally published in ''Microsystems'' '''5'''(11), November 1984.</ref>
[[File:OpenBSD Manpages Section 8 Intro.png|thumb|[[OpenBSD|ओपनबीएसडी]] सेक्शन 8 इंट्रो मैन पेज, एक टेक्स्ट कंसोल में प्रदर्शित]]यूनिक्स के इतिहास के पहले दो वर्षों में कोई दस्तावेज मौजूद नहीं था।<ref name="reader">{{cite techreport |first1=M. D. |last1=McIlroy |author-link1=Doug McIlroy |year=1987 |url=http://www.cs.dartmouth.edu/~doug/reader.pdf |title=A Research Unix reader: annotated excerpts from the Programmer's Manual, 1971–1986 |series=CSTR |number=139 |institution=Bell Labs |access-date=2015-02-01 |archive-date=2017-11-11 |archive-url=https://web.archive.org/web/20171111151817/http://www.cs.dartmouth.edu/~doug/reader.pdf |url-status=live }}</ref> [http://man.cat-v.org/unix-1st/ यूनिक्स प्रोग्रामर मैनुअल] पहली बार 3 नवंबर, 1971 को प्रकाशित हुआ था। [[डेनिस रिची]] और [[केन थॉम्पसन]] के आग्रह पर पहले वास्तविक मैन पेज लिखे गए थे।{{fact|date=February 2020}1971 में उनके प्रबंधक डगलस मेक्लोरी के }। मैन पेजों के अलावा, प्रोग्रामर के मैनुअल ने छोटे कागजात का एक सेट भी संचित किया, उनमें से कुछ [[ट्यूटोरियल]] (जैसे सामान्य यूनिक्स उपयोग के लिए, [[ सी (प्रोग्रामिंग भाषा) ]] प्रोग्रामिंग लैंग्वेज, और टूल जैसे कि [[Yacc]]), और अन्य ऑपरेटिंग सिस्टम सुविधाओं का अधिक विस्तृत विवरण। मैनुअल का मुद्रित संस्करण शुरू में एक एकल बाइंडर में फिट होता है, लेकिन पीडब्ल्यूबी/यूनिक्स और [[ अनुसंधान यूनिक्स ]] के [[संस्करण 7 यूनिक्स]] के रूप में, इसे वॉल्यूम 1 बनाने वाले मुद्रित मैन पेजों के साथ दो खंडों में विभाजित किया गया था।<ref name="evolution">{{cite web |url=http://www.collyer.net/who/geoff/history.html |title=UNIX Evolution: 1975-1984 Part I - Diversity |last1=Darwin |first1=Ian |last2=Collyer |first2=Geoffrey |access-date=22 December 2012 |archive-date=17 July 2012 |archive-url=https://web.archive.org/web/20120717002523/http://www.collyer.net/who/geoff/history.html |url-status=live }} Originally published in ''Microsystems'' '''5'''(11), November 1984.</ref>
प्रलेखन के बाद के संस्करणों ने पहले मैन पेजों की संक्षिप्तता की नकल की। रिची ने [[संस्करण 3 यूनिक्स]] परिचय के लिए कैसे शुरू करें अनुभाग जोड़ा, और [[लोरिंडा चेरी]] ने [[संस्करण 6 यूनिक्स]] और संस्करण 7 यूनिक्स संस्करणों के लिए पर्पल कार्ड पॉकेट संदर्भ प्रदान किया।{{r|reader}} सॉफ़्टवेयर के संस्करण मैनुअल के संशोधन के बाद नामित किए गए थे; यूनिक्स प्रोग्रामर मैनुअल का सातवां संस्करण, उदाहरण के लिए, यूनिक्स के 7वें संस्करण या संस्करण 7 के साथ आया था।<ref name="fiedler198310">{{cite news | url=https://archive.org/stream/byte-magazine-1983-10/1983_10_BYTE_08-10_UNIX#page/n133/mode/2up | title=The Unix Tutorial / Part 3: Unix in the Microcomputer Marketplace | work=BYTE | date=October 1983 | access-date=30 January 2015 | author=Fiedler, Ryan | pages=132}}</ref>
प्रलेखन के बाद के संस्करणों ने पहले मैन पेजों की संक्षिप्तता की नकल की। रिची ने [[संस्करण 3 यूनिक्स]] परिचय के लिए कैसे शुरू करें अनुभाग जोड़ा, और [[लोरिंडा चेरी]] ने [[संस्करण 6 यूनिक्स]] और संस्करण 7 यूनिक्स संस्करणों के लिए पर्पल कार्ड पॉकेट संदर्भ प्रदान किया।{{r|reader}} सॉफ़्टवेयर के संस्करण मैनुअल के संशोधन के बाद नामित किए गए थे; यूनिक्स प्रोग्रामर मैनुअल का सातवां संस्करण, उदाहरण के लिए, यूनिक्स के 7वें संस्करण या संस्करण 7 के साथ आया था।<ref name="fiedler198310">{{cite news | url=https://archive.org/stream/byte-magazine-1983-10/1983_10_BYTE_08-10_UNIX#page/n133/mode/2up | title=The Unix Tutorial / Part 3: Unix in the Microcomputer Marketplace | work=BYTE | date=October 1983 | access-date=30 January 2015 | author=Fiedler, Ryan | pages=132}}</ref>


[[संस्करण 4 यूनिक्स]] संस्करण के लिए मैन पेज [[ ट्राफ | ट्राफ]] टाइपसेटिंग पैकेज का उपयोग करके स्वरूपित किए गए थे{{r|reader}} और इसका सेट <code>-man</code> मैक्रोज़ (जो मैनुअल के छठे और सातवें संस्करणों के बीच पूरी तरह से संशोधित किए गए थे,<ref name="evolution" />लेकिन तब से बहुत ज्यादा नहीं बदला है)। उस समय, मैन्युअल पेज सिस्टम के माध्यम से ऑनलाइन दस्तावेज़ीकरण की उपलब्धता को एक बड़ी प्रगति माना जाता था। आज तक, लगभग हर यूनिक्स कमांड लाइन एप्लिकेशन एक मैन पेज के साथ आता है और कई यूनिक्स उपयोगकर्ता प्रोग्राम में मैन पेजों की कमी को निम्न गुणवत्ता के संकेत के रूप में देखते हैं; वास्तव में, कुछ परियोजनाएं, जैसे कि [[डेबियन]], एक की कमी वाले कार्यक्रमों के लिए मैन पेज लिखने के लिए अपने रास्ते से बाहर जाती हैं। बर्कले सॉफ्टवेयर डिस्ट्रीब्यूशन के आधुनिक वंशज | 4.4BSD भी मैन पेजों को सिस्टम प्रलेखन के प्राथमिक रूपों में से एक के रूप में वितरित करते हैं (पुराने <code>-man</code> नए के साथ मैक्रोज़ <code>-mdoc</code>).
[[संस्करण 4 यूनिक्स]] संस्करण के लिए मैन पेज [[ ट्राफ | ट्राफ]] टाइपसेटिंग पैकेज का उपयोग करके स्वरूपित किए गए थे{{r|reader}} और इसका सेट <code>-man</code> मैक्रोज़ (जो मैनुअल के छठे और सातवें संस्करणों के बीच पूरी तरह से संशोधित किए गए थे,<ref name="evolution" />लेकिन तब से बहुत ज्यादा नहीं बदला है)। उस समय, मैन्युअल पेज सिस्टम के माध्यम से ऑनलाइन दस्तावेज़ीकरण की उपलब्धता को एक बड़ी प्रगति माना जाता था। आज तक, लगभग हर यूनिक्स कमांड लाइन एप्लिकेशन एक मैन पेज के साथ आता है और कई यूनिक्स उपयोगकर्ता प्रोग्राम में मैन पेजों की कमी को निम्न गुणवत्ता के संकेत के रूप में देखते हैं; वास्तव में, कुछ परियोजनाएं, जैसे कि [[डेबियन]], एक की कमी वाले कार्यक्रमों के लिए मैन पेज लिखने के लिए अपने रास्ते से बाहर जाती हैं। बर्कले सॉफ्टवेयर डिस्ट्रीब्यूशन के आधुनिक वंशज | 4.4बीएसडी भी मैन पेजों को सिस्टम प्रलेखन के प्राथमिक रूपों में से एक के रूप में वितरित करते हैं (पुराने <code>-man</code> नए के साथ मैक्रोज़ <code>-mdoc</code>).


मैन कमांड के मैन-डीबी संस्करण में एक छिपा हुआ [[ ईस्टर अंडे (मीडिया) ]] था जो 00:30 पर चलने पर कमांड को गिम्मे गिम्मे गिम्मे वापस करने का कारण बनता था ([[एबीबीए]] गीत गिम्मे! गिम्मे! गिम्मे का एक संदर्भ! (ए) मैन आफ्टर मिडनाइट)। इसे 2011 में पेश किया गया था<ref name="git1">{{cite web|url=https://git.savannah.nongnu.org/cgit/man-db.git/commit/src/man.c?id=002a6339b1fe8f83f4808022a17e1aa379756d99|title=GIT commit 002a6339b1fe8f83f4808022a17e1aa379756d99|access-date=22 November 2017|archive-date=4 December 2017|archive-url=https://web.archive.org/web/20171204003014/http://git.savannah.nongnu.org/cgit/man-db.git/commit/src/man.c?id=002a6339b1fe8f83f4808022a17e1aa379756d99|url-status=live}}</ref> लेकिन पहले प्रतिबंधित<ref name="git2">{{cite web|url=https://git.savannah.gnu.org/cgit/man-db.git/commit/?id=84bde8d8a9a357bd372793d25746ac6b49480525|title=GIT commit 84bde8d8a9a357bd372793d25746ac6b49480525|access-date=22 November 2017|archive-date=5 September 2018|archive-url=https://web.archive.org/web/20180905095817/https://git.savannah.gnu.org/cgit/man-db.git/commit/?id=84bde8d8a9a357bd372793d25746ac6b49480525|url-status=live}}</ref> और फिर 2017 में हटा दिया गया<ref>{{cite web|url=https://git.savannah.gnu.org/cgit/man-db.git/commit/?id=b225d9e76fbb0a6a4539c0992fba88c83f0bd37e|title=GIT commit b225d9e76fbb0a6a4539c0992fba88c83f0bd37e|access-date=25 September 2018|archive-date=9 November 2020|archive-url=https://web.archive.org/web/20201109034103/https://git.savannah.gnu.org/cgit/man-db.git/commit/?id=b225d9e76fbb0a6a4539c0992fba88c83f0bd37e|url-status=live}}</ref> आखिरकार मिल जाने के बाद।<ref name="stackexchange1">{{cite web|url=https://unix.stackexchange.com/questions/405783/why-does-man-print-gimme-gimme-gimme-at-0030|title="Why does man print "gimme gimme gimme" at 00:30?"|access-date=22 November 2017|archive-date=21 November 2017|archive-url=https://web.archive.org/web/20171121230223/https://unix.stackexchange.com/questions/405783/why-does-man-print-gimme-gimme-gimme-at-0030|url-status=live}}</ref>
मैन कमांड के मैन-डीबी संस्करण में एक छिपा हुआ [[ ईस्टर अंडे (मीडिया) ]] था जो 00:30 पर चलने पर कमांड को गिम्मे गिम्मे गिम्मे वापस करने का कारण बनता था ([[एबीबीए]] गीत गिम्मे! गिम्मे! गिम्मे का एक संदर्भ! (ए) मैन आफ्टर मिडनाइट)। इसे 2011 में पेश किया गया था<ref name="git1">{{cite web|url=https://git.savannah.nongnu.org/cgit/man-db.git/commit/src/man.c?id=002a6339b1fe8f83f4808022a17e1aa379756d99|title=GIT commit 002a6339b1fe8f83f4808022a17e1aa379756d99|access-date=22 November 2017|archive-date=4 December 2017|archive-url=https://web.archive.org/web/20171204003014/http://git.savannah.nongnu.org/cgit/man-db.git/commit/src/man.c?id=002a6339b1fe8f83f4808022a17e1aa379756d99|url-status=live}}</ref> लेकिन पहले प्रतिबंधित<ref name="git2">{{cite web|url=https://git.savannah.gnu.org/cgit/man-db.git/commit/?id=84bde8d8a9a357bd372793d25746ac6b49480525|title=GIT commit 84bde8d8a9a357bd372793d25746ac6b49480525|access-date=22 November 2017|archive-date=5 September 2018|archive-url=https://web.archive.org/web/20180905095817/https://git.savannah.gnu.org/cgit/man-db.git/commit/?id=84bde8d8a9a357bd372793d25746ac6b49480525|url-status=live}}</ref> और फिर 2017 में हटा दिया गया<ref>{{cite web|url=https://git.savannah.gnu.org/cgit/man-db.git/commit/?id=b225d9e76fbb0a6a4539c0992fba88c83f0bd37e|title=GIT commit b225d9e76fbb0a6a4539c0992fba88c83f0bd37e|access-date=25 September 2018|archive-date=9 November 2020|archive-url=https://web.archive.org/web/20201109034103/https://git.savannah.gnu.org/cgit/man-db.git/commit/?id=b225d9e76fbb0a6a4539c0992fba88c83f0bd37e|url-status=live}}</ref> आखिरकार मिल जाने के बाद।<ref name="stackexchange1">{{cite web|url=https://unix.stackexchange.com/questions/405783/why-does-man-print-gimme-gimme-gimme-at-0030|title="Why does man print "gimme gimme gimme" at 00:30?"|access-date=22 November 2017|archive-date=21 November 2017|archive-url=https://web.archive.org/web/20171121230223/https://unix.stackexchange.com/questions/405783/why-does-man-print-gimme-gimme-gimme-at-0030|url-status=live}}</ref>
== स्वरूपण ==
== स्वरूपण ==
[[File:FreeBSD typeset man page.png|thumb|फ्रीबीएसडी का हिस्सा {{tt|man(1)}} मैनुअल पेज, [[ संवहन दस्तावेज़ स्वरूप ]] फॉर्मेट में टाइपसेट]]मैन पेजों का डिफ़ॉल्ट प्रारूप ट्रॉफ है, या तो [[ट्रॉफ मैक्रोज़]] मैन (उपस्थिति उन्मुख) या एमडीओसी (सिमेंटिक ओरिएंटेड) के साथ। इससे मैन पेज को [[ परिशिष्ट भाग ]], पोर्टेबल दस्तावेज़ प्रारूप, और देखने या प्रिंट करने के लिए कई अन्य प्रारूपों में टाइप करना संभव हो जाता है।
[[File:FreeBSD typeset man page.png|thumb|फ्रीबीएसडी का हिस्सा मैनुअल पेज, [[ संवहन दस्तावेज़ स्वरूप ]] फॉर्मेट में टाइपसेट]]मैन पेजों का डिफ़ॉल्ट प्रारूप ट्रॉफ है, या तो [[ट्रॉफ मैक्रोज़]] मैन (उपस्थिति उन्मुख) या एमडीओसी (सिमेंटिक ओरिएंटेड) के साथ। इससे मैन पेज को [[ परिशिष्ट भाग ]], पोर्टेबल दस्तावेज़ प्रारूप, और देखने या प्रिंट करने के लिए कई अन्य प्रारूपों में टाइप करना संभव हो जाता है।


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


[[GNU Emacs]] प्रोग्राम WoMan (विदआउट मैन से) संपादक से मैन पेज ब्राउज़ करने की अनुमति देता है।<ref name="WoMan">{{cite web |last1=Wright |first1=Francis J. |title=WoMan: Browse Unix Manual Pages "W.O. (without) Man" |url=https://www.gnu.org/software/emacs/manual/html_mono/woman.html |publisher=GNU |access-date=3 August 2020 |archive-date=11 November 2020 |archive-url=https://web.archive.org/web/20201111204938/https://www.gnu.org/software/emacs/manual/html_mono/woman.html |url-status=live }}</ref>
[[GNU Emacs|जीएनयू ईएमएसीएस]] प्रोग्राम वू मैन (विदआउट मैन से) संपादक से मैन पेज ब्राउज़ करने की अनुमति देता है।<ref name="WoMan">{{cite web |last1=Wright |first1=Francis J. |title=WoMan: Browse Unix Manual Pages "W.O. (without) Man" |url=https://www.gnu.org/software/emacs/manual/html_mono/woman.html |publisher=GNU |access-date=3 August 2020 |archive-date=11 November 2020 |archive-url=https://web.archive.org/web/20201111204938/https://www.gnu.org/software/emacs/manual/html_mono/woman.html |url-status=live }}</ref>


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


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


फरवरी 2013 में, [[बीएसडी]] समुदाय ने एक नया खुला स्रोत [http://mdoc.su/ mdoc.su] सेवा शुरू की, जो एक अद्वितीय [[nginx]]- के माध्यम से प्रमुख आधुनिक बीएसडी परियोजनाओं की man.cgi स्क्रिप्ट तक पहुंच को एकीकृत और छोटा करता है। *BSD मैन पेजों के लिए नियतात्मक [[URL छोटा करना]] सेवा आधारित।<ref>{{cite web |url=http://www.freebsd.org/news/status/report-2013-01-2013-03.html#mdoc.su-%E2%80%94-Short-Manual-Page-URLs |title=FreeBSD Quarterly Status Report, January-March 2013 |publisher=[[FreeBSD]] |editor-first=Gabor |editor-last=Pali |date=12 May 2013 |access-date=25 December 2014 |archive-date=22 December 2014 |archive-url=https://web.archive.org/web/20141222022258/http://www.freebsd.org/news/status/report-2013-01-2013-03.html#mdoc.su-%E2%80%94-Short-Manual-Page-URLs |url-status=live }}</ref><ref>{{cite mailing list |date=19 February 2013 |url=http://lists.freebsd.org/pipermail/freebsd-doc/2013-February/021465.html |mailing-list=freebsd-doc@freebsd.org |title=mdoc.su की घोषणा, छोटे मैनुअल पेज यूआरएल|first=Constantine A. |last=Murenin |access-date=25 December 2014 |archive-date=7 August 2014 |archive-url=https://web.archive.org/web/20140807051219/http://lists.freebsd.org/pipermail/freebsd-doc/2013-February/021465.html |url-status=live }}</ref><ref>{{cite web |url=http://mdoc.su/ |title=mdoc.su — Short manual page URLs for FreeBSD, OpenBSD, NetBSD and DragonFly BSD |first=Constantine A. |last=Murenin |date=23 February 2013 |access-date=25 December 2014 |archive-date=17 December 2014 |archive-url=https://web.archive.org/web/20141217170726/http://mdoc.su/ |url-status=live }}</ref>
फरवरी 2013 में, [[बीएसडी]] समुदाय ने एक नया खुला स्रोत [http://mdoc.su/ mdoc.su] सेवा शुरू की, जो एक अद्वितीय [[nginx]]- के माध्यम से प्रमुख आधुनिक बीएसडी परियोजनाओं की man.cgi स्क्रिप्ट तक पहुंच को एकीकृत और छोटा करता है। *BSD मैन पेजों के लिए नियतात्मक [[URL छोटा करना|यूआरएल छोटा करना]] सेवा आधारित।<ref>{{cite web |url=http://www.freebsd.org/news/status/report-2013-01-2013-03.html#mdoc.su-%E2%80%94-Short-Manual-Page-URLs |title=FreeBSD Quarterly Status Report, January-March 2013 |publisher=[[FreeBSD]] |editor-first=Gabor |editor-last=Pali |date=12 May 2013 |access-date=25 December 2014 |archive-date=22 December 2014 |archive-url=https://web.archive.org/web/20141222022258/http://www.freebsd.org/news/status/report-2013-01-2013-03.html#mdoc.su-%E2%80%94-Short-Manual-Page-URLs |url-status=live }}</ref><ref>{{cite mailing list |date=19 February 2013 |url=http://lists.freebsd.org/pipermail/freebsd-doc/2013-February/021465.html |mailing-list=freebsd-doc@freebsd.org |title=mdoc.su की घोषणा, छोटे मैनुअल पेज यूआरएल|first=Constantine A. |last=Murenin |access-date=25 December 2014 |archive-date=7 August 2014 |archive-url=https://web.archive.org/web/20140807051219/http://lists.freebsd.org/pipermail/freebsd-doc/2013-February/021465.html |url-status=live }}</ref><ref>{{cite web |url=http://mdoc.su/ |title=mdoc.su — Short manual page URLs for FreeBSD, OpenBSD, NetBSD and DragonFly BSD |first=Constantine A. |last=Murenin |date=23 February 2013 |access-date=25 December 2014 |archive-date=17 December 2014 |archive-url=https://web.archive.org/web/20141217170726/http://mdoc.su/ |url-status=live }}</ref>


लिनक्स के लिए, एक man7.org सेवा को सिस्टम के लिए विशिष्ट मैनुअल प्रदान करने के लिए स्थापित किया गया है।<ref>{{cite web |title=लिनक्स मैन पेज ऑनलाइन|url=http://man7.org/linux/man-pages/index.html |website=man7.org |access-date=2020-05-05 |archive-date=2020-05-07 |archive-url=https://web.archive.org/web/20200507122101/http://www.man7.org/linux/man-pages/index.html |url-status=live }}</ref> ManKier सेवा व्यापक चयन प्रदान करती है, और TLDR पृष्ठों को भी एकीकृत करती है।<ref>{{cite web |title=के बारे में|url=https://www.mankier.com/about |website=ManKier |access-date=2020-05-05 |archive-date=2020-04-25 |archive-url=https://web.archive.org/web/20200425112006/https://www.mankier.com/about |url-status=live }}</ref>
लिनक्स के लिए, एक man7.org सेवा को सिस्टम के लिए विशिष्ट मैनुअल प्रदान करने के लिए स्थापित किया गया है।<ref>{{cite web |title=लिनक्स मैन पेज ऑनलाइन|url=http://man7.org/linux/man-pages/index.html |website=man7.org |access-date=2020-05-05 |archive-date=2020-05-07 |archive-url=https://web.archive.org/web/20200507122101/http://www.man7.org/linux/man-pages/index.html |url-status=live }}</ref> मैनकीर सेवा व्यापक चयन प्रदान करती है, और टीएलडीआर पृष्ठों को भी एकीकृत करती है।<ref>{{cite web |title=के बारे में|url=https://www.mankier.com/about |website=ManKier |access-date=2020-05-05 |archive-date=2020-04-25 |archive-url=https://web.archive.org/web/20200425112006/https://www.mankier.com/about |url-status=live }}</ref>
== कमांड उपयोग ==
== कमांड उपयोग ==
यूनिक्स कमांड के लिए मैन्युअल पेज पढ़ने के लिए, उपयोगकर्ता टाइप कर सकता है:
यूनिक्स कमांड के लिए मैन्युअल पेज पढ़ने के लिए, उपयोगकर्ता टाइप कर सकता है:
Line 48: Line 48:
man 3 printf
man 3 printf
</syntaxhighlight>
</syntaxhighlight>
जो मैन पेज के सेक्शन 3 में [[ printf ]] की खोज करता है।
जो मैन पेज के सेक्शन 3 में [[ printf | प्रिंट एफ]] की खोज करता है।


== मैनुअल सेक्शन ==
== मैनुअल सेक्शन ==
मैनुअल को आम तौर पर आठ क्रमांकित वर्गों में विभाजित किया जाता है, जो निम्नानुसार व्यवस्थित होता है (अनुसंधान यूनिक्स, बीएसडी, मैकोज़। [[लिनक्स]], और [[ओरेकल सोलारिस]] 11.4 पर):<ref name=mk/><ref name=FBSD>{{man|1|man|FreeBSD}}</ref><ref name=v8>{{cite web |title=रिसर्च यूनिक्स आठवें संस्करण के लिए मैनुअल पेज|url=http://man.cat-v.org/unix_8th/ |website=man.cat-v.org |access-date=2020-05-06 |archive-date=2020-06-30 |archive-url=https://web.archive.org/web/20200630215702/http://man.cat-v.org/unix_8th/ |url-status=live }}</ref><ref name=svr4>{{cite web |title=यूनिक्स प्रोग्रामर मैनुअल - परिचय|url=https://www.bell-labs.com/usr/dmr/www/manintro.html |website=www.bell-labs.com |date=November 3, 1971 |access-date=May 6, 2020 |archive-date=June 1, 2020 |archive-url=https://web.archive.org/web/20200601064923/https://www.bell-labs.com/usr/dmr/www/manintro.html |url-status=live }}</ref>
मैनुअल को आम तौर पर आठ क्रमांकित वर्गों में विभाजित किया जाता है, जो निम्नानुसार व्यवस्थित होता है (अनुसंधान यूनिक्स, बीएसडी, मैकोज़। [[लिनक्स]], और [[ओरेकल सोलारिस]] 11.4 पर):<ref name=mk/><ref name=FBSD>{{man|1|man|FreeBSD}}</ref><ref name=v8>{{cite web |title=रिसर्च यूनिक्स आठवें संस्करण के लिए मैनुअल पेज|url=http://man.cat-v.org/unix_8th/ |website=man.cat-v.org |access-date=2020-05-06 |archive-date=2020-06-30 |archive-url=https://web.archive.org/web/20200630215702/http://man.cat-v.org/unix_8th/ |url-status=live }}</ref><ref name=svr4>{{cite web |title=यूनिक्स प्रोग्रामर मैनुअल - परिचय|url=https://www.bell-labs.com/usr/dmr/www/manintro.html |website=www.bell-labs.com |date=November 3, 1971 |access-date=May 6, 2020 |archive-date=June 1, 2020 |archive-url=https://web.archive.org/web/20200601064923/https://www.bell-labs.com/usr/dmr/www/manintro.html |url-status=live }}</ref>
{| class="wikitable"
{| class="wikitable"
! Section
! अनुभाग
! Description
! विवरण
|-
|-
| 1
| 1
| General [[Command (computing)|command]]s
| सामान्य[[Command (computing)|आदेश]]
|-
|-
| 2
| 2
| [[System call]]s
| [[System call|सिस्टम कॉल]]
|-
|-
| 3
| 3
|[[library (computing)|Library]] functions, covering in particular the [[C standard library]]
|[[library (computing)|पुस्तकालय]] कार्य, विशेष रूप से [[C standard library|सी मानक पुस्तकालय]] को कवर करते हुए
|-
|-
| 4
| 4
| [[Special file]]s (usually devices, those found in /dev) and [[device driver|drivers]]
| [[Special file|विशेष फ़ाइलें]] (आमतौर पर उपकरण, जो /dev में पाए जाते हैं) और [[device driver|ड्राइवरों]]
|-
|-
| 5
| 5
| [[File format]]s and conventions
| [[File format|फ़ाइल प्रारूप]] और परंपराएँ
|-
|-
| 6
| 6
| [[Video game|Game]]s and [[screensaver]]s
| [[Video game|गेम्स]] और [[screensaver|स्क्रीनसेवर]]
|-
|-
| 7
| 7
| Miscellaneous
| मिश्रित
|-
|-
| 8
| 8
| System administration [[command (computing)|command]]s and [[Daemon (computer software)|daemon]]s
| सिस्टम प्रशासन [[command (computing)|आदेश]] और [[Daemon (computer software)|डेमॉन]]
|}
|}
[[POSIX]] API दोनों सेक्शन 2 और 3 में मौजूद हैं, जहाँ सेक्शन 2 में वे API शामिल हैं जिन्हें सिस्टम कॉल के रूप में लागू किया गया है और सेक्शन 3 में वे API शामिल हैं जिन्हें लाइब्रेरी रूटीन के रूप में लागू किया गया है।
[[POSIX|पॉज़िक्स]] एपीआई दोनों सेक्शन 2 और 3 में मौजूद हैं, जहाँ सेक्शन 2 में वे एपीआई सम्मिलित हैं जिन्हें सिस्टम कॉल के रूप में लागू किया गया है और सेक्शन 3 में वे एपीआईसम्मिलित हैं जिन्हें लाइब्रेरी रूटीन के रूप में लागू किया गया है।


यूनिक्स [[सिस्टम वी]] एक अलग क्रम को छोड़कर एक समान नंबरिंग योजना का उपयोग करता है:<ref>{{cite web |title=System V release 4 manuals |url=http://bitsavers.trailing-edge.com/pdf/att/unix/System_V_Release_4/ |website=bitsavers.trailing-edge.com |access-date=2020-05-06 |archive-date=2020-08-03 |archive-url=https://web.archive.org/web/20200803205815/http://bitsavers.trailing-edge.com/pdf/att/unix/System_V_Release_4/ |url-status=live }}</ref>
यूनिक्स [[सिस्टम वी]] एक अलग क्रम को छोड़कर एक समान नंबरिंग योजना का उपयोग करता है:<ref>{{cite web |title=System V release 4 manuals |url=http://bitsavers.trailing-edge.com/pdf/att/unix/System_V_Release_4/ |website=bitsavers.trailing-edge.com |access-date=2020-05-06 |archive-date=2020-08-03 |archive-url=https://web.archive.org/web/20200803205815/http://bitsavers.trailing-edge.com/pdf/att/unix/System_V_Release_4/ |url-status=live }}</ref>
{| class="wikitable"
{| class="wikitable"
! Section
! अनुभाग
! Description
! विवरण
|-
|-
| 1
| 1
Line 91: Line 91:
|-
|-
| 1M
| 1M
| System administration [[command (computing)|command]]s and [[Daemon (computer software)|daemon]]s
| सिस्टम प्रशासन [[command (computing)|आदेश]] और [[Daemon (computer software)|डेमॉन]]
|-
|-
| 2
| 2
| [[System call]]s
| [[System call|सिस्टम कॉल]]
|-
|-
| 3
| 3
| [[C library]] functions
| [[C library|सी लाइब्रेरी]] फ़ंक्शंस
|-
|-
| 4
| 4
| [[File format]]s and conventions
| [[File format|फ़ाइल प्रारूप]] और परंपराएँ
|-
|-
| 5
| 5
| Miscellanea
| अनेक वस्तुओं का संग्रह
|-
|-
| 6
| 6
| [[Video game|Game]]s and [[screensaver]]s
| [[Video game|खेल]] और [[screensaver|स्क्रीनसेवर]]
|-
|-
| 7
| 7
| [[Special file]]s (usually devices, those found in /dev) and [[device driver|drivers]]
| [[Special file|विशेष फ़ाइलें]] (आमतौर पर उपकरण, जो /dev में पाए जाते हैं) और [[device driver|ड्राइवरों]]
|-
|-
|}
|}
कुछ प्रणालियों पर निम्नलिखित में से कुछ खंड उपलब्ध हैं:
कुछ प्रणालियों पर निम्नलिखित में से कुछ खंड उपलब्ध हैं:
{| class="wikitable"
{| class="wikitable"
! Section
! अनुभाग
! Description
! विवरण
|-
|-
| 0
| 0
| [[C library]] [[header file]]s (Unix v6)
| [[C library|सी लाइब्रेरी]] [[header file|हेडर फ़ाइलें]] (यूनिक्स v6)
|-
|-
| 9
| 9
| [[Kernel (operating system)|Kernel]] routines (FreeBSD, SVR4, Linux)<ref name=svr4/><ref name=FBSD/>
| [[Kernel (operating system)|कर्नेल]] दिनचर्या (फ्रीबीएसडी, एसवीआर4, लिनक्स)<ref name=svr4/><ref name=FBSD/>
|-
|-
| l
| l
| [[LAPACK]] library functions<ref>{{Cite web|title=lapack (l) - Linux Man Pages|url=https://www.systutorials.com/docs/linux/man/l-lapack/|access-date=2021-05-29|website=www.systutorials.com|archive-date=2023-03-11|archive-url=https://web.archive.org/web/20230311130845/https://www.systutorials.com/docs/linux/man/l-lapack/|url-status=live}}</ref>
| [[LAPACK|लैपैक]] पुस्तकालय कार्य <ref>{{Cite web|title=lapack (l) - Linux Man Pages|url=https://www.systutorials.com/docs/linux/man/l-lapack/|access-date=2021-05-29|website=www.systutorials.com|archive-date=2023-03-11|archive-url=https://web.archive.org/web/20230311130845/https://www.systutorials.com/docs/linux/man/l-lapack/|url-status=live}}</ref>
|-
|-
| n
| n
| [[Tcl]]/[[Tk (computing)|Tk]] commands
| [[Tcl|टीसीएल]]/[[Tk (computing)|टीके]] कमांड
|-
|-
| x
| x
| The [[X Window System]]
| [[X Window System|एक्स विंडो सिस्टम]]
|}
|}
कुछ खंडों को प्रत्यय के माध्यम से और उप-विभाजित किया गया है; उदाहरण के लिए, कुछ प्रणालियों में, धारा 3C C लाइब्रेरी कॉल के लिए है, 3M गणित लाइब्रेरी के लिए है, और इसी तरह। इसका एक परिणाम यह है कि धारा 8 (सिस्टम एडमिनिस्ट्रेशन कमांड्स) को कभी-कभी मुख्य कमांड्स सेक्शन के 1M उपखंड में स्थानांतरित कर दिया जाता है। कुछ उपखंड प्रत्यय का वर्गों में सामान्य अर्थ होता है:
कुछ खंडों को प्रत्यय के माध्यम से और उप-विभाजित किया गया है; उदाहरण के लिए, कुछ प्रणालियों में, धारा 3C C लाइब्रेरी कॉल के लिए है, 3M गणित लाइब्रेरी के लिए है, और इसी तरह। इसका एक परिणाम यह है कि धारा 8 (सिस्टम एडमिनिस्ट्रेशन कमांड्स) को कभी-कभी मुख्य कमांड्स सेक्शन के 1M उपखंड में स्थानांतरित कर दिया जाता है। कुछ उपखंड प्रत्यय का वर्गों में सामान्य अर्थ होता है:
{| class="wikitable"
{| class="wikitable"
! Subsection
! उपधारा
! Description
! विवरण
|-
|-
| p || [[POSIX]] specifications
| p || [[POSIX|पॉज़िक्स]] विशेष विवरण
|-
|-
| x || [[X Window System]] documentation
| x || [[X Window System|एक्स विंडो सिस्टम]] दस्तावेज़ीकरण
|}
|}
(धारा 3 अलग-अलग भाषाओं के कई प्रत्ययों के साथ अपवाद है।)
(धारा 3 अलग-अलग भाषाओं के कई प्रत्ययों के साथ अपवाद है।)
Line 146: Line 146:


== लेआउट ==
== लेआउट ==
सभी मैन पेज एक सामान्य लेआउट का अनुसरण करते हैं जो एक साधारण [[ASCII]] पाठ प्रदर्शन पर प्रस्तुति के लिए अनुकूलित है, संभवतः बिना किसी प्रकार के हाइलाइटिंग या फ़ॉन्ट नियंत्रण के। मौजूद वर्गों में शामिल हो सकते हैं:<ref name=mdoc-7/>
सभी मैन पेज एक सामान्य लेआउट का अनुसरण करते हैं जो एक साधारण [[ASCII|एएससीआईआई]] पाठ प्रदर्शन पर प्रस्तुति के लिए अनुकूलित है, संभवतः बिना किसी प्रकार के हाइलाइटिंग या फ़ॉन्ट नियंत्रण के। मौजूद वर्गों में सम्मिलित हो सकते हैं:<ref name=mdoc-7/>
; NAME: कमांड या फ़ंक्शन का नाम, उसके बाद यह क्या करता है इसका एक-पंक्ति विवरण।
; नाम: कमांड या फ़ंक्शन का नाम, उसके बाद यह क्या करता है इसका एक-पंक्ति विवरण।
; SYNOPSIS: एक कमांड के मामले में, इसे कैसे चलाना है और इसके लिए कौन से कमांड लाइन विकल्प लगते हैं, इसका एक औपचारिक विवरण। प्रोग्राम फ़ंक्शंस के लिए, फ़ंक्शन द्वारा लिए जाने वाले पैरामीटर की एक सूची और किस हेडर फ़ाइल में इसकी घोषणा होती है।
; सार: एक कमांड के मामले में, इसे कैसे चलाना है और इसके लिए कौन से कमांड लाइन विकल्प लगते हैं, इसका एक औपचारिक विवरण। प्रोग्राम फ़ंक्शंस के लिए, फ़ंक्शन द्वारा लिए जाने वाले पैरामीटर की एक सूची और किस हेडर फ़ाइल में इसकी घोषणा होती है।
; विवरण: कमांड या फ़ंक्शन के कामकाज का एक पाठ्य विवरण।
; विवरण: कमांड या फ़ंक्शन के कामकाज का एक पाठ्य विवरण।
; उदाहरण: सामान्य उपयोग के कुछ उदाहरण।
; उदाहरण: सामान्य उपयोग के कुछ उदाहरण।
; यह भी देखें: संबंधित कमांड या कार्यों की एक सूची।
; यह भी देखें: संबंधित कमांड या कार्यों की एक सूची।


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


== संलेखन ==
== संलेखन ==
मैनुअल पेज या तो पुराने में लिखे जा सकते हैं {{code|man}} मैक्रोज़, नया {{code|doc}} मैक्रोज़, या दोनों का संयोजन ({{code|mandoc}}).<ref>{{man|5|groff_tmac|ManKier}}</ref>  {{code|man}an}} मैक्रो सेट शीर्षक पंक्ति, सेक्शन हेडर, (बोल्ड, छोटे या इटैलिक) फोंट, पैराग्राफ और इंडेंटेशन को जोड़ने/घटाने के निर्देशों के साथ न्यूनतम [[ रिच पाठ ]] फ़ंक्शंस प्रदान करता है।<ref>{{man|7|man|ManKier}}</ref> नया {{code|mdoc}} भाषा प्रकृति में अधिक सिमेंटिक है, और अधिकांश मानक वर्गों जैसे प्रोग्राम नाम, सारांश, फ़ंक्शन नाम और लेखकों के नाम के लिए विशेष मैक्रो शामिल हैं। इस जानकारी का उपयोग मैनडॉक जैसे कार्यक्रमों द्वारा मैनुअल के लिए सिमेंटिक खोज को लागू करने के लिए किया जा सकता है। हालाँकि इसमें स्टाइल को सीधे नियंत्रित करने के निर्देश भी शामिल हैं, यह उम्मीद की जाती है कि विशेष मैक्रोज़ अधिकांश उपयोग-मामलों को कवर करेंगे।<ref name=mdoc-7>{{man|7|mdoc|FreeBSD}}</ref> मैंडॉक और ग्रॉफ दोनों परियोजनाओं पर विचार किया जाता है {{code|mdoc}} नए दस्तावेजों के लिए पसंदीदा प्रारूप।<ref>{{cite web |title=Groff Mission Statement - 2014 |url=https://www.gnu.org/software/groff/groff-mission-statement.html |website=www.gnu.org |quote=Concurrent with work on man(7), mdoc(7) will be actively supported and its use promoted. |access-date=2021-01-02 |archive-date=2020-12-03 |archive-url=https://web.archive.org/web/20201203121306/https://www.gnu.org/software/groff/groff-mission-statement.html |url-status=live }}</ref>
मैनुअल पेज या तो पुराने में लिखे जा सकते हैं {{code|man}} मैक्रोज़, नया {{code|doc}} मैक्रोज़, या दोनों का संयोजन ({{code|mandoc}}).<ref>{{man|5|groff_tmac|ManKier}}</ref>  {{code|man}an}} मैक्रो सेट शीर्षक पंक्ति, सेक्शन हेडर, (बोल्ड, छोटे या इटैलिक) फोंट, पैराग्राफ और इंडेंटेशन को जोड़ने/घटाने के निर्देशों के साथ न्यूनतम [[ रिच पाठ ]] फ़ंक्शंस प्रदान करता है।<ref>{{man|7|man|ManKier}}</ref> नया {{code|mdoc}} भाषा प्रकृति में अधिक सिमेंटिक है, और अधिकांश मानक वर्गों जैसे प्रोग्राम नाम, सारांश, फ़ंक्शन नाम और लेखकों के नाम के लिए विशेष मैक्रो सम्मिलित हैं। इस जानकारी का उपयोग मैनडॉक जैसे कार्यक्रमों द्वारा मैनुअल के लिए सिमेंटिक खोज को लागू करने के लिए किया जा सकता है। हालाँकि इसमें स्टाइल को सीधे नियंत्रित करने के निर्देश भी सम्मिलित हैं, यह उम्मीद की जाती है कि विशेष मैक्रोज़ अधिकांश उपयोग-मामलों को कवर करेंगे।<ref name=mdoc-7>{{man|7|mdoc|FreeBSD}}</ref> मैंडॉक और ग्रॉफ दोनों परियोजनाओं पर विचार किया जाता है {{code|mdoc}} नए दस्तावेजों के लिए पसंदीदा प्रारूप।<ref>{{cite web |title=Groff Mission Statement - 2014 |url=https://www.gnu.org/software/groff/groff-mission-statement.html |website=www.gnu.org |quote=Concurrent with work on man(7), mdoc(7) will be actively supported and its use promoted. |access-date=2021-01-02 |archive-date=2020-12-03 |archive-url=https://web.archive.org/web/20201203121306/https://www.gnu.org/software/groff/groff-mission-statement.html |url-status=live }}</ref>


यद्यपि मैन पेज 10-बिंदु [[रोमन प्रकार]] का उपयोग करते हुए ट्रॉफ के लिए निर्धारित पाठ हैं, यह अंतर आम तौर पर विवादास्पद है क्योंकि मैन पेज पेपर पर रखे जाने के बजाय टर्मिनल (टीटीवाई) में देखे जाते हैं। नतीजतन, छोटे फ़ॉन्ट मैक्रो का शायद ही कभी उपयोग किया जाता है।<ref>{{cite web |title=आदमी|url=https://www.gnu.org/software/groff/manual/html_node/man.html |website=The GNU Troff Manual |access-date=31 December 2019 |archive-date=24 December 2019 |archive-url=https://web.archive.org/web/20191224124039/https://www.gnu.org/software/groff/manual/html_node/man.html |url-status=live }}</ref> दूसरी ओर, बोल्ड और इटैलिक टेक्स्ट टर्मिनल द्वारा [[ECMA-48]] और ग्रॉफ के माध्यम से समर्थित है {{code|grotty}} जब यह एक सहायक टर्मिनल का पता लगाता है तो अनुरोध के अनुसार उन्हें उत्सर्जित करता है। बीएसडी मैनडॉक हालांकि टाइपराइटर बैकस्पेस-फिर-ओवरस्ट्राइक अनुक्रम के माध्यम से केवल बोल्ड और रेखांकित (इटैलिक के प्रतिस्थापन के रूप में) टेक्स्ट का समर्थन करता है, जिसे ईसीएमए-48 में अनुवादित करने की आवश्यकता है {{code|less}}.<ref>{{cite web |title=नोश यूजर-स्पेस वर्चुअल टर्मिनल पर मैनुअल पेजों में इटैलिक और रंग|url=https://jdebp.uk/Softwares/nosh/italics-in-manuals.html |website=jdebp.eu |access-date=2021-01-21 |archive-date=2021-01-28 |archive-url=https://web.archive.org/web/20210128033617/https://jdebp.uk/Softwares/nosh/italics-in-manuals.html |url-status=live }}</ref><ref>{{man|1|mandoc|FreeBSD}}. "Font styles are applied by using back-spaced encoding..."</ref>
यद्यपि मैन पेज 10-बिंदु [[रोमन प्रकार]] का उपयोग करते हुए ट्रॉफ के लिए निर्धारित पाठ हैं, यह अंतर आम तौर पर विवादास्पद है क्योंकि मैन पेज पेपर पर रखे जाने के बजाय टर्मिनल (टीटीवाई) में देखे जाते हैं। नतीजतन, छोटे फ़ॉन्ट मैक्रो का शायद ही कभी उपयोग किया जाता है।<ref>{{cite web |title=आदमी|url=https://www.gnu.org/software/groff/manual/html_node/man.html |website=The GNU Troff Manual |access-date=31 December 2019 |archive-date=24 December 2019 |archive-url=https://web.archive.org/web/20191224124039/https://www.gnu.org/software/groff/manual/html_node/man.html |url-status=live }}</ref> दूसरी ओर, बोल्ड और इटैलिक टेक्स्ट टर्मिनल द्वारा [[ECMA-48|ऐक्मा-48]] और ग्रॉफ के माध्यम से समर्थित है {{code|grotty}} जब यह एक सहायक टर्मिनल का पता लगाता है तो अनुरोध के अनुसार उन्हें उत्सर्जित करता है। बीएसडी मैनडॉक हालांकि टाइपराइटर बैकस्पेस-फिर-ओवरस्ट्राइक अनुक्रम के माध्यम से केवल बोल्ड और रेखांकित (इटैलिक के प्रतिस्थापन के रूप में) टेक्स्ट का समर्थन करता है, जिसे ईसीएमए-48 में अनुवादित करने की आवश्यकता है {{code|less}}.<ref>{{cite web |title=नोश यूजर-स्पेस वर्चुअल टर्मिनल पर मैनुअल पेजों में इटैलिक और रंग|url=https://jdebp.uk/Softwares/nosh/italics-in-manuals.html |website=jdebp.eu |access-date=2021-01-21 |archive-date=2021-01-28 |archive-url=https://web.archive.org/web/20210128033617/https://jdebp.uk/Softwares/nosh/italics-in-manuals.html |url-status=live }}</ref><ref>{{man|1|mandoc|FreeBSD}}. "Font styles are applied by using back-spaced encoding..."</ref>


कुछ उपकरणों का उपयोग दस्तावेजों को कम विकसित प्रारूप में मैन्युअल पृष्ठों में बदलने के लिए किया गया है। उदाहरणों में जीएनयू शामिल हैं {{code|help2man}}, जो एक लेता है {{code|--help}} आउटपुट और कुछ अतिरिक्त सामग्री एक मैनुअल पेज उत्पन्न करने के लिए।<ref>{{cite web |title=help2man Reference Manual |url=https://www.gnu.org/software/help2man |access-date=5 March 2023 |archive-date=6 March 2023 |archive-url=https://web.archive.org/web/20230306093151/https://www.gnu.org/software/help2man/ |url-status=live }}</ref> उक्त आउटपुट की तुलना में मैनुअल बमुश्किल अधिक उपयोगी होगा, लेकिन GNU प्रोग्राम के लिए यह कोई समस्या नहीं है क्योंकि texinfo मुख्य प्रलेखन प्रणाली है।<ref>{{cite web |title=मैन पेज (जीएनयू कोडिंग मानक)|url=https://www.gnu.org/prep/standards/html_node/Man-Pages.html |website=www.gnu.org |access-date=2023-03-05 |archive-date=2023-03-05 |archive-url=https://web.archive.org/web/20230305170922/https://www.gnu.org/prep/standards/html_node/Man-Pages.html |url-status=live }}</ref> [[ pandoc | pandoc]], रोन और एमडी2मैन सहित कई टूल [[ markdown | markdown]] से मैन्युअल पेजों में रूपांतरण का समर्थन करते हैं। ये सभी उपकरण उत्सर्जित करते हैं {{code|man}} प्रारूप, क्योंकि मार्कडाउन शब्दार्थ सामग्री से मेल खाने के लिए पर्याप्त अभिव्यंजक नहीं है {{code|mdoc}}. मैंडॉक के लेखक के अनुसार, [[डॉकबुक]] में एक इनबिल्ट मैन (7) कन्वर्टर है-जो कि खराब गुणवत्ता का है<ref>{{cite web |author=Ingo Schwarze |title=नया मैंडॉक-एमडीओसी-टी मार्कडाउन कन्वर्टर|url=https://undeadly.org/cgi?action=article&sid=20170304230520 |website=undeadly.org |access-date=2023-03-05 |archive-date=2023-03-05 |archive-url=https://web.archive.org/web/20230305170920/https://undeadly.org/cgi?action=article&sid=20170304230520 |url-status=live }} &ndash; for specific complaints by the author, see {{cite mailing list |url=https://lists.gnu.org/archive/html/groff/2014-02/msg00109.html |title=Re: Groff man pages (tangential to Future Redux) |author=Ingo Schwarze |date=28 February 2014 |mailing-list=Groff |archive-url=https://web.archive.org/web/20230305171936/https://lists.gnu.org/archive/html/groff/2014-02/msg00109.html |archive-date=2023-03-05 |url-status=live}}</ref> जिन्होंने एक अलग mdoc(7) कन्वर्टर लिखा था।
कुछ उपकरणों का उपयोग दस्तावेजों को कम विकसित प्रारूप में मैन्युअल पृष्ठों में बदलने के लिए किया गया है। उदाहरणों में जीएनयू सम्मिलित हैं {{code|help2man}}, जो एक लेता है {{code|--help}} आउटपुट और कुछ अतिरिक्त सामग्री एक मैनुअल पेज उत्पन्न करने के लिए।<ref>{{cite web |title=help2man Reference Manual |url=https://www.gnu.org/software/help2man |access-date=5 March 2023 |archive-date=6 March 2023 |archive-url=https://web.archive.org/web/20230306093151/https://www.gnu.org/software/help2man/ |url-status=live }}</ref> उक्त आउटपुट की तुलना में मैनुअल बमुश्किल अधिक उपयोगी होगा, लेकिन जीएनयू प्रोग्राम के लिए यह कोई समस्या नहीं है क्योंकि texinfo मुख्य प्रलेखन प्रणाली है।<ref>{{cite web |title=मैन पेज (जीएनयू कोडिंग मानक)|url=https://www.gnu.org/prep/standards/html_node/Man-Pages.html |website=www.gnu.org |access-date=2023-03-05 |archive-date=2023-03-05 |archive-url=https://web.archive.org/web/20230305170922/https://www.gnu.org/prep/standards/html_node/Man-Pages.html |url-status=live }}</ref> [[ pandoc | पंडोक]], रोन और एमडी2मैन सहित कई टूल [[ markdown | मार्कडाउन]] से मैन्युअल पेजों में रूपांतरण का समर्थन करते हैं। ये सभी उपकरण उत्सर्जित करते हैं {{code|man}} प्रारूप, क्योंकि मार्कडाउन शब्दार्थ सामग्री से मेल खाने के लिए पर्याप्त अभिव्यंजक नहीं है {{code|mdoc}}. मैंडॉक के लेखक के अनुसार, [[डॉकबुक]] में एक इनबिल्ट मैन (7) कन्वर्टर है-जो कि खराब गुणवत्ता का है<ref>{{cite web |author=Ingo Schwarze |title=नया मैंडॉक-एमडीओसी-टी मार्कडाउन कन्वर्टर|url=https://undeadly.org/cgi?action=article&sid=20170304230520 |website=undeadly.org |access-date=2023-03-05 |archive-date=2023-03-05 |archive-url=https://web.archive.org/web/20230305170920/https://undeadly.org/cgi?action=article&sid=20170304230520 |url-status=live }} &ndash; for specific complaints by the author, see {{cite mailing list |url=https://lists.gnu.org/archive/html/groff/2014-02/msg00109.html |title=Re: Groff man pages (tangential to Future Redux) |author=Ingo Schwarze |date=28 February 2014 |mailing-list=Groff |archive-url=https://web.archive.org/web/20230305171936/https://lists.gnu.org/archive/html/groff/2014-02/msg00109.html |archive-date=2023-03-05 |url-status=live}}</ref> जिन्होंने एक अलग mdoc(7) कन्वर्टर लिखा था।


मैन पेज आमतौर पर अंग्रेजी में लिखे जाते हैं, लेकिन सिस्टम पर अन्य भाषाओं में अनुवाद उपलब्ध हो सकते हैं। जीएनयू {{code|man-db}} और मैंडॉक {{code|man}} को उपनिर्देशिकाओं के अंतर्गत स्थानीयकृत मैन्युअल पृष्ठों की खोज करने के लिए जाना जाता है।<ref>{{cite web |title=कमांड लाइन - विभिन्न भाषाओं में लिनक्स मैन पेज|url=https://askubuntu.com/a/1113662 |website=Ask Ubuntu |access-date=2020-05-05 |archive-date=2023-03-11 |archive-url=https://web.archive.org/web/20230311130846/https://askubuntu.com/questions/1113648/linux-man-pages-in-different-languages/1113662 |url-status=live }}</ref><ref name="mk">{{man|1|man|ManKier}}</ref><ref name="FBSD" />
मैन पेज आमतौर पर अंग्रेजी में लिखे जाते हैं, लेकिन सिस्टम पर अन्य भाषाओं में अनुवाद उपलब्ध हो सकते हैं। जीएनयू {{code|man-db}} और मैंडॉक {{code|man}} को उपनिर्देशिकाओं के अंतर्गत स्थानीयकृत मैन्युअल पृष्ठों की खोज करने के लिए जाना जाता है।<ref>{{cite web |title=कमांड लाइन - विभिन्न भाषाओं में लिनक्स मैन पेज|url=https://askubuntu.com/a/1113662 |website=Ask Ubuntu |access-date=2020-05-05 |archive-date=2023-03-11 |archive-url=https://web.archive.org/web/20230311130846/https://askubuntu.com/questions/1113648/linux-man-pages-in-different-languages/1113662 |url-status=live }}</ref><ref name="mk">{{man|1|man|ManKier}}</ref><ref name="FBSD" />
=== विकल्प ===
=== विकल्प ===
के लिए कुछ विकल्प <code>man</code> जीएनयू प्रोजेक्ट|जीएनयू प्रोजेक्ट के संभावित अपवाद के साथ, बहुत लोकप्रियता का आनंद लिया है<code>[[Texinfo|info]]</code>प्रणाली, एक प्रारंभिक और सरल [[हाइपरटेक्स्ट]] प्रणाली। एक तृतीय-पक्ष प्रयास भी है जिसे TLDR पेज के रूप में जाना जाता है (<code>tldr</code>) जो [[ प्रवंचक पत्रक ]] के समान सामान्य उपयोग के मामलों के लिए सरल उदाहरण प्रदान करता है।<ref>{{cite web |title=टीएलडीआर पृष्ठ|url=https://tldr.sh/ |website=tldr.sh |access-date=2020-05-05 |archive-date=2020-04-27 |archive-url=https://web.archive.org/web/20200427081953/https://tldr.sh/ |url-status=live }}</ref>
के लिए कुछ विकल्प <code>man</code> जीएनयू प्रोजेक्ट|जीएनयू प्रोजेक्ट के संभावित अपवाद के साथ, बहुत लोकप्रियता का आनंद लिया है<code>[[Texinfo|info]]</code>प्रणाली, एक प्रारंभिक और सरल [[हाइपरटेक्स्ट]] प्रणाली। एक तृतीय-पक्ष प्रयास भी है जिसे टीएलडीआर पेज के रूप में जाना जाता है (<code>tldr</code>) जो [[ प्रवंचक पत्रक ]] के समान सामान्य उपयोग के मामलों के लिए सरल उदाहरण प्रदान करता है।<ref>{{cite web |title=टीएलडीआर पृष्ठ|url=https://tldr.sh/ |website=tldr.sh |access-date=2020-05-05 |archive-date=2020-04-27 |archive-url=https://web.archive.org/web/20200427081953/https://tldr.sh/ |url-status=live }}</ref>
इसके अलावा, कुछ यूनिक्स [[ ग्राफिकल यूज़र इंटरफ़ेस ]] एप्लिकेशन (विशेष रूप से वे जो [[सूक्ति]] और [[ कहाँ ]] विकास वातावरण का उपयोग करके बनाए गए हैं) अब एचटीएमएल में एंड-यूजर प्रलेखन प्रदान करते हैं और इसमें एम्बेडेड एचटीएमएल व्यूअर शामिल हैं जैसे <code>yelp</code> आवेदन के भीतर मदद पढ़ने के लिए। [[Emacs]] में एक HTML सिस्टम भी texinfo को बदलने के लिए तैयार है।<ref>{{cite web |title=Re: [Groff] man pages (tangential to Future Redux) |url=https://lists.gnu.org/archive/html/groff/2014-02/msg00104.html |website=lists.gnu.org |access-date=2023-03-05 |archive-date=2023-03-05 |archive-url=https://web.archive.org/web/20230305171106/https://lists.gnu.org/archive/html/groff/2014-02/msg00104.html |url-status=live }}</ref>
इसके अलावा, कुछ यूनिक्स [[ ग्राफिकल यूज़र इंटरफ़ेस ]] एप्लिकेशन (विशेष रूप से वे जो [[सूक्ति]] और [[ कहाँ ]] विकास वातावरण का उपयोग करके बनाए गए हैं) अब एचटीएमएल में एंड-यूजर प्रलेखन प्रदान करते हैं और इसमें एम्बेडेड एचटीएमएल व्यूअर सम्मिलित हैं जैसे <code>yelp</code> आवेदन के भीतर मदद पढ़ने के लिए। [[Emacs]] में एक एचटीएमएल सिस्टम भी texinfo को बदलने के लिए तैयार है।<ref>{{cite web |title=Re: [Groff] man pages (tangential to Future Redux) |url=https://lists.gnu.org/archive/html/groff/2014-02/msg00104.html |website=lists.gnu.org |access-date=2023-03-05 |archive-date=2023-03-05 |archive-url=https://web.archive.org/web/20230305171106/https://lists.gnu.org/archive/html/groff/2014-02/msg00104.html |url-status=live }}</ref>
== यह भी देखें ==
== यह भी देखें ==
* [[यूनिक्स कमांड की सूची]]
* [[यूनिक्स कमांड की सूची]]

Revision as of 09:57, 5 July 2023

330x330px से है

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

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

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

इतिहास

एक्स मैन, मैन्युअल पृष्ठों को देखने के लिए एक प्रारंभिक X11 अनुप्रयोग
ओपनबीएसडी सेक्शन 8 इंट्रो मैन पेज, एक टेक्स्ट कंसोल में प्रदर्शित

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

प्रलेखन के बाद के संस्करणों ने पहले मैन पेजों की संक्षिप्तता की नकल की। रिची ने संस्करण 3 यूनिक्स परिचय के लिए कैसे शुरू करें अनुभाग जोड़ा, और लोरिंडा चेरी ने संस्करण 6 यूनिक्स और संस्करण 7 यूनिक्स संस्करणों के लिए पर्पल कार्ड पॉकेट संदर्भ प्रदान किया।[2] सॉफ़्टवेयर के संस्करण मैनुअल के संशोधन के बाद नामित किए गए थे; यूनिक्स प्रोग्रामर मैनुअल का सातवां संस्करण, उदाहरण के लिए, यूनिक्स के 7वें संस्करण या संस्करण 7 के साथ आया था।[4]

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

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

स्वरूपण

फ्रीबीएसडी का हिस्सा मैनुअल पेज, संवहन दस्तावेज़ स्वरूप फॉर्मेट में टाइपसेट

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

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

जीएनयू ईएमएसीएस प्रोग्राम वू मैन (विदआउट मैन से) संपादक से मैन पेज ब्राउज़ करने की अनुमति देता है।[9]

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

ऑनलाइन सेवाएं

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

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

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

कमांड उपयोग

यूनिक्स कमांड के लिए मैन्युअल पेज पढ़ने के लिए, उपयोगकर्ता टाइप कर सकता है: 

man <command_name>

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

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

सोलारिस और इलुमोस पर, उदाहरण के लिए, पढ़ने के लिए सिंटैक्स printf(3C) है: 

man -s 3c printf

लिनक्स और बीएसडी डेरिवेटिव पर समान मंगलाचरण होगा: 

man 3 printf

जो मैन पेज के सेक्शन 3 में प्रिंट एफ की खोज करता है।

मैनुअल सेक्शन

मैनुअल को आम तौर पर आठ क्रमांकित वर्गों में विभाजित किया जाता है, जो निम्नानुसार व्यवस्थित होता है (अनुसंधान यूनिक्स, बीएसडी, मैकोज़। लिनक्स, और ओरेकल सोलारिस 11.4 पर):[15][16][17][18]

अनुभाग विवरण
1 सामान्यआदेश
2 सिस्टम कॉल
3 पुस्तकालय कार्य, विशेष रूप से सी मानक पुस्तकालय को कवर करते हुए
4 विशेष फ़ाइलें (आमतौर पर उपकरण, जो /dev में पाए जाते हैं) और ड्राइवरों
5 फ़ाइल प्रारूप और परंपराएँ
6 गेम्स और स्क्रीनसेवर
7 मिश्रित
8 सिस्टम प्रशासन आदेश और डेमॉन

पॉज़िक्स एपीआई दोनों सेक्शन 2 और 3 में मौजूद हैं, जहाँ सेक्शन 2 में वे एपीआई सम्मिलित हैं जिन्हें सिस्टम कॉल के रूप में लागू किया गया है और सेक्शन 3 में वे एपीआईसम्मिलित हैं जिन्हें लाइब्रेरी रूटीन के रूप में लागू किया गया है।

यूनिक्स सिस्टम वी एक अलग क्रम को छोड़कर एक समान नंबरिंग योजना का उपयोग करता है:[19]

अनुभाग विवरण
1 General commands
1M सिस्टम प्रशासन आदेश और डेमॉन
2 सिस्टम कॉल
3 सी लाइब्रेरी फ़ंक्शंस
4 फ़ाइल प्रारूप और परंपराएँ
5 अनेक वस्तुओं का संग्रह
6 खेल और स्क्रीनसेवर
7 विशेष फ़ाइलें (आमतौर पर उपकरण, जो /dev में पाए जाते हैं) और ड्राइवरों

कुछ प्रणालियों पर निम्नलिखित में से कुछ खंड उपलब्ध हैं:

अनुभाग विवरण
0 सी लाइब्रेरी हेडर फ़ाइलें (यूनिक्स v6)
9 कर्नेल दिनचर्या (फ्रीबीएसडी, एसवीआर4, लिनक्स)[18][16]
l लैपैक पुस्तकालय कार्य [20]
n टीसीएल/टीके कमांड
x एक्स विंडो सिस्टम

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

उपधारा विवरण
p पॉज़िक्स विशेष विवरण
x एक्स विंडो सिस्टम दस्तावेज़ीकरण

(धारा 3 अलग-अलग भाषाओं के कई प्रत्ययों के साथ अपवाद है।)

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

लेआउट

सभी मैन पेज एक सामान्य लेआउट का अनुसरण करते हैं जो एक साधारण एएससीआईआई पाठ प्रदर्शन पर प्रस्तुति के लिए अनुकूलित है, संभवतः बिना किसी प्रकार के हाइलाइटिंग या फ़ॉन्ट नियंत्रण के। मौजूद वर्गों में सम्मिलित हो सकते हैं:[21]

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

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

संलेखन

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

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

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

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

विकल्प

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

यह भी देखें

संदर्भ

  1. ↑ "man(1) — display online manual documentation pages". BSD Cross Reference. FreeBSD. Archived from the original on 2023-03-11. Retrieved 2019-04-01. मैन यूटिलिटी ऑनलाइन मैनुअल डॉक्यूमेंटेशन पेज ढूंढती और प्रदर्शित करती है।
  2. ↑ 2.0 2.1 2.2 McIlroy, M. D. (1987). A Research Unix reader: annotated excerpts from the Programmer's Manual, 1971–1986 (PDF) (Technical report). CSTR. Bell Labs. 139. Archived (PDF) from the original on 2017-11-11. Retrieved 2015-02-01.
  3. ↑ 3.0 3.1 Darwin, Ian; Collyer, Geoffrey. "UNIX Evolution: 1975-1984 Part I - Diversity". Archived from the original on 17 July 2012. Retrieved 22 December 2012. Originally published in Microsystems 5(11), November 1984.
  4. ↑ Fiedler, Ryan (October 1983). "The Unix Tutorial / Part 3: Unix in the Microcomputer Marketplace". BYTE. p. 132. Retrieved 30 January 2015.
  5. ↑ "GIT commit 002a6339b1fe8f83f4808022a17e1aa379756d99". Archived from the original on 4 December 2017. Retrieved 22 November 2017.
  6. ↑ "GIT commit 84bde8d8a9a357bd372793d25746ac6b49480525". Archived from the original on 5 September 2018. Retrieved 22 November 2017.
  7. ↑ "GIT commit b225d9e76fbb0a6a4539c0992fba88c83f0bd37e". Archived from the original on 9 November 2020. Retrieved 25 September 2018.
  8. ↑ ""Why does man print "gimme gimme gimme" at 00:30?"". Archived from the original on 21 November 2017. Retrieved 22 November 2017.
  9. ↑ Wright, Francis J. "WoMan: Browse Unix Manual Pages "W.O. (without) Man"". GNU. Archived from the original on 11 November 2020. Retrieved 3 August 2020.
  10. ↑ Pali, Gabor, ed. (12 May 2013). "FreeBSD Quarterly Status Report, January-March 2013". FreeBSD. Archived from the original on 22 December 2014. Retrieved 25 December 2014.
  11. ↑ Murenin, Constantine A. (19 February 2013). "mdoc.su की घोषणा, छोटे मैनुअल पेज यूआरएल". freebsd-doc@freebsd.org (Mailing list). Archived from the original on 7 August 2014. Retrieved 25 December 2014.
  12. ↑ Murenin, Constantine A. (23 February 2013). "mdoc.su — Short manual page URLs for FreeBSD, OpenBSD, NetBSD and DragonFly BSD". Archived from the original on 17 December 2014. Retrieved 25 December 2014.
  13. ↑ "लिनक्स मैन पेज ऑनलाइन". man7.org. Archived from the original on 2020-05-07. Retrieved 2020-05-05.
  14. ↑ "के बारे में". ManKier. Archived from the original on 2020-04-25. Retrieved 2020-05-05.
  15. ↑ 15.0 15.1 man(1) – Linux General Commands Manual
  16. ↑ 16.0 16.1 16.2 man(1) – FreeBSD General Commands Manual
  17. ↑ "रिसर्च यूनिक्स आठवें संस्करण के लिए मैनुअल पेज". man.cat-v.org. Archived from the original on 2020-06-30. Retrieved 2020-05-06.
  18. ↑ 18.0 18.1 "यूनिक्स प्रोग्रामर मैनुअल - परिचय". www.bell-labs.com. November 3, 1971. Archived from the original on June 1, 2020. Retrieved May 6, 2020.
  19. ↑ "System V release 4 manuals". bitsavers.trailing-edge.com. Archived from the original on 2020-08-03. Retrieved 2020-05-06.
  20. ↑ "lapack (l) - Linux Man Pages". www.systutorials.com. Archived from the original on 2023-03-11. Retrieved 2021-05-29.
  21. ↑ 21.0 21.1 mdoc(7) – FreeBSD Miscellaneous Information Manual
  22. ↑ groff_tmac(5) – Linux File Formats Manual
  23. ↑ man(7) – Linux Miscellanea Manual
  24. ↑ "Groff Mission Statement - 2014". www.gnu.org. Archived from the original on 2020-12-03. Retrieved 2021-01-02. Concurrent with work on man(7), mdoc(7) will be actively supported and its use promoted.
  25. ↑ "आदमी". The GNU Troff Manual. Archived from the original on 24 December 2019. Retrieved 31 December 2019.
  26. ↑ "नोश यूजर-स्पेस वर्चुअल टर्मिनल पर मैनुअल पेजों में इटैलिक और रंग". jdebp.eu. Archived from the original on 2021-01-28. Retrieved 2021-01-21.
  27. ↑ mandoc(1) – FreeBSD General Commands Manual. "Font styles are applied by using back-spaced encoding..."
  28. ↑ "help2man Reference Manual". Archived from the original on 6 March 2023. Retrieved 5 March 2023.
  29. ↑ "मैन पेज (जीएनयू कोडिंग मानक)". www.gnu.org. Archived from the original on 2023-03-05. Retrieved 2023-03-05.
  30. ↑ Ingo Schwarze. "नया मैंडॉक-एमडीओसी-टी मार्कडाउन कन्वर्टर". undeadly.org. Archived from the original on 2023-03-05. Retrieved 2023-03-05. – for specific complaints by the author, see Ingo Schwarze (28 February 2014). "Re: Groff man pages (tangential to Future Redux)". Groff (Mailing list). Archived from the original on 2023-03-05.
  31. ↑ "कमांड लाइन - विभिन्न भाषाओं में लिनक्स मैन पेज". Ask Ubuntu. Archived from the original on 2023-03-11. Retrieved 2020-05-05.
  32. ↑ "टीएलडीआर पृष्ठ". tldr.sh. Archived from the original on 2020-04-27. Retrieved 2020-05-05.
  33. ↑ "Re: [Groff] man pages (tangential to Future Redux)". lists.gnu.org. Archived from the original on 2023-03-05. Retrieved 2023-03-05.


बाहरी संबंध

The Wikibook Guide to Unix has a page on the topic of: Commands
Retrieved from ‘https://www.vigyanwiki.in/index.php?title=मैन_पेज&oldid=210650’