Як створити manpage?

Я пакую програму для ubuntu, і я отримую лінійське попередження про те, що моє бінарне потребує вкладки.

Як можна створити набір сторінки для програми?

За допомогою Gmanedit ви можете створити керівництво з графічним графічним інтерфейсом.

Gtk + Manpages Editor - це редактор довідкових сторінок, який працює на X із GTK +.

Gmanedit - це програма, яка дозволяє редагувати сторінки керівництва (man) на системах Linux / Unix.

Це як більшість звичайних редакторів HTML, але простіше. Вам потрібно знати формат рукописних сторінок.

Згідно з користувацькою програмою Debian FHS, Manpages зберігаються в usr/share/man/man1або usr/local/share/man/man1.

Після зміни manpages може бути розумно оновити базу даних manpage, запустивши mandbв терміналі.

Деталі про синтаксис manpage узагальнені у розділі man man для людини .

Ви можете писати довідки в docbook / повторне використання, у форматі документації 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>
    :

а потім конвертувати результати у формат man за допомогою

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

в html з

docbook2html docbook2html

і так далі. Це не найпростіший спосіб написання сторінки, але якщо ви написали XML раніше, то вже знаєте синтаксис, це лише питання вивчення тегів для використання.

Дайте цей вир, я щойно завантажив його, я написав ряд додатків і виникли проблеми з гідним редактором сторінки

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

Це програма gtk2 з окремою вкладкою для кожного розділу, що імпортує керовані вікнами попереднього перегляду та експорту, всі підтримуються, без команд форматування езотеричного форматування, це ще розробляється, але, безумовно, досить стабільне для використання.

Це можна зробити за допомогою автоінструментів. GNU опублікував приклад, коли проект C встановлює команду з автоінструментами.