Debian Codegraph @

upstream/opensuse-tumbleweed/man3/CPAN::Meta::History::Meta_1_2.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_2 3pm"
61 .TH CPAN::Meta::History::Meta_1_2 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_2 \- Version 1.2 metadata specification for META.yml
68 .SH PREFACE
69 .IX Header "PREFACE"
70 This is a historical copy of the version 1.2 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.2611 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.2
119 \& url: http://module\-build.sourceforge.net/META\-spec\-v1.2.html
120 \& generated_by: Module::Build version 0.20
121 .Ve
122 .SH DESCRIPTION
123 .IX Header "DESCRIPTION"
124 This document describes version 1.2 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 for other developers to use.
163 .IP module 4
164 .IX Item "module"
165 This refers to a reusable library of code typically contained in a
166 single file. Currently, we primarily talk of perl modules, but this
167 specification should be open enough to apply to other languages as
168 well (ex. python, ruby).
169 .SH "VERSION SPECIFICATIONS"
170 .IX Header "VERSION SPECIFICATIONS"
171 Some fields require a version specification (ex. "requires",
172 "recommends", "build_requires", etc.). This section details the
173 version specifications that are currently supported.
174 .PP
175 If a single version is listed, then that version is considered to be
176 the minimum version supported.
177 .PP
178 If 0 is given as the version number, then any version is supported.
179 .PP
180 Additionally, for more complicated requirements, the specification
181 supports a list of versions, each of which may be optionally preceded
182 by a relational operator.
183 .PP
184 Supported operators include < (less than), <= (less than or
185 equal), > (greater than), >= (greater than or equal), == (equal), and !=
186 (not equal).
187 .PP
188 If a list is given then it is evaluated from left to right so that any
189 specifications in the list that conflict with a previous specification
190 are overridden by the later.
191 .PP
192 Examples:
193 .PP
194 .Vb 1
195 \& >= 1.2, != 1.5, < 2.0
196 .Ve
197 .PP
198 Any version from version 1.2 onward, except version 1.5, that also
199 precedes version 2.0.
200 .SH HEADER
201 .IX Header "HEADER"
202 The first line of a \fIMETA.yml\fR file should be a valid YAML document
203 header like \f(CW"\-\-\- #YAML:1.0"\fR.
204 .SH FIELDS
205 .IX Header "FIELDS"
206 The rest of the \fIMETA.yml\fR file is one big YAML mapping whose keys
207 are described here.
208 .SS meta\-spec
209 .IX Subsection "meta-spec"
210 Example:
211 .PP
212 .Vb 3
213 \& meta\-spec:
214 \& version: 1.2
215 \& url: http://module\-build.sourceforge.net/META\-spec\-v1.2.html
216 .Ve
217 .PP
218 (Spec 1.1) [required] {URL} This field indicates the location of the
219 version of the META.yml specification used.
220 .SS name
221 .IX Subsection "name"
222 Example:
223 .PP
224 .Vb 1
225 \& name: Module\-Build
226 .Ve
227 .PP
228 (Spec 1.0) [required] {string} The name of the distribution which is often
229 created by taking the "main module" in the distribution and changing
230 "::" to "\-". Sometimes it\*(Aqs completely different, however, as in the
231 case of the libwww\-perl distribution (see
232 <http://search.cpan.org/author/GAAS/libwww\-perl/>).
233 .SS version
234 .IX Subsection "version"
235 Example:
236 .PP
237 .Vb 1
238 \& version: 0.20
239 .Ve
240 .PP
241 (Spec 1.0) [required] {version} The version of the distribution to which the
242 \&\fIMETA.yml\fR file refers.
243 .SS abstract
244 .IX Subsection "abstract"
245 Example:
246 .PP
247 .Vb 1
248 \& abstract: Build and install Perl modules.
249 .Ve
250 .PP
251 (Spec 1.1) [required] {string} A short description of the purpose of the
252 distribution.
253 .SS author
254 .IX Subsection "author"
255 Example:
256 .PP
257 .Vb 2
258 \& author:
259 \& \- Ken Williams <[email protected]>
260 .Ve
261 .PP
262 (Spec 1.1) [required] {list of strings} A YAML sequence indicating the author(s) of the
263 distribution. The preferred form is author\-name <email\-address>.
264 .SS license
265 .IX Subsection "license"
266 Example:
267 .PP
268 .Vb 1
269 \& license: perl
270 .Ve
271 .PP
272 (Spec 1.0) [required] {string} The license under which this distribution may be
273 used and redistributed.
274 .PP
275 Must be one of the following licenses:
276 .IP perl 4
277 .IX Item "perl"
278 The distribution may be copied and redistributed under the same terms as perl
279 itself (this is by far the most common licensing option for modules on CPAN).
280 This is a dual license, in which the user may choose between either the GPL
281 version 1 or the Artistic version 1 license.
282 .IP gpl 4
283 .IX Item "gpl"
284 The distribution is distributed under the terms of the GNU General Public
285 License version 2 (<http://opensource.org/licenses/GPL\-2.0>).
286 .IP lgpl 4
287 .IX Item "lgpl"
288 The distribution is distributed under the terms of the GNU Lesser General
289 Public License version 2 (<http://opensource.org/licenses/LGPL\-2.1>).
290 .IP artistic 4
291 .IX Item "artistic"
292 The distribution is licensed under the Artistic License version 1, as specified
293 by the Artistic file in the standard perl distribution
294 (<http://opensource.org/licenses/Artistic\-Perl\-1.0>).
295 .IP bsd 4
296 .IX Item "bsd"
297 The distribution is licensed under the BSD 3\-Clause License
298 (<http://opensource.org/licenses/BSD\-3\-Clause>).
299 .IP open_source 4
300 .IX Item "open_source"
301 The distribution is licensed under some other Open Source Initiative\-approved
302 license listed at <http://www.opensource.org/licenses/>.
303 .IP unrestricted 4
304 .IX Item "unrestricted"
305 The distribution is licensed under a license that is \fBnot\fR approved by
306 www.opensource.org <http://www.opensource.org/> but that allows distribution
307 without restrictions.
308 .IP restrictive 4
309 .IX Item "restrictive"
310 The distribution may not be redistributed without special permission from the
311 author and/or copyright holder.
312 .SS distribution_type
313 .IX Subsection "distribution_type"
314 Example:
315 .PP
316 .Vb 1
317 \& distribution_type: module
318 .Ve
319 .PP
320 (Spec 1.0) [optional] {string} What kind of stuff is contained in this
321 distribution. Most things on CPAN are \f(CW\*(C`module\*(C'\fRs (which can also mean
322 a collection of modules), but some things are \f(CW\*(C`script\*(C'\fRs.
323 .PP
324 Unfortunately this field is basically meaningless, since many
325 distributions are hybrids of several kinds of things, or some new
326 thing, or subjectively different in focus depending on who\*(Aqs using
327 them. Tools like Module::Build and MakeMaker will likely stop
328 generating this field.
329 .SS requires
330 .IX Subsection "requires"
331 Example:
332 .PP
333 .Vb 3
334 \& requires:
335 \& Data::Dumper: 0
336 \& File::Find: 1.03
337 .Ve
338 .PP
339 (Spec 1.0) [optional] {map} A YAML mapping indicating the Perl modules this
340 distribution requires for proper operation. The keys are the module
341 names, and the values are version specifications as described in
342 Module::Build for the "requires" parameter.
343 .SS recommends
344 .IX Subsection "recommends"
345 Example:
346 .PP
347 .Vb 3
348 \& recommends:
349 \& Data::Dumper: 0
350 \& File::Find: 1.03
351 .Ve
352 .PP
353 (Spec 1.0) [optional] {map} A YAML mapping indicating the Perl modules this
354 distribution recommends for enhanced operation.
355 .PP
356 \&\fIALTERNATIVE: It may be desirable to present to the user which
357 features depend on which modules so they can make an informed
358 decision about which recommended modules to install.\fR
359 .PP
360 Example:
361 .PP
362 .Vb 9
363 \& optional_features:
364 \& \- foo:
365 \& description: Provides the ability to blah.
366 \& requires:
367 \& Data::Dumper: 0
368 \& File::Find: 1.03
369 \& \- bar:
370 \& description: This feature is not available on this platform.
371 \& excludes_os: MSWin32
372 .Ve
373 .PP
374 \&\fI(Spec 1.1) [optional] {map} A YAML sequence of names for optional features
375 which are made available when its requirements are met. For each
376 feature a description is provided along with any of "requires",
377 "build_requires", "conflicts", \fR\f(CI\*(C`requires_packages\*(C'\fR\fI,
378 \&\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
379 this subcontext as described elsewhere in this document.\fR
380 .SS build_requires
381 .IX Subsection "build_requires"
382 Example:
383 .PP
384 .Vb 3
385 \& build_requires:
386 \& Data::Dumper: 0
387 \& File::Find: 1.03
388 .Ve
389 .PP
390 (Spec 1.0) [optional] {map} A YAML mapping indicating the Perl modules
391 required for building and/or testing of this distribution. These
392 dependencies are not required after the module 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 the Perl modules that
404 cannot be installed while this distribution is installed. This is a
405 pretty uncommon situation.
406 .SS dynamic_config
407 .IX Subsection "dynamic_config"
408 Example:
409 .PP
410 .Vb 1
411 \& dynamic_config: 0
412 .Ve
413 .PP
414 (Spec 1.0) [optional] {boolean} A boolean flag indicating whether a \fIBuild.PL\fR
415 or \fIMakefile.PL\fR (or similar) must be executed when building this
416 distribution, or whether it can be built, tested and installed solely
417 from consulting its
418 metadata file. The main reason to set this to a true value if that
419 your module performs some dynamic configuration (asking questions,
420 sensing the environment, etc.) as part of its build/install process.
421 .PP
422 Currently Module::Build doesn\*(Aqt actually do anything with this flag
423 \&\- it\*(Aqs probably going to be up to higher\-level tools like CPAN
424 to do something useful with it. It can potentially bring lots of
425 security, packaging, and convenience improvements.
426 .PP
427 If this field is omitted, it defaults to 1 (true).
428 .SS private
429 .IX Subsection "private"
430 \&\fI(Deprecated)\fR (Spec 1.0) [optional] {map} This field has been renamed to
431 "no_index". See below.
432 .SS provides
433 .IX Subsection "provides"
434 Example:
435 .PP
436 .Vb 9
437 \& provides:
438 \& Foo::Bar:
439 \& file: lib/Foo/Bar.pm
440 \& version: 0.27_02
441 \& Foo::Bar::Blah:
442 \& file: lib/Foo/Bar/Blah.pm
443 \& Foo::Bar::Baz:
444 \& file: lib/Foo/Bar/Baz.pm
445 \& version: 0.3
446 .Ve
447 .PP
448 (Spec 1.1) [optional] {map} A YAML mapping that describes all packages
449 provided by this distribution. This information can be (and, in some
450 cases, is) used by distribution and automation mechanisms like PAUSE,
451 CPAN, and search.cpan.org to build indexes saying in which
452 distribution various packages can be found.
453 .PP
454 When using tools like Module::Build that can generate the
455 \&\f(CW\*(C`provides\*(C'\fR mapping for your distribution automatically, make sure you
456 examine what it generates to make sure it makes sense \- indexers will
457 usually trust the \f(CW\*(C`provides\*(C'\fR field if it\*(Aqs present, rather than
458 scanning through the distribution files themselves to figure out
459 packages and versions. This is a good thing, because it means you can
460 use the \f(CW\*(C`provides\*(C'\fR field to tell the indexers precisely what you want
461 indexed about your distribution, rather than relying on them to
462 essentially guess what you want indexed.
463 .SS no_index
464 .IX Subsection "no_index"
465 Example:
466 .PP
467 .Vb 9
468 \& no_index:
469 \& file:
470 \& \- My/Module.pm
471 \& dir:
472 \& \- My/Private
473 \& package:
474 \& \- My::Module::Stuff
475 \& namespace:
476 \& \- My::Module::Stuff
477 .Ve
478 .PP
479 (Spec 1.1) [optional] {map} A YAML mapping that describes any files,
480 directories, packages, and namespaces that are private
481 (i.e. implementation artifacts) that are not of interest to searching
482 and indexing tools. This is useful when no \f(CW\*(C`provides\*(C'\fR field is
483 present.
484 .PP
485 \&\fI(Note: I\*(Aqm not actually sure who looks at this field, or exactly
486 what they do with it. This spec could be off in some way from actual
487 usage.)\fR
488 .PP
489 \fIfile\fR
490 .IX Subsection "file"
491 .PP
492 (Spec 1.1) [optional] Exclude any listed file(s).
493 .PP
494 \fIdir\fR
495 .IX Subsection "dir"
496 .PP
497 (Spec 1.1) [optional] Exclude anything below the listed
498 directory(ies).
499 .PP
500 \fIpackage\fR
501 .IX Subsection "package"
502 .PP
503 (Spec 1.1) [optional] Exclude the listed package(s).
504 .PP
505 \fInamespace\fR
506 .IX Subsection "namespace"
507 .PP
508 (Spec 1.1) [optional] Excludes anything below the listed namespace(s),
509 but \fInot\fR the listed namespace(s) its self.
510 .SS keywords
511 .IX Subsection "keywords"
512 Example:
513 .PP
514 .Vb 4
515 \& keywords:
516 \& \- make
517 \& \- build
518 \& \- install
519 .Ve
520 .PP
521 (Spec 1.1) [optional] {list} A sequence of keywords/phrases that describe
522 this distribution.
523 .SS resources
524 .IX Subsection "resources"
525 Example:
526 .PP
527 .Vb 5
528 \& resources:
529 \& license: http://dev.perl.org/licenses/
530 \& homepage: http://sourceforge.net/projects/module\-build
531 \& bugtracker: http://rt.cpan.org/NoAuth/Bugs.html?Dist=Module\-Build
532 \& MailingList: http://lists.sourceforge.net/lists/listinfo/module\-build\-general
533 .Ve
534 .PP
535 (Spec 1.1) [optional] {map} A mapping of any URL resources related to
536 this distribution. All\-lower\-case keys, such as \f(CW\*(C`homepage\*(C'\fR,
537 \&\f(CW\*(C`license\*(C'\fR, and \f(CW\*(C`bugtracker\*(C'\fR, are reserved by this specification, as
538 they have "official" meanings defined here in this specification. If
539 you\*(Aqd like to add your own "special" entries (like the "MailingList"
540 entry above), use at least one upper\-case letter.
541 .PP
542 The current set of official keys is:
543 .IP homepage 2
544 .IX Item "homepage"
545 The official home of this project on the web.
546 .IP license 2
547 .IX Item "license"
548 An URL for an official statement of this distribution\*(Aqs license.
549 .IP bugtracker 2
550 .IX Item "bugtracker"
551 An URL for a bug tracker (e.g. Bugzilla or RT queue) for this project.
552 .SS generated_by
553 .IX Subsection "generated_by"
554 Example:
555 .PP
556 .Vb 1
557 \& generated_by: Module::Build version 0.20
558 .Ve
559 .PP
560 (Spec 1.0) [required] {string} Indicates the tool that was used to create this
561 \&\fIMETA.yml\fR file. It\*(Aqs good form to include both the name of the tool
562 and its version, but this field is essentially opaque, at least for
563 the moment. If \fIMETA.yml\fR was generated by hand, it is suggested that
564 the author be specified here.
565 .PP
566 [Note: My \fImeta_stats.pl\fR script which I use to gather statistics
567 regarding \fIMETA.yml\fR usage prefers the form listed above, i.e. it
568 splits on /\es+version\es+/ taking the first field as the name of the
569 tool that generated the file and the second field as version of that
570 tool. RWS]
571 .SH "SEE ALSO"
572 .IX Header "SEE ALSO"
573 CPAN <http://www.cpan.org/>
574 .PP
575 CPAN.pm
576 .PP
577 CPANPLUS
578 .PP
579 Data::Dumper
580 .PP
581 ExtUtils::MakeMaker
582 .PP
583 Module::Build
584 .PP
585 Module::Install
586 .PP
587 XML <http://www.w3.org/XML/>
588 .PP
589 YAML <http://www.yaml.org/>
590 .SH HISTORY
591 .IX Header "HISTORY"
592 .IP "March 14, 2003 (Pi day)" 4
593 .IX Item "March 14, 2003 (Pi day)"
594 .RS 4
595 .PD 0
596 .IP \(bu 2
597 .PD
598 Created version 1.0 of this document.
599 .RE
600 .RS 4
601 .RE
602 .IP "May 8, 2003" 4
603 .IX Item "May 8, 2003"
604 .RS 4
605 .PD 0
606 .IP \(bu 2
607 .PD
608 Added the "dynamic_config" field, which was missing from the initial
609 version.
610 .RE
611 .RS 4
612 .RE
613 .IP "November 13, 2003" 4
614 .IX Item "November 13, 2003"
615 .RS 4
616 .PD 0
617 .IP \(bu 2
618 .PD
619 Added more YAML rationale articles.
620 .IP \(bu 2
621 Fixed existing link to YAML discussion thread to point to new
622 <http://nntp.x.perl.org/group/> site.
623 .IP \(bu 2
624 Added and deprecated the "private" field.
625 .IP \(bu 2
626 Added "abstract", \f(CW\*(C`configure\*(C'\fR, \f(CW\*(C`requires_packages\*(C'\fR,
627 \&\f(CW\*(C`requires_os\*(C'\fR, \f(CW\*(C`excludes_os\*(C'\fR, and "no_index" fields.
628 .IP \(bu 2
629 Bumped version.
630 .RE
631 .RS 4
632 .RE
633 .IP "November 16, 2003" 4
634 .IX Item "November 16, 2003"
635 .RS 4
636 .PD 0
637 .IP \(bu 2
638 .PD
639 Added \f(CW\*(C`generation\*(C'\fR, \f(CW\*(C`authored_by\*(C'\fR fields.
640 .IP \(bu 2
641 Add alternative proposal to the "recommends" field.
642 .IP \(bu 2
643 Add proposal for a \f(CW\*(C`requires_build_tools\*(C'\fR field.
644 .RE
645 .RS 4
646 .RE
647 .IP "December 9, 2003" 4
648 .IX Item "December 9, 2003"
649 .RS 4
650 .PD 0
651 .IP \(bu 2
652 .PD
653 Added link to latest version of this specification on CPAN.
654 .IP \(bu 2
655 Added section "VERSION SPECIFICATIONS".
656 .IP \(bu 2
657 Chang name from Module::Build::META\-spec to CPAN::META::Specification.
658 .IP \(bu 2
659 Add proposal for \f(CW\*(C`auto_regenerate\*(C'\fR field.
660 .RE
661 .RS 4
662 .RE
663 .IP "December 15, 2003" 4
664 .IX Item "December 15, 2003"
665 .RS 4
666 .PD 0
667 .IP \(bu 2
668 .PD
669 Add \f(CW\*(C`index\*(C'\fR field as a compliment to "no_index"
670 .IP \(bu 2
671 Add "keywords" field as a means to aid searching distributions.
672 .IP \(bu 2
673 Add "TERMINOLOGY" section to explain certain terms that may be
674 ambiguous.
675 .RE
676 .RS 4
677 .RE
678 .IP "July 26, 2005" 4
679 .IX Item "July 26, 2005"
680 .RS 4
681 .PD 0
682 .IP \(bu 2
683 .PD
684 Removed a bunch of items (generation, requires_build_tools,
685 requires_packages, configure, requires_os, excludes_os,
686 auto_regenerate) that have never actually been supported, but were
687 more like records of brainstorming.
688 .IP \(bu 2
689 Changed \f(CW\*(C`authored_by\*(C'\fR to "author", since that\*(Aqs always been what
690 it\*(Aqs actually called in actual \fIMETA.yml\fR files.
691 .IP \(bu 2
692 Added the "==" operator to the list of supported version\-checking
693 operators.
694 .IP \(bu 2
695 Noted that the "distribution_type" field is basically meaningless,
696 and shouldn\*(Aqt really be used.
697 .IP \(bu 2
698 Clarified "dynamic_config" a bit.
699 .RE
700 .RS 4
701 .RE
702 .IP "August 23, 2005" 4
703 .IX Item "August 23, 2005"
704 .RS 4
705 .PD 0
706 .IP \(bu 2
707 .PD
708 Removed the name \f(CW\*(C`CPAN::META::Specification\*(C'\fR, since that implies a
709 module that doesn\*(Aqt actually exist.
710 .RE
711 .RS 4
712 .RE