Debian Codegraph @

upstream/debian-unstable/man3/CPAN::Meta::History::Meta_1_3.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_3 3perl"
58 .TH CPAN::Meta::History::Meta_1_3 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_3 \- Version 1.3 metadata specification for META.yml
65 .SH PREFACE
66 .IX Header "PREFACE"
67 This is a historical copy of the version 1.3 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.2805 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 \& urls:
113 \& license: http://dev.perl.org/licenses/
114 \& meta\-spec:
115 \& version: 1.3
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.3 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.3
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 distribution may be
241 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
283 version 1 or the Artistic version 1 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 modules this
321 distribution requires for proper operation. The keys are the module
322 names, and the values are version specifications as described in
323 "VERSION SPECIFICATIONS".
324 .SS recommends
325 .IX Subsection "recommends"
326 Example:
327 .PP
328 .Vb 3
329 \& recommends:
330 \& Data::Dumper: 0
331 \& File::Find: 1.03
332 .Ve
333 .PP
334 (Spec 1.0) [optional] {map} A YAML mapping indicating the Perl modules
335 this distribution recommends for enhanced operation. The keys are the
336 module names, and the values are version specifications as described
337 in "VERSION SPECIFICATIONS".
338 .PP
339 \&\fIALTERNATIVE: It may be desirable to present to the user which
340 features depend on which modules so they can make an informed decision
341 about which recommended modules to install.\fR
342 .PP
343 Example:
344 .PP
345 .Vb 9
346 \& optional_features:
347 \& \- foo:
348 \& description: Provides the ability to blah.
349 \& requires:
350 \& Data::Dumper: 0
351 \& File::Find: 1.03
352 \& \- bar:
353 \& description: This feature is not available on this platform.
354 \& excludes_os: MSWin32
355 .Ve
356 .PP
357 \&\fI(Spec 1.1) [optional] {map} A YAML sequence of names for optional features
358 which are made available when its requirements are met. For each
359 feature a description is provided along with any of "requires",
360 "build_requires", "conflicts", \fR\f(CI\*(C`requires_packages\*(C'\fR\fI,
361 \&\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
362 this subcontext as described elsewhere in this document.\fR
363 .SS build_requires
364 .IX Subsection "build_requires"
365 Example:
366 .PP
367 .Vb 3
368 \& build_requires:
369 \& Data::Dumper: 0
370 \& File::Find: 1.03
371 .Ve
372 .PP
373 (Spec 1.0) [optional] {map} A YAML mapping indicating the Perl modules
374 required for building and/or testing of this distribution. The keys
375 are the module names, and the values are version specifications as
376 described in "VERSION SPECIFICATIONS". These dependencies are not
377 required after the module is installed.
378 .SS conflicts
379 .IX Subsection "conflicts"
380 Example:
381 .PP
382 .Vb 3
383 \& conflicts:
384 \& Data::Dumper: 0
385 \& File::Find: 1.03
386 .Ve
387 .PP
388 (Spec 1.0) [optional] {map} A YAML mapping indicating the Perl modules that
389 cannot be installed while this distribution is installed. This is a
390 pretty uncommon situation. The keys for \f(CW\*(C`conflicts\*(C'\fR are the module
391 names, and the values are version specifications as described in
392 "VERSION SPECIFICATIONS".
393 .SS dynamic_config
394 .IX Subsection "dynamic_config"
395 Example:
396 .PP
397 .Vb 1
398 \& dynamic_config: 0
399 .Ve
400 .PP
401 (Spec 1.0) [optional] {boolean} A boolean flag indicating whether a \fIBuild.PL\fR
402 or \fIMakefile.PL\fR (or similar) must be executed when building this
403 distribution, or whether it can be built, tested and installed solely
404 from consulting its
405 metadata file. The main reason to set this to a true value is that
406 your module performs some dynamic configuration (asking questions,
407 sensing the environment, etc.) as part of its build/install process.
408 .PP
409 Currently Module::Build doesn't actually do anything with this flag
410 \&\- it's probably going to be up to higher-level tools like CPAN
411 to do something useful with it. It can potentially bring lots of
412 security, packaging, and convenience improvements.
413 .PP
414 If this field is omitted, it defaults to 1 (true).
415 .SS private
416 .IX Subsection "private"
417 \&\fI(Deprecated)\fR (Spec 1.0) [optional] {map} This field has been renamed to
418 "no_index". See below.
419 .SS provides
420 .IX Subsection "provides"
421 Example:
422 .PP
423 .Vb 9
424 \& provides:
425 \& Foo::Bar:
426 \& file: lib/Foo/Bar.pm
427 \& version: 0.27_02
428 \& Foo::Bar::Blah:
429 \& file: lib/Foo/Bar/Blah.pm
430 \& Foo::Bar::Baz:
431 \& file: lib/Foo/Bar/Baz.pm
432 \& version: 0.3
433 .Ve
434 .PP
435 (Spec 1.1) [optional] {map} A YAML mapping that describes all packages
436 provided by this distribution. This information can be (and, in some
437 cases, is) used by distribution and automation mechanisms like PAUSE,
438 CPAN, and search.cpan.org to build indexes saying in which
439 distribution various packages can be found.
440 .PP
441 When using tools like Module::Build that can generate the
442 \&\f(CW\*(C`provides\*(C'\fR mapping for your distribution automatically, make sure you
443 examine what it generates to make sure it makes sense \- indexers will
444 usually trust the \f(CW\*(C`provides\*(C'\fR field if it's present, rather than
445 scanning through the distribution files themselves to figure out
446 packages and versions. This is a good thing, because it means you can
447 use the \f(CW\*(C`provides\*(C'\fR field to tell the indexers precisely what you want
448 indexed about your distribution, rather than relying on them to
449 essentially guess what you want indexed.
450 .SS no_index
451 .IX Subsection "no_index"
452 Example:
453 .PP
454 .Vb 9
455 \& no_index:
456 \& file:
457 \& \- My/Module.pm
458 \& directory:
459 \& \- My/Private
460 \& package:
461 \& \- My::Module::Stuff
462 \& namespace:
463 \& \- My::Module::Stuff
464 .Ve
465 .PP
466 (Spec 1.1) [optional] {map} A YAML mapping that describes any files,
467 directories, packages, and namespaces that are private
468 (i.e. implementation artifacts) that are not of interest to searching
469 and indexing tools. This is useful when no \f(CW\*(C`provides\*(C'\fR field is
470 present.
471 .PP
472 For example, <http://search.cpan.org/> excludes items listed in \f(CW\*(C`no_index\*(C'\fR
473 when searching for POD, meaning files in these directories will not
474 converted to HTML and made public \- which is useful if you have
475 example or test PODs that you don't want the search engine to go
476 through.
477 .PP
478 \fIfile\fR
479 .IX Subsection "file"
480 .PP
481 (Spec 1.1) [optional] Exclude any listed file(s).
482 .PP
483 \fIdirectory\fR
484 .IX Subsection "directory"
485 .PP
486 (Spec 1.1) [optional] Exclude anything below the listed
487 directory(ies).
488 .PP
489 [Note: previous editions of the spec had \f(CW\*(C`dir\*(C'\fR instead of
490 \&\f(CW\*(C`directory\*(C'\fR, but I think MakeMaker and various users started using
491 \&\f(CW\*(C`directory\*(C'\fR, so in deference we switched to that.]
492 .PP
493 \fIpackage\fR
494 .IX Subsection "package"
495 .PP
496 (Spec 1.1) [optional] Exclude the listed package(s).
497 .PP
498 \fInamespace\fR
499 .IX Subsection "namespace"
500 .PP
501 (Spec 1.1) [optional] Excludes anything below the listed namespace(s),
502 but \fInot\fR the listed namespace(s) its self.
503 .SS keywords
504 .IX Subsection "keywords"
505 Example:
506 .PP
507 .Vb 4
508 \& keywords:
509 \& \- make
510 \& \- build
511 \& \- install
512 .Ve
513 .PP
514 (Spec 1.1) [optional] {list} A sequence of keywords/phrases that describe
515 this distribution.
516 .SS resources
517 .IX Subsection "resources"
518 Example:
519 .PP
520 .Vb 6
521 \& resources:
522 \& license: http://dev.perl.org/licenses/
523 \& homepage: http://sourceforge.net/projects/module\-build
524 \& bugtracker: http://rt.cpan.org/NoAuth/Bugs.html?Dist=Module\-Build
525 \& repository: http://sourceforge.net/cvs/?group_id=45731
526 \& MailingList: http://lists.sourceforge.net/lists/listinfo/module\-build\-general
527 .Ve
528 .PP
529 (Spec 1.1) [optional] {map} A mapping of any URL resources related to
530 this distribution. All-lower-case keys, such as \f(CW\*(C`homepage\*(C'\fR,
531 \&\f(CW\*(C`license\*(C'\fR, and \f(CW\*(C`bugtracker\*(C'\fR, are reserved by this specification, as
532 they have "official" meanings defined here in this specification. If
533 you'd like to add your own "special" entries (like the "MailingList"
534 entry above), use at least one upper-case letter.
535 .PP
536 The current set of official keys is:
537 .IP homepage 2
538 .IX Item "homepage"
539 The official home of this project on the web.
540 .IP license 2
541 .IX Item "license"
542 An URL for an official statement of this distribution's license.
543 .IP bugtracker 2
544 .IX Item "bugtracker"
545 An URL for a bug tracker (e.g. Bugzilla or RT queue) for this project.
546 .SS generated_by
547 .IX Subsection "generated_by"
548 Example:
549 .PP
550 .Vb 1
551 \& generated_by: Module::Build version 0.20
552 .Ve
553 .PP
554 (Spec 1.0) [required] {string} Indicates the tool that was used to create this
555 \&\fIMETA.yml\fR file. It's good form to include both the name of the tool
556 and its version, but this field is essentially opaque, at least for
557 the moment. If \fIMETA.yml\fR was generated by hand, it is suggested that
558 the author be specified here.
559 .PP
560 [Note: My \fImeta_stats.pl\fR script which I use to gather statistics
561 regarding \fIMETA.yml\fR usage prefers the form listed above, i.e. it
562 splits on /\es+version\es+/ taking the first field as the name of the
563 tool that generated the file and the second field as version of that
564 tool. RWS]
565 .SH "VERSION SPECIFICATIONS"
566 .IX Header "VERSION SPECIFICATIONS"
567 Some fields require a version specification (ex. "requires",
568 "recommends", "build_requires", etc.) to indicate the particular
569 version(s) of some other module that may be required as a
570 prerequisite. This section details the version specification formats
571 that are currently supported.
572 .PP
573 The simplest format for a version specification is just the version
574 number itself, e.g. \f(CW2.4\fR. This means that \fBat least\fR version 2.4
575 must be present. To indicate that \fBany\fR version of a prerequisite is
576 okay, even if the prerequisite doesn't define a version at all, use
577 the version \f(CW0\fR.
578 .PP
579 You may also use the operators < (less than), <= (less than or
580 equal), > (greater than), >= (greater than or equal), ==
581 (equal), and != (not equal). For example, the specification \f(CW<
582 2.0\fR means that any version of the prerequisite less than 2.0 is
583 suitable.
584 .PP
585 For more complicated situations, version specifications may be AND-ed
586 together using commas. The specification \f(CW>= 1.2, != 1.5, <
587 2.0\fR indicates a version that must be \fBat least\fR 1.2, \fBless than\fR
588 2.0, and \fBnot equal to\fR 1.5.
589 .SH "SEE ALSO"
590 .IX Header "SEE ALSO"
591 CPAN <http://www.cpan.org/>
592 .PP
593 CPAN.pm
594 .PP
595 CPANPLUS
596 .PP
597 Data::Dumper
598 .PP
599 ExtUtils::MakeMaker
600 .PP
601 Module::Build
602 .PP
603 Module::Install
604 .PP
605 XML <http://www.w3.org/XML/>
606 .PP
607 YAML <http://www.yaml.org/>
608 .SH HISTORY
609 .IX Header "HISTORY"
610 .IP "March 14, 2003 (Pi day)" 4
611 .IX Item "March 14, 2003 (Pi day)"
612 .RS 4
613 .PD 0
614 .IP \(bu 2
615 .PD
616 Created version 1.0 of this document.
617 .RE
618 .RS 4
619 .RE
620 .IP "May 8, 2003" 4
621 .IX Item "May 8, 2003"
622 .RS 4
623 .PD 0
624 .IP \(bu 2
625 .PD
626 Added the "dynamic_config" field, which was missing from the initial
627 version.
628 .RE
629 .RS 4
630 .RE
631 .IP "November 13, 2003" 4
632 .IX Item "November 13, 2003"
633 .RS 4
634 .PD 0
635 .IP \(bu 2
636 .PD
637 Added more YAML rationale articles.
638 .IP \(bu 2
639 Fixed existing link to YAML discussion thread to point to new
640 <http://nntp.x.perl.org/group/> site.
641 .IP \(bu 2
642 Added and deprecated the "private" field.
643 .IP \(bu 2
644 Added "abstract", \f(CW\*(C`configure\*(C'\fR, \f(CW\*(C`requires_packages\*(C'\fR,
645 \&\f(CW\*(C`requires_os\*(C'\fR, \f(CW\*(C`excludes_os\*(C'\fR, and "no_index" fields.
646 .IP \(bu 2
647 Bumped version.
648 .RE
649 .RS 4
650 .RE
651 .IP "November 16, 2003" 4
652 .IX Item "November 16, 2003"
653 .RS 4
654 .PD 0
655 .IP \(bu 2
656 .PD
657 Added \f(CW\*(C`generation\*(C'\fR, \f(CW\*(C`authored_by\*(C'\fR fields.
658 .IP \(bu 2
659 Add alternative proposal to the "recommends" field.
660 .IP \(bu 2
661 Add proposal for a \f(CW\*(C`requires_build_tools\*(C'\fR field.
662 .RE
663 .RS 4
664 .RE
665 .IP "December 9, 2003" 4
666 .IX Item "December 9, 2003"
667 .RS 4
668 .PD 0
669 .IP \(bu 2
670 .PD
671 Added link to latest version of this specification on CPAN.
672 .IP \(bu 2
673 Added section "VERSION SPECIFICATIONS".
674 .IP \(bu 2
675 Chang name from Module::Build::META\-spec to CPAN::META::Specification.
676 .IP \(bu 2
677 Add proposal for \f(CW\*(C`auto_regenerate\*(C'\fR field.
678 .RE
679 .RS 4
680 .RE
681 .IP "December 15, 2003" 4
682 .IX Item "December 15, 2003"
683 .RS 4
684 .PD 0
685 .IP \(bu 2
686 .PD
687 Add \f(CW\*(C`index\*(C'\fR field as a compliment to "no_index"
688 .IP \(bu 2
689 Add "keywords" field as a means to aid searching distributions.
690 .IP \(bu 2
691 Add "TERMINOLOGY" section to explain certain terms that may be
692 ambiguous.
693 .RE
694 .RS 4
695 .RE
696 .IP "July 26, 2005" 4
697 .IX Item "July 26, 2005"
698 .RS 4
699 .PD 0
700 .IP \(bu 2
701 .PD
702 Removed a bunch of items (generation, requires_build_tools,
703 requires_packages, configure, requires_os, excludes_os,
704 auto_regenerate) that have never actually been supported, but were
705 more like records of brainstorming.
706 .IP \(bu 2
707 Changed \f(CW\*(C`authored_by\*(C'\fR to "author", since that's always been what
708 it's actually called in actual \fIMETA.yml\fR files.
709 .IP \(bu 2
710 Added the "==" operator to the list of supported version-checking
711 operators.
712 .IP \(bu 2
713 Noted that the "distribution_type" field is basically meaningless,
714 and shouldn't really be used.
715 .IP \(bu 2
716 Clarified "dynamic_config" a bit.
717 .RE
718 .RS 4
719 .RE
720 .IP "August 23, 2005" 4
721 .IX Item "August 23, 2005"
722 .RS 4
723 .PD 0
724 .IP \(bu 2
725 .PD
726 Removed the name \f(CW\*(C`CPAN::META::Specification\*(C'\fR, since that implies a
727 module that doesn't actually exist.
728 .RE
729 .RS 4
730 .RE