Package: help2man Version: 1.36.3 Severity: wishlist Tags: patch Hi all
As Debian has adopted a stricter policy regarding non-free documentation, there are some info pages mentioned that are in non-free. The attached patch adds support to help2man for such packages. It does also add support for the more general problem of stand-alone doc packages. I've added two new options: -d, --doc-package=TEXT mention documentation package -D, --non-free-doc documentation package is in non-free Thanx Simon --- help2man-1.36.3/help2man.PL 2005-10-16 17:38:47.000000000 +0200 +++ help2man-1.36.3-non-free/help2man.PL 2006-02-20 19:59:42.000000000 +0100 @@ -155,6 +155,8 @@ -o, --output=FILE send output to `FILE' -p, --info-page=TEXT name of Texinfo manual -N, --no-info suppress pointer to Texinfo manual + -d, --doc-package=TEXT mention documentation package + -D, --non-free-doc documentation package is in non-free --help print this help, then exit --version print version number, then exit @@ -173,7 +175,7 @@ my $locale = 'C'; my $help_option = '--help'; my $version_option = '--version'; -my ($opt_name, @opt_include, $opt_output, $opt_info, $opt_no_info); +my ($opt_name, @opt_include, $opt_output, $opt_info, $opt_no_info, $opt_doc_package, $opt_non_free_doc); my %opt_def = ( 'n|name=s' => \$opt_name, @@ -186,6 +188,8 @@ 'o|output=s' => \$opt_output, 'p|info-page=s' => \$opt_info, 'N|no-info' => \$opt_no_info, + 'd|doc-package=s' => \$opt_doc_package, + 'D|non-free-doc' => \$opt_non_free_doc, 'h|help-option=s' => \$help_option, 'v|version-option=s' => \$version_option, ); @@ -644,6 +648,23 @@ EOT } +# Refer to documentation package. +if ($opt_doc_package) +{ + my $non_free = $opt_non_free_doc ? ' which is in non-free' : ''; + + $sect = _('SEE ALSO'); + $include{$sect} ||= ''; + $include{$sect} .= ".PP\n" if $include{$sect}; + $include{$sect} .= sprintf _(<<'EOT'), $program, $opt_doc_package, $non_free; +The full documentation for +.B %s +is available in the seperate +.B %s +package%s. +EOT +} + # Output header. print <<EOT; .\\" DO NOT MODIFY THIS FILE! It was generated by $this_program $this_version. -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]