# Create an empty CPAN-like repository in directory ~/mypan
$ pinto-admin -r ~/mypan create

# Get the current version of Plack (and all its dependencies) into the repository
$ pinto-admin -r ~/mypan import Plack

# Suppose HTTP::Simple has a bug and you made your own patch as HTTP-Simple-0.23-PATCHED.tar.gz
$ pinto-admin -r ~/mypan add HTTP-Simple-0.23-PATCHED.tar.gz

# Point cpan(1) or cpanm(1) at your repository, to install Plack with your patched HTTP::Simple
# cpanm --mirror file:///home/you/mypan --mirror-only Plack

# Time passes...and now we decide we want to upgrade the latest Plack, which is now Plack-2.4
$ pinto-admin -r ~/mypan import Plack-2.4

# It seems that bug in HTTP::Simple has now been fixed.  So we can remove our patched version
$ pinto-admin -r ~/mypan remove HTTP-Simple-0.23-PATCHED.tar.gz


##</code><code>##


# Create a new repository (or you can use an existing one)
$ pinto-admin -r ~/mypan create

# Get the latest version of ALL packages from a CPAN (may take a couple hours)
$ pinto-admin -r ~/mypan mirror

# Now we have a stable snapshot of CPAN we can install from
$ cpanm --mirror file:///home/you/mypan --mirror-only Catalyst Moose Perl::Critic

# Time passes...now we want to bring our snapshot up to date with the tip of CPAN
$ pinto-admin -r ~/mypan mirror

# But wait!  The new Moose-2.1 breaks our code.  We want to stay with our old Moose-1.4
$ pinto-admin -r ~/mypan pin Moose-1.4

# More time passes...We've fixed our code to work with Moose-2.1
$ pinto-admin -r ~/mypan unpin Moose