Config::Model::Value::LayeredInclude (3)

Leading comments

Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/Config::Model::Value::LayeredInclude.3pm".)

NAME

Config::Model::Value::LayeredInclude - Include a sub layer configuration

VERSION

version 2.106

SYNOPSIS

    # in a model declaration:
    'element' => [
      'include' => {
        'class' => 'Config::Model::Value::LayeredInclude',

        # usual Config::Model::Value parameters
        'type' => 'leaf',
        'value_type' => 'uniline',
        'convert' => 'lc',
        'summary' => 'Include file for cascaded configuration',
        'description' => 'To support multiple variants of ...'
      },
    ]

DESCRIPTION

This class inherits from Config::Model::Value. It overrides _store to trigger a refresh of layered value when a value is changed. I.e. changing this value trigger a reload of the referred configuration file which values are used as default value. This class was designed to cope with multistrap <wiki.debian.org/Multistrap> configuration.

CAUTION

A configuration file can support 2 kinds of include:

*

Layered include which sets default values like multistrap or ssh. These includes are read-only.

*

Real includes like "apache". In this cases modified configuration items can be written to included files.

This class works only with the first type

AUTHOR

Copyright 2011,2013 Dominique Dumont <ddumont at cpan.org>

AUTHOR

Dominique Dumont

COPYRIGHT AND LICENSE

This software is Copyright (c) 2005-2017 by Dominique Dumont.

This is free software, licensed under:

  The GNU Lesser General Public License, Version 2.1, February 1999