मैनपेज कैसे बनाये?

Question

मैं उबंटु के लिए एक कार्यक्रम की पैकेजिंग कर रहा हूं, और मुझे एक लिंटियन चेतावनी मिल रही है जिसमें कहा गया है कि मेरे बाइनरी को मैनपेज की आवश्यकता है।

किसी प्रोग्राम के लिए एक मैनपेज बनाने के बारे में कैसे जाना जाता है?

Answer 1

Gmanedit की मदद से आप ग्राफिकल GUI के साथ मैनपेेज बनाने में सक्षम हैं।

Gtk + Manpages Editor मैन पृष्ठों के लिए एक संपादक है जो GTK + के साथ X पर चलता है।

Gmanedit एक एप्लिकेशन है जो आपको लिनक्स / यूनिक्स सिस्टम पर मैनुअल पेज (मैन) को संपादित करने की अनुमति देता है।

यह सबसे आम HTML संपादकों की तरह है लेकिन अधिक आसान है। आपको मैनपावर फॉर्मेट को जानना होगा।

डेबियन FHS उपयोगकर्ता कार्यक्रम के अनुसार manpages में संग्रहीत usr/share/man/man1या हैं usr/local/share/man/man1।

मैनपेज बदलने के बाद mandbटर्मिनल में चलकर मैनपेज डेटाबेस को अपडेट करना समझदारी हो सकती है ।

मैनपेज सिंटैक्स पर विवरण मैन के लिए मैनपेज में संक्षेपित हैं ।

Comments

ज़रूर, तुम सही हो। मैं इसे बदलने जा रहा था, लेकिन जैसे ही मैंने मार्कोसीपी को देखा, मैं इसे संशोधित नहीं करना चाहता था। : डी

— लुसियो

@ लूसियो लोल - वह समय से वापस आ गया था, जब कोई ऐप नहीं था। जुबांट अभी तक;)

— टेककैट

Answer 2

आप docbook / refentry में XML दस्तावेज़ प्रारूप में मैनपेज़ लिख सकते हैं,

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<refentry id='vfplot1'>
<refentryinfo><date>1 July 2008</date></refentryinfo>
<refmeta>
<refentrytitle>VFPLOT</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class='date'>1 July 2008</refmiscinfo>
</refmeta>
<refnamediv id='name'>
<refname>vfplot</refname>
<refpurpose>plot vector fields with curved arrows.</refpurpose>
</refnamediv>
<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
  <command>vfplot</command>    
  <arg choice='opt'>-a <replaceable>aspect</replaceable></arg>
  <arg choice='opt'>-d <replaceable>file</replaceable></arg>
  <arg choice='opt'>-D <replaceable>pen</replaceable></arg>
    :

और फिर परिणाम का उपयोग करके मैन फॉर्मेट में परिवर्तित करें

xsltproc /path/to/docbook.xsl vfplot.xml

HTML के साथ

docbook2html docbook2html

और इसी तरह। यह मैनपेज लिखने का सबसे आसान तरीका नहीं है, लेकिन अगर आपने पहले XML लिखा है तो आप पहले से ही सिंटैक्स जानते हैं, यह केवल टैग सीखने के लिए उपयोग करना है।

Answer 3

यह एक चक्कर दे दो मैंने अभी इसे अपलोड किया है मैं कई ऐप लिखता हूं और एक सभ्य मैनपेज संपादक के साथ परेशानी हो रही है

http://gtk-apps.org/content/show.php/Man+Page+Editor+?content=160219

यह प्रत्येक अनुभाग के लिए एक अलग टैब के साथ एक gtk2 ऐप है, जिसका पूर्वावलोकन करने और निर्यात करने वाले सभी अनुभाग समर्थित हैं, कोई गूढ़ स्वरूपण आदेश नहीं है, यह अभी भी विकास के अधीन है लेकिन निश्चित रूप से उपयोग करने के लिए पर्याप्त स्थिर है।

Comments

यह आवेदन दिलचस्प लग रहा है। क्या आप केवल एक लिंक की तुलना में थोड़ा और विस्तार दे सकते हैं?

— केविन बोवेन

यह प्रत्येक अनुभाग के लिए एक अलग टैब के साथ एक gtk2 ऐप है, जिसका पूर्वावलोकन करने और निर्यात करने वाले सभी अनुभाग समर्थित हैं, कोई गूढ़ स्वरूपण आदेश नहीं है, यह अभी भी विकास के अधीन है लेकिन निश्चित रूप से उपयोग करने के लिए पर्याप्त स्थिर है।

— टोनी डुनकुन

Answer 4

आप इसे ऑटोटूल से कर सकते हैं। जीएनयू ने उदाहरण प्रकाशित किया है जहां एक सी परियोजना ऑटोटूलस के साथ एक मैनपेज स्थापित करती है।