맨 페이지를 만드는 방법은 무엇입니까?

우분투 프로그램을 패키징하고 있으며 바이너리에 맨 페이지가 필요하다는 lintian 경고가 표시됩니다.

프로그램의 맨 페이지를 만드는 방법은 무엇입니까?

Gmanedit 의 도움으로 그래픽 GUI를 사용하여 맨 페이지를 만들 수 있습니다.

Gtk + 맨 페이지 편집기는 GTK +로 X에서 실행되는 맨 페이지 용 편집기입니다.

Gmanedit는 Linux / Unix 시스템에서 매뉴얼 페이지 (man)를 편집 할 수있는 응용 프로그램입니다.

가장 일반적인 HTML 편집기와 비슷하지만 더 쉽습니다. 맨 페이지 형식을 알아야합니다.

데비안 FHS 사용자 프로그램 에 따르면 맨 페이지는 usr/share/man/man1또는에 저장되어 usr/local/share/man/man1있습니다.

맨 페이지를 변경 한 후 mandb터미널에서 실행하여 맨 페이지 데이터베이스를 업데이트하는 것이 좋습니다 .

맨 페이지 구문에 대한 자세한 내용 은 man의 맨 페이지에 요약 되어 있습니다.

XML 문서 형식 인 docbook / refentry로 맨 페이지를 작성할 수 있습니다.

<?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을 작성한 경우 구문을 이미 알고 있으면 사용할 태그를 학습하는 것입니다.

내가 방금 올린 소용돌이를 줘. 나는 많은 앱을 작성하고 괜찮은 맨 페이지 편집기에 문제가있었습니다.

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

이것은 각 섹션마다 별도의 탭이있는 gtk2 응용 프로그램입니다. 가져 오기 맨 페이지 미리보기 및 내보내기가 모두 지원되며, 난해한 형식 지정 명령은 없습니다.

autotools로 할 수 있습니다. GNU는 C 프로젝트가 autotools로 맨 페이지를 설치하는 예제를 발표했습니다.