[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#643690: perl policy unclear about the section for manpages



On Sat, 24 Dec 2011 11:06:31 -0800, Russ Allbery wrote:

> Yes, this tripped me up too.  Here's a proposed patch.  Seconds or further
> discussion?  I'll copy debian-perl as well for further review.


> >From f6938d47f9250f672586191cc00988e9e61cea06 Mon Sep 17 00:00:00 2001
> From: Russ Allbery <rra@debian.org>
> Date: Sat, 24 Dec 2011 11:03:49 -0800
> Subject: [PATCH] Clarify the Perl policy documentation rules
> 
> The first section about documentation and manual page extensions
> only applies to packages generated from the perl source package.
> Make that explicit and add a reference to the section discussing
> module packages.
> ---
>  perl-policy.sgml |    6 ++++--
>  1 files changed, 4 insertions(+), 2 deletions(-)
> 
> diff --git a/perl-policy.sgml b/perl-policy.sgml
> index 70c5bfc..626c514 100644
> --- a/perl-policy.sgml
> +++ b/perl-policy.sgml
> @@ -197,8 +197,8 @@
>  	  package.
>  	</p>
>  	<p>
> -	  Manual pages distributed with Perl packages must be installed
> -	  into the standard directories:
> +	  Manual pages distributed with packages built from the perl
> +	  source package must be installed into the standard directories:
>  	  <taglist>
>  	    <tag>Programs</tag>
>  	    <item>
> @@ -217,6 +217,8 @@
>  	      </p>
>  	    </item>
>  	  </taglist>
> +	  The extensions used for manual pages distributed with module
> +	  packages are different.  See <ref id="vendor_dirs">.
>  	</p>
>        </sect>
>      </chapt>

Looks good to me.
Seconded.

Cheers,
gregor
 
-- 
 .''`.   Homepage: http://info.comodo.priv.at/ - OpenPGP key ID: 0x8649AA06
 : :' :  Debian GNU/Linux user, admin, & developer - http://www.debian.org/
 `. `'   Member of VIBE!AT & SPI, fellow of Free Software Foundation Europe
   `-    NP: Arlo Guthrie: Can't Help Falling in Love

Attachment: signature.asc
Description: Digital signature


Reply to: