|setting||the name of the setting it modifies, e.g. required_score. this also doubles as the default for command (below). THIS IS REQUIRED.|
|command||The command string used in the config file for this setting. Optional; setting will be used for the command if this is omitted.|
|aliases||An [aryref] of other aliases for the same command. optional.|
The type of this setting:
If this is set, and a code block does not already exist, a code block is assigned based on the type.
In addition, the SpamAssassin test suite will validate that the settings do not leak between users.
Note that $CONF_TYPE_HASH_KEY_VALUE-type settings require that the value be non-empty, otherwise theyll produce a warning message.
A subroutine to deal with the setting. ONE OF <B>codeB> OR <B>typeB> IS REQUIRED.
The arguments passed to the function are ($self, $key, $value, $line),
where $key is the setting (*not* the command), $value is the value string,
and $line is the entire line.
$Mail::SpamAssassin::Conf::MISSING_REQUIRED_VALUE this setting requires that a value be set, but one was not provided.
$Mail::SpamAssassin::Conf::INVALID_VALUE this setting requires a value from a set of valid values, but the user provided an invalid one.
$Mail::SpamAssassin::Conf::INVALID_HEADER_FIELD_NAME this setting requires a syntactically valid header field name, but the user provided an invalid one.
Any other values including undef returned from the subroutine are considered to mean success.
It is good practice to set a type, if possible, describing how your settings are stored on the Conf object; this allows the SpamAssassin test suite to validate that the settings do not leak between users.
|default||The default value for the setting. may be omitted if the default value is a non-scalar type, which should be set in the Conf ctor. note for path types: using __userstate__ is recommended for defaults, as it allows Mail::SpamAssassin module users who set that configuration setting, to receive the correct values.|
|is_priv||Set to 1 if this setting requires allow_user_rules when run from spamd.|
|is_admin||Set to 1 if this setting can only be set in the system-wide config when run from spamd. (All settings can be used by local programs run directly by the user.)|
|is_frequent||Set to 1 if this value occurs frequently in the config. this means its looked up first for speed.|
|perl v5.20.3||MAIL::SPAMASSASSIN::CONF::PARSER (3)||2015-04-28|