Debian Codegraph @

upstream/opensuse-tumbleweed/man3/CPAN::Meta::History::Meta_1_3.3pm

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