1Alien::Build::Plugin::PUrseefrerC:o:nGtoroidbVuAetlreisdeinoP:ne:(rB3lu)iDlodc:u:mPelnutgaitni:o:nPrefer::GoodVersion(3)
2
3
4

NAME

6       Alien::Build::Plugin::Prefer::GoodVersion - Plugin to filter known good
7       versions
8

VERSION

10       version 2.17
11

SYNOPSIS

13        use alienfile;
14        plugin 'Prefer::GoodVersion' => '1.2.3';
15

DESCRIPTION

17       This plugin allows you to specify one or more good versions of a
18       library.  This doesn't affect a system install at all.  This plugin
19       does the opposite of the "Prefer::BadVersion" plugin.  You need need a
20       Prefer plugin that filters and sorts files first.  You may specify the
21       filter in one of three ways:
22
23       as a string
24           Filter any files that match the given version.
25
26            use alienfile;
27            plugin 'Prefer::GoodVersion' => '1.2.3';
28
29       as a array
30           Filter all files that match any of the given versions.
31
32            use alienfile;
33            plugin 'Prefer::GoodVersion' => [ '1.2.3', '1.2.4' ];
34
35       as a code reference
36           Filter any files return a true value.
37
38            use alienfile;
39            plugin 'Prefer::GoodVersion' => sub {
40              my($file) = @_;
41              $file->{version} eq '1.2.3'; # same as the string version above
42            };
43
44       This plugin can also be used to filter known good versions of a library
45       on just one platform.  For example, if you know that version 1.2.3 if
46       good on windows, but the default logic is fine on other platforms:
47
48        use alienfile;
49        plugin 'Prefer::GoodVersion' => '1.2.3' if $^O eq 'MSWin32';
50

PROPERTIES

52   filter
53       Filter entries that match the filter.
54

CAVEATS

56       If you are using the string or array mode, then you need an existing
57       Prefer plugin that sets the version number for each file candidate,
58       such as Alien::Build::Plugin::Prefer::SortVersions.
59
60       Unless you want to exclude the latest version from a share install,
61       this plugin isn't really that useful.  It has no effect on system
62       installs, which may not be obvious at first.
63

SEE ALSO

65       alienfile
66       Alien::Build
67       Alien::Build::Plugin::Prefer::SortVersions
68

AUTHOR

70       Author: Graham Ollis <plicease@cpan.org>
71
72       Contributors:
73
74       Diab Jerius (DJERIUS)
75
76       Roy Storey (KIWIROY)
77
78       Ilya Pavlov
79
80       David Mertens (run4flat)
81
82       Mark Nunberg (mordy, mnunberg)
83
84       Christian Walde (Mithaldu)
85
86       Brian Wightman (MidLifeXis)
87
88       Zaki Mughal (zmughal)
89
90       mohawk (mohawk2, ETJ)
91
92       Vikas N Kumar (vikasnkumar)
93
94       Flavio Poletti (polettix)
95
96       Salvador Fandiño (salva)
97
98       Gianni Ceccarelli (dakkar)
99
100       Pavel Shaydo (zwon, trinitum)
101
102       Kang-min Liu (劉康民, gugod)
103
104       Nicholas Shipp (nshp)
105
106       Juan Julián Merelo Guervós (JJ)
107
108       Joel Berger (JBERGER)
109
110       Petr Pisar (ppisar)
111
112       Lance Wicks (LANCEW)
113
114       Ahmad Fatoum (a3f, ATHREEF)
115
116       José Joaquín Atria (JJATRIA)
117
118       Duke Leto (LETO)
119
120       Shoichi Kaji (SKAJI)
121
122       Shawn Laffan (SLAFFAN)
123
124       Paul Evans (leonerd, PEVANS)
125

127       This software is copyright (c) 2011-2020 by Graham Ollis.
128
129       This is free software; you can redistribute it and/or modify it under
130       the same terms as the Perl 5 programming language system itself.
131
132
133
134perl v5.30.2                      2A0l2i0e-n0:3:-B2u0ild::Plugin::Prefer::GoodVersion(3)
Impressum