How to edit a man page for a command line utility in XCode..

I am designing a command line utility in Objective C in XCode. It
automatically generates a foo C.1 man page documentation file for my
utility but it is a bit hard to understand. It's a bunch of tags and
information following them. How do I edit this to reflect what my
command line utility is for? Is there a way to see what it would look
like as a man page?

Once it is edited, how do I install it as a man page. Could someone
point me to resources to find this out?

In article
<e5fe1b1e-658b-455c-b5ba-295a32da4011 RemoveThis @a7g2000yqk.googlegroups.com>,
commiebastard <oraclmaster RemoveThis @gmail.com> wrote:

> I am designing a command line utility in Objective C in XCode. It
> automatically generates a foo C.1 man page documentation file for my
> utility but it is a bit hard to understand. It's a bunch of tags and
> information following them. How do I edit this to reflect what my
> command line utility is for? Is there a way to see what it would look
> like as a man page?

"man roff" is probably a good place to start learning about the
formatting. There are dozens of examples in /usr/share/man/.

You can preview the man page from the file with:

groff -Tascii -man $FILE

> Once it is edited, how do I install it as a man page. Could someone
> point me to resources to find this out?

Man pages not included with the system typically go in
/usr/local/share/man/. As long as they're somewhere in the users
$MANPATH they'll work as expected.

--
Tom "Tom" Harrington
Independent Mac OS X developer since 2002
http://www.atomicbird.com/