View | Details | Raw Unified | Return to bug 99554
Collapse All | Expand All

(-)porters-handbook/book.sgml (+26 lines)
Lines 4561-4566 Link Here
4561
    <sect1 id="using-perl">
4561
    <sect1 id="using-perl">
4562
      <title>Using <literal>perl</literal></title>
4562
      <title>Using <literal>perl</literal></title>
4563
4563
4564
      <para>If <literal>MASTER_SITES</literal> is set to 
4565
	<literal>&dollar;{MASTER_SITE_PERL_CPAN}</literal>, 
4566
	then preferred value of <literal>MASTER_SITE_SUBDIR</literal> 
4567
	is top-level hierarchy name instead of author's id. 
4568
	For example, the recommend value for 
4569
	<literal>p5-Module-Name</literal> is <literal>Module</literal>.
4570
	The top-level hierarchy can be examined in 
4571
	<ulink url="http://cpan.org/modules/by-module/">cpan.org</ulink>.
4572
      </para>
4573
4574
      <para>The exception is:</para>
4575
	<itemizedlist>
4576
	  <listitem>
4577
	    <para>The top-level hierarchy name of module does not exist in 
4578
	      <ulink url="http://cpan.org/modules/by-module/">cpan.org</ulink>.
4579
	      In such case, using author's id is more appropriate.
4580
	    </para>
4581
	  </listitem>
4582
	</itemizedlist>
4583
4584
      <note>
4585
	<para>The reasons is that author of the Perl module may
4586
	  change, and it will cause <maketarget>fetch</maketarget>
4587
	  cannot find the required files.</para>
4588
      </note>
4589
4564
      <table frame="none">
4590
      <table frame="none">
4565
	<title>Variables for ports that use <literal>perl</literal></title>
4591
	<title>Variables for ports that use <literal>perl</literal></title>

Return to bug 99554