NAME

Module::Install::Authority - Add an x_authority key to META.yml

SYNOPSIS

    use inc::Module::Install;
    name 'Example';
    all_from 'lib/Example.pm'
    authority 'cpan:BOBTFISH';
    WriteAll;

DESCRIPTION

If you upload a distribution which contains an x_authority key in the META.yml then PAUSE will assign 'firstcome' permissions on any packages in that distribution to the user given by the x_authority key (and assign co-maint to the uploader).

Traditionally, if you uploaded a dist containing A.pm, and then gave someone else comaint, and they uploaded a subsequent release including B.pm, then you had a problem as the initial author (you!) has no permissions to release B.pm

Adding the x_authority key to your distribution fixes this, as it ensures that any subsequent packages uploaded as part of the dist by co-maintainers get their permissions set so that one person is the canonical source of permissions for the dist.

This makes coordination (and maintainance sharing) much easier for large distributions, or those maintained by a pool of people.

METHODS

authority ($pause_id)

Adds an x_authority key to your META.yml or META.json

BUGS

This module should be able to take x_authority from the $AUTHORITY variable in the 'main' module of the dist if present.

AUTHOR

    Tomas Doran (t0m) <bobtfish@bobtfish.net>

COPYRIGHT

Copyright (C) 2012 Tomas Doran

LICENSE

This software is licensed under the same terms as perl itself.