Re: Creating man pages (upstream does not have one)

To: debian-mentors@lists.debian.org
Subject: Re: Creating man pages (upstream does not have one)
From: Jérôme Marant <jerome.marant@free.fr>
Date: Thu, 10 May 2001 21:42:51 +0200 (MEST)
Message-id: <989523771.3afaef3b2fc6d@imp.free.fr>
In-reply-to: <3AFAE36E.DE46C49A@unesco.org.uy>
References: <Pine.SOL.4.21.0105101322060.5682-100000@acmex.gatech.edu> <871ypxozkd.fsf@arabella.intern.opera.no> <3AFAE36E.DE46C49A@unesco.org.uy>

En réponse à Eduardo Trapani <etrapani@unesco.org.uy>:

> 
> The software I am packaging does not have a man page.
> 
> What programs should I use to create one?

  I would recommend to write them in the POD (Plain Old Documentation)
  format which makes it very seasy to write/update a man page.
  (see http://qa.debian.org/man-pages.html for pointers to documentations).

  I would NOT recommend to use the native manpage format (nroff) nor the
  DocBook SGML format since writing a manpage with them is rather
  respectively confusing/painful, IMHO.

Jérôme.

Reply to:

Follow-Ups:
- Re: Creating man pages (upstream does not have one)
  - From: Othmar Pasteka <pasteka@kabsi.at>

References:
- My First Package. Wheee.
  - From: Warren Anthony Stramiello <gte704i@prism.gatech.edu>
- Re: My First Package. Wheee.
  - From: Tollef Fog Heen <tollef@add.no>
- Creating man pages (upstream does not have one)
  - From: Eduardo Trapani <etrapani@unesco.org.uy>

Prev by Date: Re: Creating man pages (upstream does not have one)
Next by Date: Re: Creating man pages (upstream does not have one)
Previous by thread: Re: Creating man pages (upstream does not have one)
Next by thread: Re: Creating man pages (upstream does not have one)
Index(es):
- Date
- Thread