Je compile un programme pour Ubuntu, et je reçois un avertissement lintian disant que mon binaire a besoin d'une page de manuel.
Comment créer une page de manuel pour un programme?
Avec l'aide de Gmanedit, vous pouvez créer des pages de manuel avec une interface graphique.
Gtk + Manpages Editor est un éditeur de pages de manuel qui s'exécute sur X avec GTK +.
Gmanedit est une application qui vous permet d'éditer des pages de manuel (man) sur les systèmes Linux / Unix.
C'est comme la plupart des éditeurs HTML courants mais plus facile. Vous devez connaître le format des pages de manuel.
Selon le programme utilisateur Debian FHS, les pages de manuel sont stockées dans usr/share/man/man1
ou usr/local/share/man/man1
.
Après avoir modifié les pages de manuel, il peut être judicieux de mettre à jour la base de données de pages de manuel en exécutant mandb
dans un terminal.
Les détails de la syntaxe de la page de manuel sont résumés dans la page de manuel de man .
Vous pouvez écrire des pages de manuel dans docbook / refentry, un format de documentation XML,
puis convertir les résultats au format man en utilisant
en html avec
etc. Ce n'est pas le moyen le plus simple d'écrire une page de manuel, mais si vous avez déjà écrit du XML auparavant, vous connaissez déjà la syntaxe, il s'agit simplement d'apprendre les balises à utiliser.
la source
Donnez-lui un tourbillon Je viens de le télécharger, j'écris un certain nombre d'applications et j'ai eu des problèmes avec un éditeur de page de manuel décent
http://gtk-apps.org/content/show.php/Man+Page+Editor+?content=160219
Il s'agit d'une application gtk2 avec un onglet distinct pour chaque section. L'importation et la prévisualisation des pages de manuel sont toutes prises en charge, aucune commande de formatage ésotérique, elle est toujours en cours de développement mais est certainement suffisamment stable pour être utilisée.
la source
Vous pouvez le faire avec les outils automatiques. GNU a publié un exemple où un projet C installe une page de manuel avec des outils automatiques.
la source