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 <r...@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 via email to