<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">

<!--
	``MakeMan'' SGML Template for a man page
	For more Information, please see http://mama.sourceforge.net

	$Author: Jan Schaumann <jschauma@netmeister.org> $
	$Id: template.sgml, v 0.2 2001/08/24 11:18:34 jschauma Exp $
-->

<refentry id="name">
	<refmeta>
		<refentrytitle>name.pl</refentrytitle>
		<manvolnum>section</manvolnum>
		<refmiscinfo class="date">Month Day, Year</refmiscinfo>
		<refmiscinfo class="source">Package</refmiscinfo>
		<refmiscinfo class="title">Title</refmiscinfo>
	</refmeta>

	<refnamediv>
		<refname>name</refname>
		<refpurpose>short description</refpurpose>
	</refnamediv>

	<refsynopsisdiv>
		<cmdsynopsis>
			<command>name</command>
				<arg choice="opt" rep="repeat">OPTION</arg>
				<arg choice="req">FILE</arg>
		</cmdsynopsis>
	</refsynopsisdiv>

	<refsect1>
		<title>DESCRIPTION</title>
		<para>
			Write a long description in here.  Do not explain the details of
			the options, which will be below, but the general usage.
		</para>
		<para>
			<command>name</command> is usually written in bold when mentioned,
			<emphasis>References\</emphasis> in italics.
        </para>
	</refsect1>
	
	<refsect1>
		<title>USAGE</title>
		<para>
			Detailed usage.  If the program requires certain perparation
			before running, explain what needs to be done here.  Detailed
			explanation of unintuitive options may go here, as well.
		</para>
	</refsect1>
	
	<refsect1>
		<title>OPTIONS</title>
		<para>
			This program follows the usual GNU command line syntax,
            with long options starting with two dashes (`--'). A
            summary of the options supported by <command>name</command>
            is included below.
		</para>
		<variablelist>
			<varlistentry>
				<term>-h, --help</term>
				<listitem>
					<para>Show summary of options and exit.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>-v, --version</term>
				<listitem>
					<para>Show version information and exit.</para>
				</listitem>
			</varlistentry>
		</variablelist>
	</refsect1>
	
	<refsect1>
		<title>REQUIRES</title>
		<para>
			Prerequisites that need to be met for this program.
		</para>
	</refsect1>

	<refsect1>
		<title>VERSION</title>
		<para>
			Version Number
		</para>
	</refsect1>

	<refsect1>
		<title>BUGS</title>
		<para>
			Explain known bugs here.
		</para>
	</refsect1>

	<refsect1>
		<title>SEE ALSO</title>
		<para>
			<command>related(1)</command>
		</para>
		<para>
			<ulink url="http://somewhere.else">http://somewhere.else</ulink>
		</para>
	</refsect1>

	<refsect1>
		<title>AUTHOR</title>
		<para>
			Firstname Lastname <email>email@address.org</email>
		</para>
		<para>
			This man-page was written by Jan Schaumann
			<email>jschauma@netmeister.org</email> as part of "<ulink
			url="http://www.netmeister.org/misc/m2p2/index.html">The Missing
			Man Pages Project</ulink>".
		</para>
	</refsect1>
</refentry>
