Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 234 insertions, 0 deletions

diff --git a/upstream/debian-unstable/man3/CPAN::Meta::History.3perl b/upstream/debian-unstable/man3/CPAN::Meta::History.3perl
new file mode 100644
index 00000000..8254b503
--- /dev/null
+++ b/upstream/debian-unstable/man3/CPAN::Meta::History.3perl
@@ -0,0 +1,234 @@
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
+.ie n \{\
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds C`
+.    ds C'
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
+.\" If the F register is >0, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.\"
+.\" Avoid warning from groff about undefined register 'F'.
+.de IX
+..
+.nr rF 0
+.if \n(.g .if rF .nr rF 1
+.if (\n(rF:(\n(.g==0)) \{\
+.    if \nF \{\
+.        de IX
+.        tm Index:\\$1\t\\n%\t"\\$2"
+..
+.        if !\nF==2 \{\
+.            nr % 0
+.            nr F 2
+.        \}
+.    \}
+.\}
+.rr rF
+.\" ========================================================================
+.\"
+.IX Title "CPAN::Meta::History 3perl"
+.TH CPAN::Meta::History 3perl 2024-01-12 "perl v5.38.2" "Perl Programmers Reference Guide"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH NAME
+CPAN::Meta::History \- history of CPAN Meta Spec changes
+.SH VERSION
+.IX Header "VERSION"
+version 2.150010
+.SH DESCRIPTION
+.IX Header "DESCRIPTION"
+The CPAN Meta Spec has gone through several iterations.  It was
+originally written in HTML and later revised into POD (though published
+in HTML generated from the POD).  Fields were added, removed or changed,
+sometimes by design and sometimes to reflect real-world usage after the
+fact.
+.PP
+This document reconstructs the history of the CPAN Meta Spec based on
+change logs, repository commit messages and the published HTML files.
+In some cases, particularly prior to version 1.2, the exact version
+when certain fields were introduced or changed is inconsistent between
+sources.  When in doubt, the published HTML files for versions 1.0 to
+1.4 as they existed when version 2 was developed are used as the
+definitive source.
+.PP
+Starting with version 2, the specification document is part of the
+CPAN-Meta distribution and will be published on CPAN as
+CPAN::Meta::Spec.
+.PP
+Going forward, specification version numbers will be integers and
+decimal portions will correspond to a release date for the CPAN::Meta
+library.
+.SH HISTORY
+.IX Header "HISTORY"
+.SS "Version 2"
+.IX Subsection "Version 2"
+April 2010
+.IP \(bu 4
+Revised spec examples as perl data structures rather than YAML
+.IP \(bu 4
+Switched to JSON serialization from YAML
+.IP \(bu 4
+Specified allowed version number formats
+.IP \(bu 4
+Replaced 'requires', 'build_requires', 'configure_requires',
+\&'recommends' and 'conflicts' with new 'prereqs' data structure divided
+by \fIphase\fR (configure, build, test, runtime, etc.) and \fIrelationship\fR
+(requires, recommends, suggests, conflicts)
+.IP \(bu 4
+Added support for 'develop' phase for requirements for maintaining
+a list of authoring tools
+.IP \(bu 4
+Changed 'license' to a list and revised the set of valid licenses
+.IP \(bu 4
+Made 'dynamic_config' mandatory to reduce confusion
+.IP \(bu 4
+Changed 'resources' subkey 'repository' to a hash that clarifies
+repository type, url for browsing and url for checkout
+.IP \(bu 4
+Changed 'resources' subkey 'bugtracker' to a hash for either web
+or mailto resource
+.IP \(bu 4
+Changed specification of 'optional_features':
+.RS 4
+.IP \(bu 4
+Added formal specification and usage guide instead of just example
+.IP \(bu 4
+Changed to use new prereqs data structure instead of individual keys
+.RE
+.RS 4
+.RE
+.IP \(bu 4
+Clarified intended use of 'author' as generalized contact list
+.IP \(bu 4
+Added 'release_status' field to indicate stable, testing or unstable
+status to provide hints to indexers
+.IP \(bu 4
+Added 'description' field for a longer description of the distribution
+.IP \(bu 4
+Formalized use of "x_" or "X_" for all custom keys not listed in the
+official spec
+.SS "Version 1.4"
+.IX Subsection "Version 1.4"
+June 2008
+.IP \(bu 4
+Noted explicit support for 'perl' in prerequisites
+.IP \(bu 4
+Added 'configure_requires' prerequisite type
+.IP \(bu 4
+Changed 'optional_features'
+.RS 4
+.IP \(bu 4
+Example corrected to show map of maps instead of list of maps
+(though descriptive text said 'map' even in v1.3)
+.IP \(bu 4
+Removed 'requires_packages', 'requires_os' and 'excluded_os'
+as valid subkeys
+.RE
+.RS 4
+.RE
+.SS "Version 1.3"
+.IX Subsection "Version 1.3"
+November 2006
+.IP \(bu 4
+Added 'no_index' subkey 'directory' and removed 'dir' to match actual
+usage in the wild
+.IP \(bu 4
+Added a 'repository' subkey to 'resources'
+.SS "Version 1.2"
+.IX Subsection "Version 1.2"
+August 2005
+.IP \(bu 4
+Re-wrote and restructured spec in POD syntax
+.IP \(bu 4
+Changed 'name' to be mandatory
+.IP \(bu 4
+Changed 'generated_by' to be mandatory
+.IP \(bu 4
+Changed 'license' to be mandatory
+.IP \(bu 4
+Added version range specifications for prerequisites
+.IP \(bu 4
+Added required 'abstract' field
+.IP \(bu 4
+Added required 'author' field
+.IP \(bu 4
+Added required 'meta\-spec' field to define 'version' (and 'url') of the
+CPAN Meta Spec used for metadata
+.IP \(bu 4
+Added 'provides' field
+.IP \(bu 4
+Added 'no_index' field and deprecated 'private' field.  'no_index'
+subkeys include 'file', 'dir', 'package' and 'namespace'
+.IP \(bu 4
+Added 'keywords' field
+.IP \(bu 4
+Added 'resources' field with subkeys 'homepage', 'license', and
+\&'bugtracker'
+.IP \(bu 4
+Added 'optional_features' field as an alternate under 'recommends'.
+Includes 'description', 'requires', 'build_requires', 'conflicts',
+\&'requires_packages', 'requires_os' and 'excluded_os' as valid subkeys
+.IP \(bu 4
+Removed 'license_uri' field
+.SS "Version 1.1"
+.IX Subsection "Version 1.1"
+May 2003
+.IP \(bu 4
+Changed 'version' to be mandatory
+.IP \(bu 4
+Added 'private' field
+.IP \(bu 4
+Added 'license_uri' field
+.SS "Version 1.0"
+.IX Subsection "Version 1.0"
+March 2003
+.IP \(bu 4
+Original release (in HTML format only)
+.IP \(bu 4
+Included 'name', 'version', 'license', 'distribution_type', 'requires',
+\&'recommends', 'build_requires', 'conflicts', 'dynamic_config',
+\&'generated_by'
+.SH AUTHORS
+.IX Header "AUTHORS"
+.IP \(bu 4
+David Golden <dagolden@cpan.org>
+.IP \(bu 4
+Ricardo Signes <rjbs@cpan.org>
+.IP \(bu 4
+Adam Kennedy <adamk@cpan.org>
+.SH "COPYRIGHT AND LICENSE"
+.IX Header "COPYRIGHT AND LICENSE"
+This software is copyright (c) 2010 by David Golden, Ricardo Signes, Adam Kennedy and Contributors.
+.PP
+This is free software; you can redistribute it and/or modify it under
+the same terms as the Perl 5 programming language system itself.