मैनपेज में सिनॉप्सिस को समझें

Question

मैं कमांड के मैनपेज में SYNOPSIS सेक्शन को समझ नहीं पाया हूं। उदाहरण के लिए, आइए manस्वयं का मैनपेज देखें । द्वारा man man:

SYNOPSIS
       man  [-C  file]  [-d]  [-D]  [--warnings[=warnings]]  [-R encoding] [-L
       locale] [-m system[,...]] [-M path] [-S list]  [-e  extension]  [-i|-I]
       [--regex|--wildcard]   [--names-only]  [-a]  [-u]  [--no-subpages]  [-P
       pager] [-r prompt] [-7] [-E encoding] [--no-hyphenation] [--no-justifi‐
       cation]  [-p  string]  [-t]  [-T[device]]  [-H[browser]] [-X[dpi]] [-Z]
       [[section] page ...] ...
       man -k [apropos options] regexp ...
       man -K [-w|-W] [-S list] [-i|-I] [--regex] [section] term ...
       man -f [whatis options] page ...
       man -l [-C file] [-d] [-D] [--warnings[=warnings]]  [-R  encoding]  [-L
       locale]  [-P  pager]  [-r  prompt]  [-7] [-E encoding] [-p string] [-t]
       [-T[device]] [-H[browser]] [-X[dpi]] [-Z] file ...
       man -w|-W [-C file] [-d] [-D] page ...
       man -c [-C file] [-d] [-D] page ...
       man [-hV]

1. क्या SYNOPSIS अनुभाग कमांड के लिए वाक्यविन्यास का वर्णन करता है?
2. उन [...]और [...]अंदर का क्या [...] मतलब है? क्या उनका मतलब कुछ वैकल्पिक है?
3. करता है |मतलब है या?
4. में क्या ,मतलब है [-m system[,...]]?
5. क्या SYNOPSIS अनुभाग नियमित एक्सप्रेशन के लिए उपयोग किए जाने वाले नियमों का पालन करता है?

Comments

संबंधित: "उपयोगिता सम्मलेन" POSIX मानक में: pubs.opengroup.org/onlinepubs/9699919799/basedefs/...

— Kusalananda

Answer 1

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

Comments

धन्यवाद! क्या कुछ संदर्भों को सिनॉप्सिस के सिंटैक्स की व्याख्या करते हैं?

— टिम

@ समय: यह उन लोगों में से एक है जिन्हें मैंने देखा है, मुझे लगता है कि अगर आप कुछ और पढ़ेंगे तो आपको इसका फायदा मिलेगा। यह सिर्फ कन्वेंशन है, जादू नहीं।

— कैलेब

Answer 2

यदि आप एक संदर्भ चाहते हैं, तो वे EBNF पर आधारित हैं ।

Answer 3

से manआदमी पेज:

---

निम्नलिखित सम्मेलन SYNOPSIS अनुभाग पर लागू होते हैं और अन्य अनुभागों में एक गाइड के रूप में उपयोग किए जा सकते हैं।

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

कमांड या फंक्शन इलस्ट्रेशन एक ऐसा पैटर्न है जो सभी संभव इनवोकेशन से मेल खाना चाहिए। कुछ मामलों में कई विशिष्ट चालानों को चित्रित करना उचित है जैसा कि इस मैनुअल पेज के SYNOPSIS अनुभाग में दिखाया गया है।

Answer 4

कमांड लाइन यूटिलिटी लॉजिक सिंटैक्स के अर्थ को समझने के लिए एक अन्य स्रोत अध्याय 12 में प्रलेखित उपयोगिता तर्क सिंटैक्स कन्वेंशन और POSIX.1-2008 (2013 संस्करण) मानक के अध्याय 9 में नियमित एक्सप्रेशन व्यक्त किए जाएंगे।