Wie erstelle ich eine Manpage?

29

Ich packe ein Programm für Ubuntu und bekomme eine Lintian-Warnung, die besagt, dass meine Binärdatei eine Manpage benötigt.

Wie erstellt man eine Manpage für ein Programm?

Trampster
quelle

Antworten:

23

Mit Hilfe von Gmanedit können Installieren Sie gmanedit Sie Hilfeseiten mit einer grafischen Benutzeroberfläche erstellen.

Der Gtk + Manpages Editor ist ein Editor für Manpages, die mit GTK + auf X ausgeführt werden.

Gmanedit ist eine Anwendung, mit der Sie Manualpages (man) auf Linux / Unix-Systemen bearbeiten können.

Es ist wie die meisten gängigen HTML-Editoren, jedoch einfacher. Sie müssen das Manpages-Format kennen.

Bildbeschreibung hier eingeben

Entsprechend dem Debian-FHS- Benutzerprogramm sind Hilfeseiten in usr/share/man/man1oder gespeichert usr/local/share/man/man1.

Nach dem Ändern der Hilfeseiten kann es sinnvoll sein, die Hilfeseitendatenbank durch Ausführen mandbin einem Terminal zu aktualisieren .

Details zur Manpage-Syntax sind in der Manpage for Man zusammengefasst .

Takkat
quelle
Klar hast du recht. Ich wollte es ändern, aber als ich MarcoCeppi dort sah, wollte ich es nicht ändern. : D
Lucio
@ Lucio lol - das war aus einer Zeit, als es noch keine apps.ubuntu gab;)
Takkat
3

Sie können Hilfeseiten in docbook / refentry, einem XML-Dokumentationsformat, schreiben.

<?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>
    :

und konvertieren Sie dann die Ergebnisse in das MAN-Format mit

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

zu html mit

docbook2html docbook2html

und so weiter. Dies ist nicht der einfachste Weg, eine Manpage zu schreiben. Wenn Sie jedoch zuvor XML geschrieben haben, kennen Sie die Syntax bereits. Sie müssen lediglich die zu verwendenden Tags erlernen.

jjg
quelle
2

Probieren Sie es aus, ich habe es gerade hochgeladen. Ich habe eine Reihe von Apps geschrieben und Probleme mit einem anständigen Manpage-Editor

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

Dies ist eine gtk2-App mit einer separaten Registerkarte für jeden Abschnitt. Das Importieren von Hilfeseiten in der Vorschau und das Exportieren werden unterstützt. Es gibt keine esoterischen Formatierungsbefehle. Dies befindet sich noch in der Entwicklung, ist jedoch mit Sicherheit stabil genug, um verwendet zu werden.

Tony Duncun
quelle
1
Diese Anwendung sieht interessant aus. Könnten Sie hier etwas mehr Details angeben als nur einen Link?
Kevin Bowen
Dies ist eine gtk2-App mit einer separaten Registerkarte für jeden Abschnitt. Das Importieren von Hilfeseiten in der Vorschau und das Exportieren werden unterstützt. Es gibt keine esoterischen Formatierungsbefehle. Dies befindet sich noch in der Entwicklung, ist jedoch mit Sicherheit stabil genug, um verwendet zu werden.
Tony Duncun
0

Sie können es mit Autotools tun. GNU hat ein Beispiel veröffentlicht, in dem ein C-Projekt eine Manpage mit Autotools installiert.

Niklas Rosencrantz
quelle