Tomas Doran > Module-Install-Authority-0.02 > Module::Install::Authority

Download:
Module-Install-Authority-0.02.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.02   Source   Latest Release: Module-Install-Authority-0.03

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 '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.

syntax highlighting: