creating man pages

[Paul W. Frields]

On Wed, Nov 26, 2008 at 04:17:54PM +0100, Gergely Buday wrote:
> Hi there,
> 
> what is the standard way to create man pages in Fedora? There is a
> constraint: the package maintainer would like to see the original .txt
> version as well.
> 
> Is docbook the way? If yes, which docbook tool should I use?

You can use any editor you like with DocBook.  An editor that provides
validation of XML files works best, which includes Emacs, vi, Kate,
XMLmind, Eclipse WebTools, and many others -- but you have to learn
that functionality before validation will matter to you.  You can just
use Gedit or Kate for now and ask for assistance if you run into
problems.

There is also a docbook2man program in the docbook-utils package.  You
will probably want to install the documentation group using this
command:

$ su -c 'yum groupinstall "Authoring and Publishing"'

-- 
Paul W. Frields                                http://paul.frields.org/
  gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
  http://redhat.com/   -  -  -  -   http://pfrields.fedorapeople.org/
  irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20081126/9d276376/attachment.sig>