Update setting urllist (thanks, Marcus)
Kennedy Clark [Sat, 8 Jul 2006 21:15:57 +0000 (21:15 +0000)]
lib/Catalyst/Manual/Installation/CentOS4.pod

index dd4aa27..40ccb02 100644 (file)
@@ -194,27 +194,33 @@ script by entering the following command at the C<cpanE<gt>> prompt:
 
 It will then take you through the configuration dialog.  
 
-However, it's often easiest to manually edit the C<urllist> setting in 
-the CPAN configuration file (global configuration settings are located 
-in C</usr/lib/perl5/5.8.5/CPAN/Config.pm> with per-user override 
-settings optionally specified in C<~/.cpan/CPAN/MyConfig.pm>).  For 
-example, open C</usr/lib/perl5/5.8.5/CPAN/Config.pm> in your editor and 
-update the C<urllist> entry (do not change or delete the other 
-settings):
-
-    $CPAN::Config = {
-      ...
-      'urllist' => [q[http://www.perl.com/CPAN/]],
-      ...
-    };
-    1;
-    __END__
+However, it's often easiesr to avoid the full configuration dialog and
+manually add a URL.  To prepend a new URL to the B<front> of the list,
+use the C<unshift> option to C<o conf>:
+
+    cpan> o conf urllist unshift http://www.perl.com/CPAN/
 
 Where C<http://www.perl.com/CPAN/> is replaced by a nearby, HTTP-based 
 mirror.  You can get a list of all mirrors (including where they are 
 located, their bandwidth, and their update frequency) at 
 L<http://www.perl.com/CPAN/MIRRORED.BY>.
 
+Then, be sure to save your changes (or they will be lost the next
+time you restart the CPAN shell):
+
+    cpan> o conf commit
+
+You can view the current settings with C<o conf urllist> (or just
+C<o conf> to view all settings):
+
+    cpan> o conf urllist
+        urllist           
+            http://www.perl.com/CPAN/
+    Type 'o conf' to view configuration edit options
+Note that multiple values can be entered for the C<urllist> option (the
+first entry will be used as long as it responds).
+
 =item * 
 
 Type C<wget http://www.shadowcatsystems.co.uk/static/cat-install> to