"Fossies" - the Fresh Open Source Software Archive

Member "install-tl-20200916/tlpkg/tlperl/lib/CPAN/Meta/History.pm" (8 Mar 2018, 5370 Bytes) of package /windows/misc/install-tl.zip:


As a special service "Fossies" has tried to format the requested source page into HTML format using (guessed) Perl source code syntax highlighting (style: standard) with prefixed line numbers and code folding option. Alternatively you can here view or download the uninterpreted source code file.

    1 # vi:tw=72
    2 use 5.006;
    3 use strict;
    4 use warnings;
    5 package CPAN::Meta::History;
    6 
    7 our $VERSION = '2.150010';
    8 
    9 1;
   10 
   11 # ABSTRACT: history of CPAN Meta Spec changes
   12 
   13 __END__
   14 
   15 =pod
   16 
   17 =encoding UTF-8
   18 
   19 =head1 NAME
   20 
   21 CPAN::Meta::History - history of CPAN Meta Spec changes
   22 
   23 =head1 VERSION
   24 
   25 version 2.150010
   26 
   27 =head1 DESCRIPTION
   28 
   29 The CPAN Meta Spec has gone through several iterations.  It was
   30 originally written in HTML and later revised into POD (though published
   31 in HTML generated from the POD).  Fields were added, removed or changed,
   32 sometimes by design and sometimes to reflect real-world usage after the
   33 fact.
   34 
   35 This document reconstructs the history of the CPAN Meta Spec based on
   36 change logs, repository commit messages and the published HTML files.
   37 In some cases, particularly prior to version 1.2, the exact version
   38 when certain fields were introduced or changed is inconsistent between
   39 sources.  When in doubt, the published HTML files for versions 1.0 to
   40 1.4 as they existed when version 2 was developed are used as the
   41 definitive source.
   42 
   43 Starting with version 2, the specification document is part of the
   44 CPAN-Meta distribution and will be published on CPAN as
   45 L<CPAN::Meta::Spec>.
   46 
   47 Going forward, specification version numbers will be integers and
   48 decimal portions will correspond to a release date for the CPAN::Meta
   49 library.
   50 
   51 =head1 HISTORY
   52 
   53 =head2 Version 2
   54 
   55 April 2010
   56 
   57 =over
   58 
   59 =item *
   60 
   61 Revised spec examples as perl data structures rather than YAML
   62 
   63 =item *
   64 
   65 Switched to JSON serialization from YAML
   66 
   67 =item *
   68 
   69 Specified allowed version number formats
   70 
   71 =item *
   72 
   73 Replaced 'requires', 'build_requires', 'configure_requires',
   74 'recommends' and 'conflicts' with new 'prereqs' data structure divided
   75 by I<phase> (configure, build, test, runtime, etc.) and I<relationship>
   76 (requires, recommends, suggests, conflicts)
   77 
   78 =item *
   79 
   80 Added support for 'develop' phase for requirements for maintaining
   81 a list of authoring tools
   82 
   83 =item *
   84 
   85 Changed 'license' to a list and revised the set of valid licenses
   86 
   87 =item *
   88 
   89 Made 'dynamic_config' mandatory to reduce confusion
   90 
   91 =item *
   92 
   93 Changed 'resources' subkey 'repository' to a hash that clarifies
   94 repository type, url for browsing and url for checkout
   95 
   96 =item *
   97 
   98 Changed 'resources' subkey 'bugtracker' to a hash for either web
   99 or mailto resource
  100 
  101 =item *
  102 
  103 Changed specification of 'optional_features':
  104 
  105 =over
  106 
  107 =item *
  108 
  109 Added formal specification and usage guide instead of just example
  110 
  111 =item *
  112 
  113 Changed to use new prereqs data structure instead of individual keys
  114 
  115 =back
  116 
  117 =item *
  118 
  119 Clarified intended use of 'author' as generalized contact list
  120 
  121 =item *
  122 
  123 Added 'release_status' field to indicate stable, testing or unstable
  124 status to provide hints to indexers
  125 
  126 =item *
  127 
  128 Added 'description' field for a longer description of the distribution
  129 
  130 =item *
  131 
  132 Formalized use of "x_" or "X_" for all custom keys not listed in the
  133 official spec
  134 
  135 =back
  136 
  137 =head2 Version 1.4
  138 
  139 June 2008
  140 
  141 =over
  142 
  143 =item *
  144 
  145 Noted explicit support for 'perl' in prerequisites
  146 
  147 =item *
  148 
  149 Added 'configure_requires' prerequisite type
  150 
  151 =item *
  152 
  153 Changed 'optional_features'
  154 
  155 =over
  156 
  157 =item *
  158 
  159 Example corrected to show map of maps instead of list of maps
  160 (though descriptive text said 'map' even in v1.3)
  161 
  162 =item *
  163 
  164 Removed 'requires_packages', 'requires_os' and 'excluded_os'
  165 as valid subkeys
  166 
  167 =back
  168 
  169 =back
  170 
  171 =head2 Version 1.3
  172 
  173 November 2006
  174 
  175 =over
  176 
  177 =item *
  178 
  179 Added 'no_index' subkey 'directory' and removed 'dir' to match actual
  180 usage in the wild
  181 
  182 =item *
  183 
  184 Added a 'repository' subkey to 'resources'
  185 
  186 =back
  187 
  188 =head2 Version 1.2
  189 
  190 August 2005
  191 
  192 =over
  193 
  194 =item *
  195 
  196 Re-wrote and restructured spec in POD syntax
  197 
  198 =item *
  199 
  200 Changed 'name' to be mandatory
  201 
  202 =item *
  203 
  204 Changed 'generated_by' to be mandatory
  205 
  206 =item *
  207 
  208 Changed 'license' to be mandatory
  209 
  210 =item *
  211 
  212 Added version range specifications for prerequisites
  213 
  214 =item *
  215 
  216 Added required 'abstract' field
  217 
  218 =item *
  219 
  220 Added required 'author' field
  221 
  222 =item *
  223 
  224 Added required 'meta-spec' field to define 'version' (and 'url') of the
  225 CPAN Meta Spec used for metadata
  226 
  227 =item *
  228 
  229 Added 'provides' field
  230 
  231 =item *
  232 
  233 Added 'no_index' field and deprecated 'private' field.  'no_index'
  234 subkeys include 'file', 'dir', 'package' and 'namespace'
  235 
  236 =item *
  237 
  238 Added 'keywords' field
  239 
  240 =item *
  241 
  242 Added 'resources' field with subkeys 'homepage', 'license', and
  243 'bugtracker'
  244 
  245 =item *
  246 
  247 Added 'optional_features' field as an alternate under 'recommends'.
  248 Includes 'description', 'requires', 'build_requires', 'conflicts',
  249 'requires_packages', 'requires_os' and 'excluded_os' as valid subkeys
  250 
  251 =item *
  252 
  253 Removed 'license_uri' field
  254 
  255 =back
  256 
  257 =head2 Version 1.1
  258 
  259 May 2003
  260 
  261 =over
  262 
  263 =item *
  264 
  265 Changed 'version' to be mandatory
  266 
  267 =item *
  268 
  269 Added 'private' field
  270 
  271 =item *
  272 
  273 Added 'license_uri' field
  274 
  275 =back
  276 
  277 =head2 Version 1.0
  278 
  279 March 2003
  280 
  281 =over
  282 
  283 =item *
  284 
  285 Original release (in HTML format only)
  286 
  287 =item *
  288 
  289 Included 'name', 'version', 'license', 'distribution_type', 'requires',
  290 'recommends', 'build_requires', 'conflicts', 'dynamic_config',
  291 'generated_by'
  292 
  293 =back
  294 
  295 =head1 AUTHORS
  296 
  297 =over 4
  298 
  299 =item *
  300 
  301 David Golden <dagolden@cpan.org>
  302 
  303 =item *
  304 
  305 Ricardo Signes <rjbs@cpan.org>
  306 
  307 =item *
  308 
  309 Adam Kennedy <adamk@cpan.org>
  310 
  311 =back
  312 
  313 =head1 COPYRIGHT AND LICENSE
  314 
  315 This software is copyright (c) 2010 by David Golden, Ricardo Signes, Adam Kennedy and Contributors.
  316 
  317 This is free software; you can redistribute it and/or modify it under
  318 the same terms as the Perl 5 programming language system itself.
  319 
  320 =cut