Package: dh-make
Version: 0.40
Severity: wishlist

There doesn't seem to be a manualpage*.ex file that could be filled in
for programs that do not include one. Please consider including one, where
the easiest to work with it the Perl POD format that can be converted
to apropriate page easily.

1) include these in the template in the default 'rules' file:

PACKAGE      = package
MANSECT      = 1
MANPOD       = debian/$(PACKAGE).$(MANSECT).pod
MANPAGE      = debian/$(PACKAGE).$(MANSECT)

...

install-manpod: 
        pod2man --center="Debian" \
                --name="User program" \
                --section=$(MANSECT) \
                $(MANPOD) \
        | sed 's,perl v[0-9.]+,$(PACKAGE),' \
        > $(MANPAGE)

##   -- Uncomment as needed --
##   Then use: dh_installman debian/$(MANPAGE)
#install: install-manpod

install: build

        ...

2) Include this text as debian/manpage.section.pod.ex

#  This is manual page in Perl POD format. Read more at
#  http://perldoc.perl.org/perlpod.html or run command:
#
#     perldoc perlpod | less
#
#  To check the syntax:
#
#     podchecker *.pod
#
#  Create manual page with command:
#
#    pod2man PAGE.N.pod > PAGE.N

=pod

=head1 NAME

program - Short description

=head1 SYNOPSIS

  program [options]

=head1 DESCRIPTION

Programs longer description.

=head1 OPTIONS

=over 4

=item B<-h|--help>

Print help.

=back

=head1 ENVIRONMENT

None.

=head1 FILES

None.

=head1 SEE ALSO

C<someprogram(1)>

=head1 AUTHORS

This manual page was written by <[EMAIL PROTECTED]>, for
the Debian GNU system (but may be used by others) because the
original program did not include one.

=cut


-- System Information:
Debian Release: testing/unstable
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'stable')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/dash
Kernel: Linux 2.6.14-2-686
Locale: LANG=C, LC_CTYPE=C (charmap=ISO-8859-1) (ignored: LC_ALL set to en_US)

Versions of packages dh-make depends on:
ii  debhelper                 5.0.22         helper programs for debian/rules
ii  dpkg-dev                  1.13.13        package building tools for Debian
ii  make                      3.80+3.81.b4-1 The GNU version of the "make" util
ii  perl                      5.8.8-2        Larry Wall's Practical Extraction 

dh-make recommends no packages.

-- no debconf information


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]

Reply via email to