Config...nclude(3pm)

✨ Config::Model::Value::LayeredInclude — the manual page, bestie edition ✨

okay so this is Config...nclude(3pm) from the User Contributed Perl Documentation, and it's literally about including a sub layer configuration, and honestly? it's giving niche but iconic 💅 let's get into it

---

💖 NAME 💖

Config::Model::Value::LayeredInclude — include a sub layer configuration 🫶

🌸 VERSION 🌸

version 2.166 ✨ (yes ma'am, we're on 2.166)

🎀 SYNOPSIS 🎀

okay so here's how you show up in a model declaration, no cap:

# 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 🦋

So this class inherits from Config::Model::Value — like, it's the child of that class, it carries the family name 💖 — and what it does is it overrides _store so that when a value gets changed, it triggers a refresh of the layered value. Translation: changing this value triggers a reload of the referred configuration file, and the values from that file are used as the default value. bestie that's the whole vibe.

This class was designed to cope with late multistrap configuration. periodt.

⚠️ CAUTION ⚠️ (read this fr fr)

A configuration file can support 2 kinds of include, and you need to know which one you're in:

• Layered include — this one sets default values, like the default values for ssh configuration. These includes are read-only 🚫
• Real includes — like "apache". In these cases, modified configuration items can be written to the included files.

🚨 and here's the tea: this class works only with the first type. Only layered includes. If you're out here expecting real includes from this class, you're gonna have a bad time 😭

---

👑 AUTHOR 👑

Dominique Dumont 💜 (iconic behavior, honestly)

📜 COPYRIGHT AND LICENSE 📜

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

This is free software, licensed under:

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

---

and that's the whole page, bestie 🎀 this was Config...nclude(3pm) as shipped with perl v5.42.3, dated 2026-07-23 — thanks for reading, mwah 💋✨🦋