Re: couple quick questions

[martin@internet-treff.uni-koeln.de (Martin Bialasinski)]

>> "RC" == Randolph Chung <randolph@CS.cornell.edu> writes:

RC> what's the easiest way to write a manpage if i don't want to learn
RC> troff? :)

You could use a .pod file (this is the perl documentation format),
which you can convert into a man page.

        pod2man --section=1 --release="`date +'%d %b %Y'`"\
         --center="Debian/GNU" --date=' '\
        debian/update-xlogmaster.pod > debian/update-xlogmaster.1

The podfile looks like:

=head1 NAME

update-xlogmaster - create a configurationfile for xlogmaster

=head1 SYNOPSIS

B<update-xlogmaster [-v]>

=head1 DESCRIPTION

[...]

=head1 OPTIONS

=over 4

=item -v

Verbose output, show warnings.

=back

[...]

=head1 SEE ALSO

xlogmaster(1), /usr/doc/xlogmaster/tutorial.txt

As you can see, the syntax is quite easy. See perldoc perlpod for more 
info.

Ciao,
	Martin