1Module::Install::AuthorUisteyr(3C)ontributed Perl DocumeMnotdautlieo:n:Install::Authority(3)
2
3
4

NAME

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

SYNOPSIS

9           use inc::Module::Install;
10           name 'Example';
11           all_from 'lib/Example.pm'
12           authority 'cpan:BOBTFISH';
13           WriteAll;
14

DESCRIPTION

16       If you upload a distribution which contains an "x_authority" key in the
17       META.yml then PAUSE will assign 'firstcome' permissions on any packages
18       in that distribution to the user given by the "x_authority" key (and
19       assign co-maint to the uploader).
20
21       Traditionally, if you uploaded a dist containing A.pm, and then gave
22       someone else comaint, and they uploaded a subsequent release including
23       B.pm, then you had a problem as the initial author (you!) has no
24       permissions to release B.pm
25
26       Adding the "x_authority" key to your distribution fixes this, as it
27       ensures that any subsequent packages uploaded as part of the dist by
28       co-maintainers get their permissions set so that one person is the
29       canonical source of permissions for the dist.
30
31       This makes coordination (and maintainance sharing) much easier for
32       large distributions, or those maintained by a pool of people.
33

METHODS

35   authority ($pause_id)
36       Adds an "x_authority" key to your META.yml or META.json
37

BUGS

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

AUTHOR

43           Tomas Doran (t0m) <bobtfish@bobtfish.net>
44
46       Copyright (C) 2012 Tomas Doran
47

LICENSE

49       This software is licensed under the same terms as perl itself.
50
51
52
53perl v5.36.0                      2022-07-22     Module::Install::Authority(3)
Impressum