/ 
PAR-Repository-0.01_01
/ parrepo

NAME

parrepo - server side script for managing PAR repositories

SYNOPSIS

parrepo --help | --version
parrepo COMMAND [command options]
parrepo create [-r REPODIR] [--force]
parrepo inject [-r REPODIR] filename.par

DESCRIPTION

This is a frontend script to the PAR::Repository module. It lets you create and manage PAR repositories.

COMMANDS

All commands take the --verbose option to set the verbosity of error messages. Specifying that option multiple times (up to 4x) increases the verbosity even more.

Instead of using the --verbose option n times, you can also use the --verbosity n flag to set it to level n. Using --verbosity overrides any occurrances of --verbose.

create

Creates a new repository. Defaults to using a subdirectory called repo.

Parameters:

-r or --repository
  Specifies the repository path.
-f or --force
  Overwrite the directory if it exists.
inject

Injects a PAR distribution into the repository. You need to specify a distribution file to inject using the --file (or -f) option.

We need to find out which name and version the distribution has as well as which architecture and perl version it was compiled for. You can set all these using options (see below). If you do not, parrepo tries to infer this information from the file name. This works if the file name is of the following form:

WWW-Mechanize-1.32-x86_64-linux-gnu-thread-multi-5.8.6.par

The command line options take precedence over file name parsing.

If you specify the architecture name as any_arch, the distribution will be put into the architecture agnostic portion of the repository. any_version works similar for the perl version.

Alternatively, you can use the --any-arch and --any-version switches for a similar effect. If you use the switches, only a symlink to the original distribution will be put into the any_* section of the repository.

Parameters:

  -f or --file
    The distribution file to inject. (mandatory)
    parrepo will do a glob if the file name contains meta characters.
    this works: --file => '*.par'
  -r or --repository
    Specifies the repository path.
  -n or --distname
  -v or --distversion
  -a or --arch
  -p or --perlversion
    Set the necessary distribution information.
  --any-arch or --anyarch or --any_arch
    If set, a symlink to the distribution will be put into the
	architecture agnostic portion of the repository.
  --any-version or --anyversion or --any_version
    Same for the perl version.
  -o or --overwrite
    Set this if you want to overwrite a distribution of the
	same name in the repository.