NAME¶

CPANPLUS::Shell::Default::Plugins::CustomSource - add custom sources to CPANPLUS

SYNOPSIS¶

    ### elaborate help text
    CPAN Terminal> /? cs
    ### add a new custom source
    CPAN Terminal> /cs --add file:///path/to/releases
    
    ### list all your custom sources by 
    CPAN Terminal> /cs --list
    
    ### display the contents of a custom source by URI or ID
    CPAN Terminal> /cs --contents file:///path/to/releases
    CPAN Terminal> /cs --contents 1
    ### Update a custom source by URI or ID
    CPAN Terminal> /cs --update file:///path/to/releases
    CPAN Terminal> /cs --update 1
    
    ### Remove a custom source by URI or ID
    CPAN Terminal> /cs --remove file:///path/to/releases
    CPAN Terminal> /cs --remove 1
    
    ### Write an index file for a custom source, to share
    ### with 3rd parties or remote users
    CPAN Terminal> /cs --write file:///path/to/releases
    ### Make sure to save your sources when adding/removing
    ### sources, so your changes are reflected in the cache:
    CPAN Terminal> x

DESCRIPTION¶

This is a "CPANPLUS::Shell::Default" plugin that can add custom sources to your CPANPLUS installation. This is a wrapper around the "custom module sources" code as outlined in "CUSTOM MODULE SOURCES" in CPANPLUS::Backend. This allows you to extend your index of available modules beyond what's available on "CPAN" with your own local distributions, or ones offered by third parties.