.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.48)
.\"
.\" 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
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "Config::MVP::Section 3"
.TH Config::MVP::Section 3 2026-10-25 "perl v5.44.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH DESCRIPTION
.IX Header "DESCRIPTION"
For the most part, you can just consult Config::MVP to understand what this
class is and how it\*(Aqs used.
.PP
This is the section\*(Aqs name.  It\*(Aqs a string, and it must be provided.
.PP
This is the (Perl) package with which the section is associated.  It is
optional.  When the section is instantiated, it will ensure that this package
is loaded.
.PP
This attribute is an arrayref of value names that should be considered
multivalue properties in the section.  When added to the section, they will
always be wrapped in an arrayref, and they may be added to the section more
than once.
.PP
If this attribute is not given during construction, it will default to the
result of calling section\*(Aqs package\*(Aqs \f(CW\*(C`mvp_multivalue_args\*(C'\fR method.  If the
section has no associated package or if the package doesn\*(Aqt provide that
method, it default to an empty arrayref.
.PP
This attribute is a hashref of name remappings.  For example, if it contains
this hashref:
.PP
.Vb 4
\&  {
\&    file => \*(Aqfiles\*(Aq,
\&    path => \*(Aqfiles\*(Aq,
\&  }
.Ve
.PP
Then attempting to set either the "file" or "path" setting for the section
would actually set the "files" setting.
.PP
If this attribute is not given during construction, it will default to the
result of calling section\*(Aqs package\*(Aqs \f(CW\*(C`mvp_aliases\*(C'\fR method.  If the
section has no associated package or if the package doesn\*(Aqt provide that
method, it default to an empty hashref.
.PP
This is the storage into which properties are set.  It is a hashref of names
and values.  You should probably not alter the contents of the payload, and
should read its contents only.
.PP
This attribute is true if the section has been marked finalized, which will
prevent any new values from being added to it.  It can be set with the
\&\f(CW\*(C`finalize\*(C'\fR method.
.PP
This attributes points to the sequence into which the section has been
assembled.  It may be unset if the section has been created but not yet placed
in a sequence.
.PP
.Vb 1
\&  $section\->add_value( $name => $value );
.Ve
.PP
This method sets the value for the named property to the given value.  If the
property is a multivalue property, the new value will be pushed onto the end of
an arrayref that will store all values for that property.
.PP
Attempting to add a value for a non\-multivalue property whose value was already
added will result in an exception.
.PP
.Vb 1
\&  $section\->load_package($package, $section_name);
.Ve
.PP
This method is used to ensure that the given \f(CW$package\fR is loaded, and is
called whenever a section with a package is created.  By default, it delegates
to Class::Load.  If the package can\*(Aqt be found, it calls the
missing_package method.  Errors in compilation are not suppressed.
.PP
.Vb 1
\&  $section\->missing_package($package, $section_name);
.Ve
.PP
This method is called when \f(CW\*(C`load_package\*(C'\fR encounters a package that is not
installed.  By default, it throws an exception.
.SH "POD ERRORS"
.IX Header "POD ERRORS"
Hey! \fBThe above document had some coding errors, which are explained below:\fR
.IP "Around line 15:" 4
.IX Item "Around line 15:"
Unknown directive: =attr
.IP "Around line 27:" 4
.IX Item "Around line 27:"
Unknown directive: =attr
.IP "Around line 42:" 4
.IX Item "Around line 42:"
Unknown directive: =attr
.IP "Around line 70:" 4
.IX Item "Around line 70:"
Unknown directive: =attr
.IP "Around line 103:" 4
.IX Item "Around line 103:"
Unknown directive: =attr
.IP "Around line 118:" 4
.IX Item "Around line 118:"
Unknown directive: =attr
.IP "Around line 142:" 4
.IX Item "Around line 142:"
Unknown directive: =attr
.IP "Around line 180:" 4
.IX Item "Around line 180:"
Unknown directive: =method
.IP "Around line 218:" 4
.IX Item "Around line 218:"
Unknown directive: =method
.IP "Around line 236:" 4
.IX Item "Around line 236:"
Unknown directive: =method