Date: Wed, 8 Jun 2005 17:19:52 +0300 From: Giorgos Keramidas <keramida@ceid.upatras.gr> To: brian.barto@spectrum-health.org Cc: freebsd-questions@freebsd.org Subject: Re: How to create a man page? Message-ID: <20050608141952.GA2744@orion.daedalusnetworks.priv> In-Reply-To: <B6532FAEDD53D94ABDBFB24C35EF77300A34EFE0@dcmsmsg01.spectrum-health.org> References: <B6532FAEDD53D94ABDBFB24C35EF77300A34EFE0@dcmsmsg01.spectrum-health.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On 2005-06-08 09:53, brian.barto@spectrum-health.org wrote: > Hi all. I am writing a program with hopes to submit it for inclusion > to the ports collection. My last step is to include a man page for my > program. Man pages look to be some sort of markup language. What is > the standard way to create a man page? Just typing the text in a plain ASCII file is sufficient. > Is there some sort of wysiwyg or some other program that makes them > easy to create? Not really. Most of the "rules" for writing a well formatted manpage are picked up by osmosis; by reading existing manpages and looking at the diffs committed by more experienced manpage authors. FYI, The reference for groff mdoc macros, which are the preferred way of writing manpages for FreeBSD, is the groff_mdoc(7) manpage. If you have the text of the manpage, you can always ask the freebsd-doc people to review the manpage text and/or formatting.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20050608141952.GA2744>