Adding upstream version 4.22.0.upstream/4.22.0

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

1 files changed, 341 insertions, 0 deletions

diff --git a/upstream/mageia-cauldron/man3pm/ExtUtils::Manifest.3pm b/upstream/mageia-cauldron/man3pm/ExtUtils::Manifest.3pm
new file mode 100644
index 00000000..e5a1e197
--- /dev/null
+++ b/upstream/mageia-cauldron/man3pm/ExtUtils::Manifest.3pm
@@ -0,0 +1,341 @@
+.\" -*- 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 "ExtUtils::Manifest 3pm"
+.TH ExtUtils::Manifest 3pm 2023-11-28 "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
+ExtUtils::Manifest \- Utilities to write and check a MANIFEST file
+.SH VERSION
+.IX Header "VERSION"
+version 1.73
+.SH SYNOPSIS
+.IX Header "SYNOPSIS"
+.Vb 1
+\&    use ExtUtils::Manifest qw(...funcs to import...);
+\&
+\&    mkmanifest();
+\&
+\&    my @missing_files    = manicheck;
+\&    my @skipped          = skipcheck;
+\&    my @extra_files      = filecheck;
+\&    my($missing, $extra) = fullcheck;
+\&
+\&    my $found    = manifind();
+\&
+\&    my $manifest = maniread();
+\&
+\&    manicopy($read,$target);
+\&
+\&    maniadd({$file => $comment, ...});
+.Ve
+.SH DESCRIPTION
+.IX Header "DESCRIPTION"
+\&...
+.SH FUNCTIONS
+.IX Header "FUNCTIONS"
+ExtUtils::Manifest exports no functions by default.  The following are
+exported on request:
+.SS mkmanifest
+.IX Subsection "mkmanifest"
+.Vb 1
+\&    mkmanifest();
+.Ve
+.PP
+Writes all files in and below the current directory to your \fIMANIFEST\fR.
+It works similar to the result of the Unix command
+.PP
+.Vb 1
+\&    find . > MANIFEST
+.Ve
+.PP
+All files that match any regular expression in a file \fIMANIFEST.SKIP\fR
+(if it exists) are ignored.
+.PP
+Any existing \fIMANIFEST\fR file will be saved as \fIMANIFEST.bak\fR.
+.SS manifind
+.IX Subsection "manifind"
+.Vb 1
+\&    my $found = manifind();
+.Ve
+.PP
+returns a hash reference. The keys of the hash are the files found
+below the current directory.
+.SS manicheck
+.IX Subsection "manicheck"
+.Vb 1
+\&    my @missing_files = manicheck();
+.Ve
+.PP
+checks if all the files within a \f(CW\*(C`MANIFEST\*(C'\fR in the current directory
+really do exist. If \f(CW\*(C`MANIFEST\*(C'\fR and the tree below the current
+directory are in sync it silently returns an empty list.
+Otherwise it returns a list of files which are listed in the
+\&\f(CW\*(C`MANIFEST\*(C'\fR but missing from the directory, and by default also
+outputs these names to STDERR.
+.SS filecheck
+.IX Subsection "filecheck"
+.Vb 1
+\&    my @extra_files = filecheck();
+.Ve
+.PP
+finds files below the current directory that are not mentioned in the
+\&\f(CW\*(C`MANIFEST\*(C'\fR file. An optional file \f(CW\*(C`MANIFEST.SKIP\*(C'\fR will be
+consulted. Any file matching a regular expression in such a file will
+not be reported as missing in the \f(CW\*(C`MANIFEST\*(C'\fR file. The list of any
+extraneous files found is returned, and by default also reported to
+STDERR.
+.SS fullcheck
+.IX Subsection "fullcheck"
+.Vb 1
+\&    my($missing, $extra) = fullcheck();
+.Ve
+.PP
+does both a \fBmanicheck()\fR and a \fBfilecheck()\fR, returning then as two array
+refs.
+.SS skipcheck
+.IX Subsection "skipcheck"
+.Vb 1
+\&    my @skipped = skipcheck();
+.Ve
+.PP
+lists all the files that are skipped due to your \f(CW\*(C`MANIFEST.SKIP\*(C'\fR
+file.
+.SS maniread
+.IX Subsection "maniread"
+.Vb 2
+\&    my $manifest = maniread();
+\&    my $manifest = maniread($manifest_file);
+.Ve
+.PP
+reads a named \f(CW\*(C`MANIFEST\*(C'\fR file (defaults to \f(CW\*(C`MANIFEST\*(C'\fR in the current
+directory) and returns a HASH reference with files being the keys and
+comments being the values of the HASH.  Blank lines and lines which
+start with \f(CW\*(C`#\*(C'\fR in the \f(CW\*(C`MANIFEST\*(C'\fR file are discarded.
+.SS maniskip
+.IX Subsection "maniskip"
+.Vb 2
+\&    my $skipchk = maniskip();
+\&    my $skipchk = maniskip($manifest_skip_file);
+\&
+\&    if ($skipchk\->($file)) { .. }
+.Ve
+.PP
+reads a named \f(CW\*(C`MANIFEST.SKIP\*(C'\fR file (defaults to \f(CW\*(C`MANIFEST.SKIP\*(C'\fR in
+the current directory) and returns a CODE reference that tests whether
+a given filename should be skipped.
+.SS manicopy
+.IX Subsection "manicopy"
+.Vb 2
+\&    manicopy(\e%src, $dest_dir);
+\&    manicopy(\e%src, $dest_dir, $how);
+.Ve
+.PP
+Copies the files that are the keys in \f(CW%src\fR to the \f(CW$dest_dir\fR.  \f(CW%src\fR is
+typically returned by the \fBmaniread()\fR function.
+.PP
+.Vb 1
+\&    manicopy( maniread(), $dest_dir );
+.Ve
+.PP
+This function is useful for producing a directory tree identical to the
+intended distribution tree.
+.PP
+\&\f(CW$how\fR can be used to specify a different methods of "copying".  Valid
+values are \f(CW\*(C`cp\*(C'\fR, which actually copies the files, \f(CW\*(C`ln\*(C'\fR which creates
+hard links, and \f(CW\*(C`best\*(C'\fR which mostly links the files but copies any
+symbolic link to make a tree without any symbolic link.  \f(CW\*(C`cp\*(C'\fR is the
+default.
+.SS maniadd
+.IX Subsection "maniadd"
+.Vb 1
+\&  maniadd({ $file => $comment, ...});
+.Ve
+.PP
+Adds an entry to an existing \fIMANIFEST\fR unless its already there.
+.PP
+\&\f(CW$file\fR will be normalized (ie. Unixified).  \fBUNIMPLEMENTED\fR
+.SS MANIFEST
+.IX Subsection "MANIFEST"
+A list of files in the distribution, one file per line.  The MANIFEST
+always uses Unix filepath conventions even if you're not on Unix.  This
+means \fIfoo/bar\fR style not \fIfoo\ebar\fR.
+.PP
+Anything between white space and an end of line within a \f(CW\*(C`MANIFEST\*(C'\fR
+file is considered to be a comment.  Any line beginning with # is also
+a comment. Beginning with ExtUtils::Manifest 1.52, a filename may
+contain whitespace characters if it is enclosed in single quotes; single
+quotes or backslashes in that filename must be backslash-escaped.
+.PP
+.Vb 4
+\&    # this a comment
+\&    some/file
+\&    some/other/file            comment about some/file
+\&    \*(Aqsome/third file\*(Aq          comment
+.Ve
+.SS MANIFEST.SKIP
+.IX Subsection "MANIFEST.SKIP"
+The file MANIFEST.SKIP may contain regular expressions of files that
+should be ignored by \fBmkmanifest()\fR and \fBfilecheck()\fR. The regular
+expressions should appear one on each line. Blank lines and lines
+which start with \f(CW\*(C`#\*(C'\fR are skipped.  Use \f(CW\*(C`\e#\*(C'\fR if you need a regular
+expression to start with a \f(CW\*(C`#\*(C'\fR.
+.PP
+For example:
+.PP
+.Vb 5
+\&    # Version control files and dirs.
+\&    \ebRCS\eb
+\&    \ebCVS\eb
+\&    ,v$
+\&    \eB\e.svn\eb
+\&
+\&    # Makemaker generated files and dirs.
+\&    ^MANIFEST\e.
+\&    ^Makefile$
+\&    ^blib/
+\&    ^MakeMaker\-\ed
+\&
+\&    # Temp, old and emacs backup files.
+\&    ~$
+\&    \e.old$
+\&    ^#.*#$
+\&    ^\e.#
+.Ve
+.PP
+If no MANIFEST.SKIP file is found, a default set of skips will be
+used, similar to the example above.  If you want nothing skipped,
+simply make an empty MANIFEST.SKIP file.
+.PP
+In one's own MANIFEST.SKIP file, certain directives
+can be used to include the contents of other MANIFEST.SKIP
+files. At present two such directives are recognized.
+.IP #!include_default 4
+.IX Item "#!include_default"
+This inserts the contents of the default MANIFEST.SKIP file
+.IP "#!include /Path/to/another/manifest.skip" 4
+.IX Item "#!include /Path/to/another/manifest.skip"
+This inserts the contents of the specified external file
+.PP
+The included contents will be inserted into the MANIFEST.SKIP
+file in between \fI#!start included /path/to/manifest.skip\fR
+and \fI#!end included /path/to/manifest.skip\fR markers.
+The original MANIFEST.SKIP is saved as MANIFEST.SKIP.bak.
+.SS EXPORT_OK
+.IX Subsection "EXPORT_OK"
+\&\f(CW&mkmanifest\fR, \f(CW&manicheck\fR, \f(CW&filecheck\fR, \f(CW&fullcheck\fR,
+\&\f(CW&maniread\fR, and \f(CW&manicopy\fR are exportable.
+.SS "GLOBAL VARIABLES"
+.IX Subsection "GLOBAL VARIABLES"
+\&\f(CW$ExtUtils::Manifest::MANIFEST\fR defaults to \f(CW\*(C`MANIFEST\*(C'\fR. Changing it
+results in both a different \f(CW\*(C`MANIFEST\*(C'\fR and a different
+\&\f(CW\*(C`MANIFEST.SKIP\*(C'\fR file. This is useful if you want to maintain
+different distributions for different audiences (say a user version
+and a developer version including RCS).
+.PP
+\&\f(CW$ExtUtils::Manifest::Quiet\fR defaults to 0. If set to a true value,
+all functions act silently.
+.PP
+\&\f(CW$ExtUtils::Manifest::Debug\fR defaults to 0.  If set to a true value,
+or if PERL_MM_MANIFEST_DEBUG is true, debugging output will be
+produced.
+.SH DIAGNOSTICS
+.IX Header "DIAGNOSTICS"
+All diagnostic output is sent to \f(CW\*(C`STDERR\*(C'\fR.
+.ie n .IP """Not in MANIFEST:"" \fIfile\fR" 4
+.el .IP "\f(CWNot in MANIFEST:\fR \fIfile\fR" 4
+.IX Item "Not in MANIFEST: file"
+is reported if a file is found which is not in \f(CW\*(C`MANIFEST\*(C'\fR.
+.ie n .IP """Skipping"" \fIfile\fR" 4
+.el .IP "\f(CWSkipping\fR \fIfile\fR" 4
+.IX Item "Skipping file"
+is reported if a file is skipped due to an entry in \f(CW\*(C`MANIFEST.SKIP\*(C'\fR.
+.ie n .IP """No such file:"" \fIfile\fR" 4
+.el .IP "\f(CWNo such file:\fR \fIfile\fR" 4
+.IX Item "No such file: file"
+is reported if a file mentioned in a \f(CW\*(C`MANIFEST\*(C'\fR file does not
+exist.
+.ie n .IP """MANIFEST:"" \fI$!\fR" 4
+.el .IP "\f(CWMANIFEST:\fR \fI$!\fR" 4
+.IX Item "MANIFEST: $!"
+is reported if \f(CW\*(C`MANIFEST\*(C'\fR could not be opened.
+.ie n .IP """Added to MANIFEST:"" \fIfile\fR" 4
+.el .IP "\f(CWAdded to MANIFEST:\fR \fIfile\fR" 4
+.IX Item "Added to MANIFEST: file"
+is reported by \fBmkmanifest()\fR if \f(CW$Verbose\fR is set and a file is added
+to MANIFEST. \f(CW$Verbose\fR is set to 1 by default.
+.SH ENVIRONMENT
+.IX Header "ENVIRONMENT"
+.IP \fBPERL_MM_MANIFEST_DEBUG\fR 4
+.IX Item "PERL_MM_MANIFEST_DEBUG"
+Turns on debugging
+.SH "SEE ALSO"
+.IX Header "SEE ALSO"
+ExtUtils::MakeMaker which has handy targets for most of the functionality.
+.SH AUTHOR
+.IX Header "AUTHOR"
+Andreas Koenig \f(CW\*(C`andreas.koenig@anima.de\*(C'\fR
+.PP
+Currently maintained by the Perl Toolchain Gang.
+.SH "COPYRIGHT AND LICENSE"
+.IX Header "COPYRIGHT AND LICENSE"
+This software is copyright (c) 1996\- by Andreas Koenig.
+.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.