From owner-freebsd-doc@FreeBSD.ORG Tue Jun 27 16:29:20 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E89C416A50A for ; Tue, 27 Jun 2006 16:29:19 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 12584446E6 for ; Tue, 27 Jun 2006 16:00:38 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k5RG0b0R096600 for ; Tue, 27 Jun 2006 16:00:37 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k5RG0bOY096593; Tue, 27 Jun 2006 16:00:37 GMT (envelope-from gnats) Resent-Date: Tue, 27 Jun 2006 16:00:37 GMT Resent-Message-Id: <200606271600.k5RG0bOY096593@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Cheng-Lung Sung Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3D2F316A409 for ; Tue, 27 Jun 2006 15:53:44 +0000 (UTC) (envelope-from clsung@FreeBSD.csie.nctu.edu.tw) Received: from FreeBSD.csie.nctu.edu.tw (freebsd.csie.nctu.edu.tw [140.113.17.209]) by mx1.FreeBSD.org (Postfix) with ESMTP id 88F75449C3 for ; Tue, 27 Jun 2006 15:53:43 +0000 (GMT) (envelope-from clsung@FreeBSD.csie.nctu.edu.tw) Received: from localhost (localhost.csie.nctu.edu.tw [127.0.0.1]) by FreeBSD.csie.nctu.edu.tw (Postfix) with ESMTP id 86B767E93A for ; Tue, 27 Jun 2006 23:55:05 +0800 (CST) Received: from FreeBSD.csie.nctu.edu.tw ([127.0.0.1]) by localhost (FreeBSD.csie.nctu.edu.tw [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 5daOXqh6dyQ6 for ; Tue, 27 Jun 2006 23:55:04 +0800 (CST) Received: by FreeBSD.csie.nctu.edu.tw (Postfix, from userid 1038) id C3BE57E94F; Tue, 27 Jun 2006 23:55:04 +0800 (CST) Message-Id: <20060627155504.C3BE57E94F@FreeBSD.csie.nctu.edu.tw> Date: Tue, 27 Jun 2006 23:55:04 +0800 (CST) From: Cheng-Lung Sung To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/99554: [patch] suggestion about MASTER_SITE_SUBDIR for perl in porter's handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Cheng-Lung Sung List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 27 Jun 2006 16:29:20 -0000 >Number: 99554 >Category: docs >Synopsis: [patch] suggestion about MASTER_SITE_SUBDIR for perl in porter's handbook >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Tue Jun 27 16:00:37 GMT 2006 >Closed-Date: >Last-Modified: >Originator: Cheng-Lung Sung >Release: FreeBSD 6.1-PRERELEASE i386 >Organization: FreeBSD @ Taiwan >Environment: System: FreeBSD FreeBSD.csie.nctu.edu.tw 6.1-PRERELEASE FreeBSD 6.1-PRERELEASE #7: Thu Apr 13 03:20:20 CST 2006 root@FreeBSD.csie.nctu.edu.tw:/home/usr.obj/usr/src/sys/FREEBSD i386 >Description: We encourage p5-* ports maintainer to set MASTER_SITE_SUBDIR to module's upper-level name, but this is not documented. >How-To-Repeat: >Fix: --- porters-handbook/book.sgml.orig Tue Jun 27 18:44:10 2006 +++ porters-handbook/book.sgml Tue Jun 27 23:49:25 2006 @@ -4561,6 +4561,32 @@ Using <literal>perl</literal> + If MASTER_SITES is set to + ${MASTER_SITE_PERL_CPAN}, + then preferred value of MASTER_SITE_SUBDIR + is top-level hierarchy name instead of author's id. + For example, the recommend value for + p5-Module-Name is Module. + The top-level hierarchy can be examined in + cpan.org. + + + The exception is: + + + The top-level hierarchy name of module does not exist in + cpan.org. + In such case, using author's id is more appropriate. + + + + + + The reasons is that author of the Perl module may + change, and it will cause fetch + cannot find the required files. + + Variables for ports that use <literal>perl</literal> >Release-Note: >Audit-Trail: >Unformatted: