Perl modules and whatis entries (Re: r12202 - in /trunk/libwx-perl/debian: control patches/ patches/01_fix_whatis_entries.patch patches/series rules)

[Russ Allbery <rra@debian.org>]

roberto@users.alioth.debian.org writes:

> Author: roberto
> Date: Tue Jan  8 03:00:45 2008
> New Revision: 12202
>
> URL: http://svn.debian.org/wsvn/?sc=1&rev=12202
> Log:
> Trying to make lintian happy regarding bad whatis information in man pages.

[...]

> +--- libwx-perl.orig/build/Wx/XSP/Node.pm
> ++++ libwx-perl/build/Wx/XSP/Node.pm
> +@@ -1,8 +1,6 @@
> + package Wx::XSP::Node;
> + 
> +-=head1 Wx::XSP::Node
> +-
> +-Base class for the parser output.
> ++=head1 Wx::XSP::Node \- Base class for the parser output.

The documentation has to look like:

=head1 NAME

Wx::XSP::Node - Base class for the parser output

No backslash (pod2man already handles that), and it has to be in the NAME
section, which is magical for man pages.

-- 
Russ Allbery (rra@debian.org)               <http://www.eyrie.org/~eagle/>