Debian Codegraph @

upstream/debian-unstable/man3/CPAN::Meta::History::Meta_1_4.3perl

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "CPAN::Meta::History::Meta_1_4 3perl"
58 .TH CPAN::Meta::History::Meta_1_4 3perl 2025-11-16 "perl v5.40.1" "Perl Programmers Reference Guide"
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 CPAN::Meta::History::Meta_1_4 \- Version 1.4 metadata specification for META.yml
65 .SH PREFACE
66 .IX Header "PREFACE"
67 This is a historical copy of the version 1.4 specification for \fIMETA.yml\fR
68 files, copyright by Ken Williams and licensed under the same terms as Perl
69 itself.
70 .PP
71 Modifications from the original:
72 .IP \(bu 4
73 Various spelling corrections
74 .IP \(bu 4
75 Include list of valid licenses from Module::Build 0.2807 rather than
76 linking to the module, with minor updates to text and links to reflect
77 versions at the time of publication.
78 .IP \(bu 4
79 Fixed some dead links to point to active resources.
80 .SH SYNOPSIS
81 .IX Header "SYNOPSIS"
82 .Vb 10
83 \& \-\-\- #YAML:1.0
84 \& name: Module\-Build
85 \& abstract: Build and install Perl modules
86 \& version: 0.20
87 \& author:
88 \& \- Ken Williams <[email protected]>
89 \& license: perl
90 \& distribution_type: module
91 \& requires:
92 \& Config: 0
93 \& Cwd: 0
94 \& Data::Dumper: 0
95 \& ExtUtils::Install: 0
96 \& File::Basename: 0
97 \& File::Compare: 0
98 \& File::Copy: 0
99 \& File::Find: 0
100 \& File::Path: 0
101 \& File::Spec: 0
102 \& IO::File: 0
103 \& perl: 5.005_03
104 \& recommends:
105 \& Archive::Tar: 1.00
106 \& ExtUtils::Install: 0.3
107 \& ExtUtils::ParseXS: 2.02
108 \& Pod::Text: 0
109 \& YAML: 0.35
110 \& build_requires:
111 \& Test: 0
112 \& resources:
113 \& license: http://dev.perl.org/licenses/
114 \& meta\-spec:
115 \& version: 1.4
116 \& url: http://module\-build.sourceforge.net/META\-spec\-v1.3.html
117 \& generated_by: Module::Build version 0.20
118 .Ve
119 .SH DESCRIPTION
120 .IX Header "DESCRIPTION"
121 This document describes version 1.4 of the \fIMETA.yml\fR specification.
122 .PP
123 The \fIMETA.yml\fR file describes important properties of contributed
124 Perl distributions such as the ones found on CPAN. It is typically
125 created by tools like Module::Build, Module::Install, and
126 ExtUtils::MakeMaker.
127 .PP
128 The fields in the \fIMETA.yml\fR file are meant to be helpful for people
129 maintaining module collections (like CPAN), for people writing
130 installation tools (like CPAN.pm or CPANPLUS), or just for people who
131 want to know some stuff about a distribution before downloading it and
132 starting to install it.
133 .PP
134 \&\fINote: The latest stable version of this specification can always be
135 found at <http://module\-build.sourceforge.net/META\-spec\-current.html>,
136 and the latest development version (which may include things that
137 won't make it into the stable version) can always be found at
138 <http://module\-build.sourceforge.net/META\-spec\-blead.html>.\fR
139 .SH FORMAT
140 .IX Header "FORMAT"
141 \&\fIMETA.yml\fR files are written in the YAML format (see
142 <http://www.yaml.org/>).
143 .PP
144 See the following links to learn why we chose YAML instead of, say,
145 XML or Data::Dumper:
146 .IP \(bu 4
147 Module::Build design plans <http://www.nntp.perl.org/group/perl.makemaker/2002/04/msg407.html>
148 .IP \(bu 4
149 Not keen on YAML <http://www.nntp.perl.org/group/perl.module-authors/2003/11/msg1353.html>
150 .IP \(bu 4
151 META Concerns <http://www.nntp.perl.org/group/perl.module-authors/2003/11/msg1385.html>
152 .SH TERMINOLOGY
153 .IX Header "TERMINOLOGY"
154 .IP distribution 4
155 .IX Item "distribution"
156 This is the primary object described by the \fIMETA.yml\fR
157 specification. In the context of this document it usually refers to a
158 collection of modules, scripts, and/or documents that are distributed
159 together for other developers to use. Examples of distributions are
160 \&\f(CW\*(C`Class\-Container\*(C'\fR, \f(CW\*(C`libwww\-perl\*(C'\fR, or \f(CW\*(C`DBI\*(C'\fR.
161 .IP module 4
162 .IX Item "module"
163 This refers to a reusable library of code typically contained in a
164 single file. Currently, we primarily talk of perl modules, but this
165 specification should be open enough to apply to other languages as
166 well (ex. python, ruby). Examples of modules are \f(CW\*(C`Class::Container\*(C'\fR,
167 \&\f(CW\*(C`LWP::Simple\*(C'\fR, or \f(CW\*(C`DBD::File\*(C'\fR.
168 .SH HEADER
169 .IX Header "HEADER"
170 The first line of a \fIMETA.yml\fR file should be a valid YAML document
171 header like \f(CW"\-\-\- #YAML:1.0"\fR.
172 .SH FIELDS
173 .IX Header "FIELDS"
174 The rest of the \fIMETA.yml\fR file is one big YAML mapping whose keys
175 are described here.
176 .SS meta-spec
177 .IX Subsection "meta-spec"
178 Example:
179 .PP
180 .Vb 3
181 \& meta\-spec:
182 \& version: 1.4
183 \& url: http://module\-build.sourceforge.net/META\-spec\-v1.3.html
184 .Ve
185 .PP
186 (Spec 1.1) [required] {URL} This field indicates the location of the
187 version of the META.yml specification used.
188 .SS name
189 .IX Subsection "name"
190 Example:
191 .PP
192 .Vb 1
193 \& name: Module\-Build
194 .Ve
195 .PP
196 (Spec 1.0) [required] {string} The name of the distribution which is often
197 created by taking the "main module" in the distribution and changing
198 "::" to "\-". Sometimes it's completely different, however, as in the
199 case of the libwww-perl distribution (see
200 <http://search.cpan.org/dist/libwww\-perl/>).
201 .SS version
202 .IX Subsection "version"
203 Example:
204 .PP
205 .Vb 1
206 \& version: 0.20
207 .Ve
208 .PP
209 (Spec 1.0) [required] {version} The version of the distribution to which the
210 \&\fIMETA.yml\fR file refers.
211 .SS abstract
212 .IX Subsection "abstract"
213 Example:
214 .PP
215 .Vb 1
216 \& abstract: Build and install Perl modules.
217 .Ve
218 .PP
219 (Spec 1.1) [required] {string} A short description of the purpose of the
220 distribution.
221 .SS author
222 .IX Subsection "author"
223 Example:
224 .PP
225 .Vb 2
226 \& author:
227 \& \- Ken Williams <[email protected]>
228 .Ve
229 .PP
230 (Spec 1.1) [required] {list of strings} A YAML sequence indicating the author(s) of the
231 distribution. The preferred form is author-name <email\-address>.
232 .SS license
233 .IX Subsection "license"
234 Example:
235 .PP
236 .Vb 1
237 \& license: perl
238 .Ve
239 .PP
240 (Spec 1.0) [required] {string} The license under which this
241 distribution may be used and redistributed.
242 .PP
243 Must be one of the following licenses:
244 .IP apache 4
245 .IX Item "apache"
246 The distribution is licensed under the Apache Software License version 1.1
247 (<http://opensource.org/licenses/Apache\-1.1>).
248 .IP artistic 4
249 .IX Item "artistic"
250 The distribution is licensed under the Artistic License version 1, as specified
251 by the Artistic file in the standard perl distribution
252 (<http://opensource.org/licenses/Artistic\-Perl\-1.0>).
253 .IP bsd 4
254 .IX Item "bsd"
255 The distribution is licensed under the BSD 3\-Clause License
256 (<http://opensource.org/licenses/BSD\-3\-Clause>).
257 .IP gpl 4
258 .IX Item "gpl"
259 The distribution is distributed under the terms of the GNU General Public
260 License version 2 (<http://opensource.org/licenses/GPL\-2.0>).
261 .IP lgpl 4
262 .IX Item "lgpl"
263 The distribution is distributed under the terms of the GNU Lesser General
264 Public License version 2 (<http://opensource.org/licenses/LGPL\-2.1>).
265 .IP mit 4
266 .IX Item "mit"
267 The distribution is licensed under the MIT License
268 (<http://opensource.org/licenses/MIT>).
269 .IP mozilla 4
270 .IX Item "mozilla"
271 The distribution is licensed under the Mozilla Public License.
272 (<http://opensource.org/licenses/MPL\-1.0> or
273 <http://opensource.org/licenses/MPL\-1.1>)
274 .IP open_source 4
275 .IX Item "open_source"
276 The distribution is licensed under some other Open Source Initiative-approved
277 license listed at <http://www.opensource.org/licenses/>.
278 .IP perl 4
279 .IX Item "perl"
280 The distribution may be copied and redistributed under the same terms as perl
281 itself (this is by far the most common licensing option for modules on CPAN).
282 This is a dual license, in which the user may choose between either the GPL or
283 the Artistic license.
284 .IP restrictive 4
285 .IX Item "restrictive"
286 The distribution may not be redistributed without special permission from the
287 author and/or copyright holder.
288 .IP unrestricted 4
289 .IX Item "unrestricted"
290 The distribution is licensed under a license that is not approved by
291 www.opensource.org <http://www.opensource.org/> but that allows distribution
292 without restrictions.
293 .SS distribution_type
294 .IX Subsection "distribution_type"
295 Example:
296 .PP
297 .Vb 1
298 \& distribution_type: module
299 .Ve
300 .PP
301 (Spec 1.0) [optional] {string} What kind of stuff is contained in this
302 distribution. Most things on CPAN are \f(CW\*(C`module\*(C'\fRs (which can also mean
303 a collection of modules), but some things are \f(CW\*(C`script\*(C'\fRs.
304 .PP
305 Unfortunately this field is basically meaningless, since many
306 distributions are hybrids of several kinds of things, or some new
307 thing, or subjectively different in focus depending on who's using
308 them. Tools like Module::Build and MakeMaker will likely stop
309 generating this field.
310 .SS requires
311 .IX Subsection "requires"
312 Example:
313 .PP
314 .Vb 3
315 \& requires:
316 \& Data::Dumper: 0
317 \& File::Find: 1.03
318 .Ve
319 .PP
320 (Spec 1.0) [optional] {map} A YAML mapping indicating the Perl
321 prerequisites this distribution requires for proper operation. The
322 keys are the names of the prerequisites (module names or 'perl'), and
323 the values are version specifications as described in VERSION
324 SPECIFICATIONS.
325 .SS recommends
326 .IX Subsection "recommends"
327 Example:
328 .PP
329 .Vb 3
330 \& recommends:
331 \& Data::Dumper: 0
332 \& File::Find: 1.03
333 .Ve
334 .PP
335 (Spec 1.0) [optional] {map} A YAML mapping indicating the Perl
336 prerequisites this distribution recommends for enhanced operation.
337 The keys are the names of the prerequisites (module names or 'perl'),
338 and the values are version specifications as described in VERSION
339 SPECIFICATIONS.
340 .PP
341 \&\fIALTERNATIVE: It may be desirable to present to the user which
342 features depend on which modules so they can make an informed decision
343 about which recommended modules to install.\fR
344 .PP
345 Example:
346 .PP
347 .Vb 6
348 \& optional_features:
349 \& foo:
350 \& description: Provides the ability to blah.
351 \& requires:
352 \& Data::Dumper: 0
353 \& File::Find: 1.03
354 .Ve
355 .PP
356 \&\fI(Spec 1.1) [optional] {map} A YAML mapping of names for optional features
357 which are made available when its requirements are met. For each
358 feature a description is provided along with any of "requires",
359 "build_requires", and "conflicts", which have the same meaning in
360 this subcontext as described elsewhere in this document.\fR
361 .SS build_requires
362 .IX Subsection "build_requires"
363 Example:
364 .PP
365 .Vb 3
366 \& build_requires:
367 \& Data::Dumper: 0
368 \& File::Find: 1.03
369 .Ve
370 .PP
371 (Spec 1.0) [optional] {map} A YAML mapping indicating the Perl
372 prerequisites required for building and/or testing of this
373 distribution. The keys are the names of the prerequisites (module
374 names or 'perl'), and the values are version specifications as
375 described in "VERSION SPECIFICATIONS". These dependencies are not
376 required after the distribution is installed.
377 .SS configure_requires
378 .IX Subsection "configure_requires"
379 Example:
380 .PP
381 .Vb 4
382 \& configure_requires:
383 \& Module::Build: 0.2809
384 \& Data::Dumper: 0
385 \& File::Find: 1.03
386 .Ve
387 .PP
388 (Spec 1.4) [optional] {map} A YAML mapping indicating the Perl prerequisites
389 required before configuring this distribution. The keys are the
390 names of the prerequisites (module names or 'perl'), and the values are version
391 specifications as described in "VERSION SPECIFICATIONS". These
392 dependencies are not required after the distribution is installed.
393 .SS conflicts
394 .IX Subsection "conflicts"
395 Example:
396 .PP
397 .Vb 3
398 \& conflicts:
399 \& Data::Dumper: 0
400 \& File::Find: 1.03
401 .Ve
402 .PP
403 (Spec 1.0) [optional] {map} A YAML mapping indicating any items that
404 cannot be installed while this distribution is installed. This is a
405 pretty uncommon situation. The keys for \f(CW\*(C`conflicts\*(C'\fR are the item
406 names (module names or 'perl'), and the values are version
407 specifications as described in "VERSION SPECIFICATIONS".
408 .SS dynamic_config
409 .IX Subsection "dynamic_config"
410 Example:
411 .PP
412 .Vb 1
413 \& dynamic_config: 0
414 .Ve
415 .PP
416 (Spec 1.0) [optional] {boolean} A boolean flag indicating whether a \fIBuild.PL\fR
417 or \fIMakefile.PL\fR (or similar) must be executed when building this
418 distribution, or whether it can be built, tested and installed solely
419 from consulting its
420 metadata file. The main reason to set this to a true value is that
421 your module performs some dynamic configuration (asking questions,
422 sensing the environment, etc.) as part of its build/install process.
423 .PP
424 Currently Module::Build doesn't actually do anything with this flag
425 \&\- it's probably going to be up to higher-level tools like CPAN
426 to do something useful with it. It can potentially bring lots of
427 security, packaging, and convenience improvements.
428 .PP
429 If this field is omitted, it defaults to 1 (true).
430 .SS private
431 .IX Subsection "private"
432 \&\fI(Deprecated)\fR (Spec 1.0) [optional] {map} This field has been renamed to
433 "no_index". See below.
434 .SS provides
435 .IX Subsection "provides"
436 Example:
437 .PP
438 .Vb 9
439 \& provides:
440 \& Foo::Bar:
441 \& file: lib/Foo/Bar.pm
442 \& version: 0.27_02
443 \& Foo::Bar::Blah:
444 \& file: lib/Foo/Bar/Blah.pm
445 \& Foo::Bar::Baz:
446 \& file: lib/Foo/Bar/Baz.pm
447 \& version: 0.3
448 .Ve
449 .PP
450 (Spec 1.1) [optional] {map} A YAML mapping that describes all packages
451 provided by this distribution. This information can be (and, in some
452 cases, is) used by distribution and automation mechanisms like PAUSE,
453 CPAN, and search.cpan.org to build indexes saying in which
454 distribution various packages can be found.
455 .PP
456 When using tools like Module::Build that can generate the
457 \&\f(CW\*(C`provides\*(C'\fR mapping for your distribution automatically, make sure you
458 examine what it generates to make sure it makes sense \- indexers will
459 usually trust the \f(CW\*(C`provides\*(C'\fR field if it's present, rather than
460 scanning through the distribution files themselves to figure out
461 packages and versions. This is a good thing, because it means you can
462 use the \f(CW\*(C`provides\*(C'\fR field to tell the indexers precisely what you want
463 indexed about your distribution, rather than relying on them to
464 essentially guess what you want indexed.
465 .SS no_index
466 .IX Subsection "no_index"
467 Example:
468 .PP
469 .Vb 9
470 \& no_index:
471 \& file:
472 \& \- My/Module.pm
473 \& directory:
474 \& \- My/Private
475 \& package:
476 \& \- My::Module::Stuff
477 \& namespace:
478 \& \- My::Module::Stuff
479 .Ve
480 .PP
481 (Spec 1.1) [optional] {map} A YAML mapping that describes any files,
482 directories, packages, and namespaces that are private
483 (i.e. implementation artifacts) that are not of interest to searching
484 and indexing tools. This is useful when no \f(CW\*(C`provides\*(C'\fR field is
485 present.
486 .PP
487 For example, <http://search.cpan.org/> excludes items listed in \f(CW\*(C`no_index\*(C'\fR
488 when searching for POD, meaning files in these directories will not
489 converted to HTML and made public \- which is useful if you have
490 example or test PODs that you don't want the search engine to go
491 through.
492 .PP
493 \fIfile\fR
494 .IX Subsection "file"
495 .PP
496 (Spec 1.1) [optional] Exclude any listed file(s).
497 .PP
498 \fIdirectory\fR
499 .IX Subsection "directory"
500 .PP
501 (Spec 1.1) [optional] Exclude anything below the listed
502 directory(ies).
503 .PP
504 [Note: previous editions of the spec had \f(CW\*(C`dir\*(C'\fR instead of
505 \&\f(CW\*(C`directory\*(C'\fR, but I think MakeMaker and various users started using
506 \&\f(CW\*(C`directory\*(C'\fR, so in deference we switched to that.]
507 .PP
508 \fIpackage\fR
509 .IX Subsection "package"
510 .PP
511 (Spec 1.1) [optional] Exclude the listed package(s).
512 .PP
513 \fInamespace\fR
514 .IX Subsection "namespace"
515 .PP
516 (Spec 1.1) [optional] Excludes anything below the listed namespace(s),
517 but \fInot\fR the listed namespace(s) its self.
518 .SS keywords
519 .IX Subsection "keywords"
520 Example:
521 .PP
522 .Vb 4
523 \& keywords:
524 \& \- make
525 \& \- build
526 \& \- install
527 .Ve
528 .PP
529 (Spec 1.1) [optional] {list} A sequence of keywords/phrases that describe
530 this distribution.
531 .SS resources
532 .IX Subsection "resources"
533 Example:
534 .PP
535 .Vb 6
536 \& resources:
537 \& license: http://dev.perl.org/licenses/
538 \& homepage: http://sourceforge.net/projects/module\-build
539 \& bugtracker: http://rt.cpan.org/NoAuth/Bugs.html?Dist=Module\-Build
540 \& repository: http://sourceforge.net/cvs/?group_id=45731
541 \& MailingList: http://lists.sourceforge.net/lists/listinfo/module\-build\-general
542 .Ve
543 .PP
544 (Spec 1.1) [optional] {map} A mapping of any URL resources related to
545 this distribution. All-lower-case keys, such as \f(CW\*(C`homepage\*(C'\fR,
546 \&\f(CW\*(C`license\*(C'\fR, and \f(CW\*(C`bugtracker\*(C'\fR, are reserved by this specification, as
547 they have "official" meanings defined here in this specification. If
548 you'd like to add your own "special" entries (like the "MailingList"
549 entry above), use at least one upper-case letter.
550 .PP
551 The current set of official keys is:
552 .IP homepage 2
553 .IX Item "homepage"
554 The official home of this project on the web.
555 .IP license 2
556 .IX Item "license"
557 An URL for an official statement of this distribution's license.
558 .IP bugtracker 2
559 .IX Item "bugtracker"
560 An URL for a bug tracker (e.g. Bugzilla or RT queue) for this project.
561 .SS generated_by
562 .IX Subsection "generated_by"
563 Example:
564 .PP
565 .Vb 1
566 \& generated_by: Module::Build version 0.20
567 .Ve
568 .PP
569 (Spec 1.0) [required] {string} Indicates the tool that was used to create this
570 \&\fIMETA.yml\fR file. It's good form to include both the name of the tool
571 and its version, but this field is essentially opaque, at least for
572 the moment. If \fIMETA.yml\fR was generated by hand, it is suggested that
573 the author be specified here.
574 .PP
575 [Note: My \fImeta_stats.pl\fR script which I use to gather statistics
576 regarding \fIMETA.yml\fR usage prefers the form listed above, i.e. it
577 splits on /\es+version\es+/ taking the first field as the name of the
578 tool that generated the file and the second field as version of that
579 tool. RWS]
580 .SH "VERSION SPECIFICATIONS"
581 .IX Header "VERSION SPECIFICATIONS"
582 Some fields require a version specification (ex. "requires",
583 "recommends", "build_requires", etc.) to indicate the particular
584 version(s) of some other module that may be required as a
585 prerequisite. This section details the version specification formats
586 that are currently supported.
587 .PP
588 The simplest format for a version specification is just the version
589 number itself, e.g. \f(CW2.4\fR. This means that \fBat least\fR version 2.4
590 must be present. To indicate that \fBany\fR version of a prerequisite is
591 okay, even if the prerequisite doesn't define a version at all, use
592 the version \f(CW0\fR.
593 .PP
594 You may also use the operators < (less than), <= (less than or
595 equal), > (greater than), >= (greater than or equal), ==
596 (equal), and != (not equal). For example, the specification \f(CW<
597 2.0\fR means that any version of the prerequisite less than 2.0 is
598 suitable.
599 .PP
600 For more complicated situations, version specifications may be AND-ed
601 together using commas. The specification \f(CW>= 1.2, != 1.5, <
602 2.0\fR indicates a version that must be \fBat least\fR 1.2, \fBless than\fR
603 2.0, and \fBnot equal to\fR 1.5.
604 .SH "SEE ALSO"
605 .IX Header "SEE ALSO"
606 CPAN <http://www.cpan.org/>
607 .PP
608 CPAN.pm
609 .PP
610 CPANPLUS
611 .PP
612 Data::Dumper
613 .PP
614 ExtUtils::MakeMaker
615 .PP
616 Module::Build
617 .PP
618 Module::Install
619 .PP
620 XML <http://www.w3.org/XML/>
621 .PP
622 YAML <http://www.yaml.org/>
623 .SH HISTORY
624 .IX Header "HISTORY"
625 .IP "March 14, 2003 (Pi day)" 4
626 .IX Item "March 14, 2003 (Pi day)"
627 .RS 4
628 .PD 0
629 .IP \(bu 2
630 .PD
631 Created version 1.0 of this document.
632 .RE
633 .RS 4
634 .RE
635 .IP "May 8, 2003" 4
636 .IX Item "May 8, 2003"
637 .RS 4
638 .PD 0
639 .IP \(bu 2
640 .PD
641 Added the "dynamic_config" field, which was missing from the initial
642 version.
643 .RE
644 .RS 4
645 .RE
646 .IP "November 13, 2003" 4
647 .IX Item "November 13, 2003"
648 .RS 4
649 .PD 0
650 .IP \(bu 2
651 .PD
652 Added more YAML rationale articles.
653 .IP \(bu 2
654 Fixed existing link to YAML discussion thread to point to new
655 <http://nntp.x.perl.org/group/> site.
656 .IP \(bu 2
657 Added and deprecated the "private" field.
658 .IP \(bu 2
659 Added "abstract", \f(CW\*(C`configure\*(C'\fR, \f(CW\*(C`requires_packages\*(C'\fR,
660 \&\f(CW\*(C`requires_os\*(C'\fR, \f(CW\*(C`excludes_os\*(C'\fR, and "no_index" fields.
661 .IP \(bu 2
662 Bumped version.
663 .RE
664 .RS 4
665 .RE
666 .IP "November 16, 2003" 4
667 .IX Item "November 16, 2003"
668 .RS 4
669 .PD 0
670 .IP \(bu 2
671 .PD
672 Added \f(CW\*(C`generation\*(C'\fR, \f(CW\*(C`authored_by\*(C'\fR fields.
673 .IP \(bu 2
674 Add alternative proposal to the "recommends" field.
675 .IP \(bu 2
676 Add proposal for a \f(CW\*(C`requires_build_tools\*(C'\fR field.
677 .RE
678 .RS 4
679 .RE
680 .IP "December 9, 2003" 4
681 .IX Item "December 9, 2003"
682 .RS 4
683 .PD 0
684 .IP \(bu 2
685 .PD
686 Added link to latest version of this specification on CPAN.
687 .IP \(bu 2
688 Added section "VERSION SPECIFICATIONS".
689 .IP \(bu 2
690 Chang name from Module::Build::META\-spec to CPAN::META::Specification.
691 .IP \(bu 2
692 Add proposal for \f(CW\*(C`auto_regenerate\*(C'\fR field.
693 .RE
694 .RS 4
695 .RE
696 .IP "December 15, 2003" 4
697 .IX Item "December 15, 2003"
698 .RS 4
699 .PD 0
700 .IP \(bu 2
701 .PD
702 Add \f(CW\*(C`index\*(C'\fR field as a compliment to "no_index"
703 .IP \(bu 2
704 Add "keywords" field as a means to aid searching distributions.
705 .IP \(bu 2
706 Add "TERMINOLOGY" section to explain certain terms that may be
707 ambiguous.
708 .RE
709 .RS 4
710 .RE
711 .IP "July 26, 2005" 4
712 .IX Item "July 26, 2005"
713 .RS 4
714 .PD 0
715 .IP \(bu 2
716 .PD
717 Removed a bunch of items (generation, requires_build_tools,
718 requires_packages, configure, requires_os, excludes_os,
719 auto_regenerate) that have never actually been supported, but were
720 more like records of brainstorming.
721 .IP \(bu 2
722 Changed \f(CW\*(C`authored_by\*(C'\fR to "author", since that's always been what
723 it's actually called in actual \fIMETA.yml\fR files.
724 .IP \(bu 2
725 Added the "==" operator to the list of supported version-checking
726 operators.
727 .IP \(bu 2
728 Noted that the "distribution_type" field is basically meaningless,
729 and shouldn't really be used.
730 .IP \(bu 2
731 Clarified "dynamic_config" a bit.
732 .RE
733 .RS 4
734 .RE
735 .IP "August 23, 2005" 4
736 .IX Item "August 23, 2005"
737 .RS 4
738 .PD 0
739 .IP \(bu 2
740 .PD
741 Removed the name \f(CW\*(C`CPAN::META::Specification\*(C'\fR, since that implies a
742 module that doesn't actually exist.
743 .RE
744 .RS 4
745 .RE
746 .IP "June 12, 2007" 4
747 .IX Item "June 12, 2007"
748 .RS 4
749 .PD 0
750 .IP \(bu 2
751 .PD
752 Added "configure_requires".
753 .RE
754 .RS 4
755 .RE