view release on metacpan or  search on metacpan

README  view on Meta::CPAN

                         Default is 15 secs. Set to 0 to disable.
      wait_list          arrayref to a wait server to try (See CPAN::WAIT)
      wget               path to external prg
      yaml_load_code     enable YAML code deserialisation via CPAN::DeferredCode
      yaml_module        which module to use to read/write YAML files

    You can set and query each of these options interactively in the cpan
    shell with the "o conf" or the "o conf init" command as specified below.

    "o conf <scalar option>"
      prints the current value of the *scalar option*

    "o conf <scalar option> <value>"
      Sets the value of the *scalar option* to *value*

    "o conf <list option>"
      prints the current value of the *list option* in MakeMaker's neatvalue
      format.

    "o conf <list option> [shift|pop]"
      shifts or pops the array in the *list option* variable

    "o conf <list option> [unshift|push|splice] <list>"
      works like the corresponding perl commands.

    interactive editing: o conf init [MATCH|LIST]
      Runs an interactive configuration dialog for matching variables.
      Without argument runs the dialog over all supported config variables.
      To specify a MATCH the argument must be enclosed by slashes.

      Examples:

        o conf init ftp_passive ftp_proxy
        o conf init /color/

      Note: this method of setting config variables often provides more
      explanation about the functioning of a variable than the manpage.

  CPAN::anycwd($path): Note on config variable getcwd
    CPAN.pm changes the current working directory often and needs to
    determine its own current working directory. By default it uses
    Cwd::cwd, but if for some reason this doesn't work on your system,
    configure alternatives according to the following table:

    cwd Calls Cwd::cwd

    getcwd
        Calls Cwd::getcwd

    fastcwd
        Calls Cwd::fastcwd

    getdcwd
        Calls Cwd::getdcwd

    backtickcwd
        Calls the external command cwd.

  Note on the format of the urllist parameter
    urllist parameters are URLs according to RFC 1738. We do a little
    guessing if your URL is not compliant, but if you have problems with
    "file" URLs, please try the correct format. Either:

        file://localhost/whatever/ftp/pub/CPAN/

    or

        file:///home/ftp/pub/CPAN/

  The urllist parameter has CD-ROM support
    The "urllist" parameter of the configuration table contains a list of
    URLs used for downloading. If the list contains any "file" URLs, CPAN
    always tries there first. This feature is disabled for index files. So
    the recommendation for the owner of a CD-ROM with CPAN contents is:
    include your local, possibly outdated CD-ROM as a "file" URL at the end
    of urllist, e.g.

      o conf urllist push file://localhost/CDROM/CPAN

    CPAN.pm will then fetch the index files from one of the CPAN sites that
    come at the beginning of urllist. It will later check for each module to
    see whether there is a local copy of the most recent version.

    Another peculiarity of urllist is that the site that we could
    successfully fetch the last file from automatically gets a preference
    token and is tried as the first site for the next request. So if you add
    a new site at runtime it may happen that the previously preferred site
    will be tried another time. This means that if you want to disallow a
    site for the next transfer, it must be explicitly removed from urllist.

  Maintaining the urllist parameter
    If you have YAML.pm (or some other YAML module configured in
    "yaml_module") installed, CPAN.pm collects a few statistical data about
    recent downloads. You can view the statistics with the "hosts" command
    or inspect them directly by looking into the "FTPstats.yml" file in your
    "cpan_home" directory.

    To get some interesting statistics, it is recommended that
    "randomize_urllist" be set; this introduces some amount of randomness
    into the URL selection.

  The "requires" and "build_requires" dependency declarations
    Since CPAN.pm version 1.88_51 modules declared as "build_requires" by a
    distribution are treated differently depending on the config variable
    "build_requires_install_policy". By setting
    "build_requires_install_policy" to "no", such a module is not installed.
    It is only built and tested, and then kept in the list of tested but
    uninstalled modules. As such, it is available during the build of the
    dependent module by integrating the path to the "blib/arch" and
    "blib/lib" directories in the environment variable PERL5LIB. If
    "build_requires_install_policy" is set to "yes", then both modules
    declared as "requires" and those declared as "build_requires" are
    treated alike. By setting to "ask/yes" or "ask/no", CPAN.pm asks the
    user and sets the default accordingly.

  Configuration of the allow_installing_* parameters
    The "allow_installing_*" parameters are evaluated during the "make"
    phase. If set to "yes", they allow the testing and the installation of
    the current distro and otherwise have no effect. If set to "no", they
    may abort the build (preventing testing and installing), depending on
    the contents of the "blib/" directory. The "blib/" directory is the