Sex, 2008-06-06 às 10:11 +0100, Daniel P. Berrange escreveu:
On Thu, Jun 05, 2008 at 08:50:00AM +0100, Pedro Silva wrote:
Hi!
I started the man page for the livecd-iso-to-disk, I used this guide[1] to do it.
Since this is my first man page ever, shout if I made some terribly mistake.
???[1] http://www.schweikhardt.net/man_page_howto.html
Thoughts, tips?
Personally I always recommend avoiding NROFF as your master format when writing man pages since it is seriously unpleasant to read as an author. I don't know what Jeremy's thoughts are on the topic, but even though this is python code, you might like to consider writing it using POD (Perl's native documentation format) which is a easily readable plain text markup you can embed in shell/python/perl/etc source files, or just have in a standalone text file. You can process this using pod2man to generate the NROFF formatted man page, as well as also having access to pod2html to produce online HTML version, or pod2text for a completely plain text version.
Daniel, thanks for input.
I'm happy to jump format as long as I land in a format I can use and is accepted by other Fedora projects.
The HOWTO that I used was the first hit in google with "how to make a man page linux". After reading your message, I searched for this kind of info in fedora's wiki but I don't think there is any page about a "standard" way of doing man pages for fedora.
If there are no objections, I'll make livecd-tool's man pages using POD markup language.
Jeremy, your input about the sections will also be taken into account. :)
Best regards,