Sympa::Config::Schema.3Sympa - Man Page
Definition of configuration parameters
Description
This module keeps definition of configuration parameters.
Global variable
- %alias
Deprecated by Sympa 6.2.16.
- %pgroup
TBD.
- %pinfo
This hash COMPLETELY defines ALL parameters. It is then used to load, save, view, edit config files.
A parameter definition accepts the following keywords:
- context
TBD.
Introduced on Sympa 6.2.57b.
- format
Regexp applied to the configuration file entry. Or arrayref containing all possible values of parameter.
Or, if the parameter is paragraph, value of this item is a hashref containing definitions of sub-parameters.
See also "Node types" in Sympa::List::Config.
- format_s
Template of regexp applied to the configuration file entry; see also "format".
Subpatterns
$word
indicate the name of pattern defined in Sympa::Regexps.This was introduced on Sympa 6.2.19b.2.
- file_format
Config file format of the parameter might not be the same in memory.
- split_char
Character used to separate multiple parameters. Used with the set or the array of scalars.
- length
Length of a scalar variable ; used in web forms.
- scenario
Tells that the parameter is a scenario, providing its name.
- default
Default value for the param ; may be a robot configuration parameter (conf).
If occurrence is
0-1
or0-n
, default value will be assigned only when list is created or new node is added to configuration.- default_s
Template of constant used as default value in configuration file entry; see also "default".
Subpatterns
$WORD
indicate the name of constant defined in Sympa::Constants.- synonym
Defines synonyms for parameter values (for compatibility reasons).
- gettext_unit
Unit of the parameter ; this is used in web forms and refers to translated strings in NLS catalogs.
- occurrence
Occurrence of the parameter in the config file possible values:
0-1
,1
,0-n
and1-n
. Example: A list may have multiple owner.See also "Node types" in Sympa::List::Config.
- gettext_id
Title reference in NLS catalogs.
- gettext_comment
Description text of a parameter.
- group
Group of parameters.
- obsolete
Obsolete parameter ; should not be displayed nor saved.
As of 6.2.16, if the value is true value and is not
1
, it defines reference to a fully upper-compatible new parameter.- obsolete_values
Deprecated.
Defined obsolete values for a parameter. These values should not get proposed on the web interface edition form.
- not_before, not_after
The duration between these versions (inclusive) during which the parameter is available.
Introduced on Sympa 6.2.65b.
- order
Order of parameters within paragraph.
- internal
Indicates that the parameter is an internal parameter that should always be saved in the config file.
- field_type
Used to special treatment of parameter value to show it.
- 'dayofweek'
Day of week,
0
-6
.- 'lang'
Language tag.
- 'password'
The value to be concealed.
- 'reception'
Reception mode of list member.
- 'status'
Status of list.
- 'listtopic'
List topic.
- 'unixtime'
The time in second from Unix epoch.
- 'visibility'
Visibility mode of list member.
Most of field types were introduced on Sympa 6.2.17.
- filters
See "Filters" in Sympa::List::Config.
Introduced on Sympa 6.2.17.
- validations
See "Validations" in Sympa::List::Config.
Introduced on Sympa 6.2.17.
- privilege
Dynamically assigned. Privilege for specified user:
'write'
,'read'
or'hidden'
.Introduced on Sympa 6.2.17.
- enum
Automatically assigned. TBD.
Introduced on Sympa 6.2.17.
- file
Conf file where the parameter is defined. "wwsympa.conf" is a synonym of "sympa.conf". It remains there in order to migrating older versions of config.
- db
Deprecated. 'db_first', 'file_first' or 'no'.
- importance
Importance of the parameter. The value
100
means "minimal", i.e. included in a set of parameters explicitly described in the installation instruction.0
(default) means no importance. This was introduced on 6.2.70.
- %user_info
TBD.
See Also
sympa_config(5), Sympa::List::Config, Sympa::ListOpt.
History
Sympa::ListDef was separated from List module on Sympa 6.2. On Sympa 6.2.57b, its content was moved to Sympa::Config::Schema.
confdef was separated from Conf on Sympa 6.0a, and renamed to Sympa::ConfDef on 6.2a.39. On Sympa 6.2.57b, its content was moved to Sympa::Config::Schema.
Descriptions of parameters in this source file were partially taken from chapters "sympa.conf parameters" in Sympa, Mailing List Management Software - Reference manual, written by Serge Aumont, Stefan Hornburg, Soji Ikeda, Olivier Salaün and David Verdin.