@p version first, then its ancestors nearest-first, then its
descendants nearest-first. The two directions answer two different
- questions over disjoint sets of versions, so one order serves both.
+ questions and the sets are disjoint, so there is no ambiguity.
Ancestors are what let a schema state only the keys it changes.
Descendants are what let a selected version go on working as the
*/
static vector<string> version_chain(const string &version);
-
/// Hierarchy of Innies (one per config layer)
Innie m_argv; ///< Values provided via command-line flags.
Innie m_local; ///< Values from the per-filesystem config file.
Innie m_global; ///< Values from the global config file.
- Innie m_builtin; ///< Compiled-in defaults.
+ Innie m_builtin; ///< The selected schema version; kept for its origin label.
/// Merged view used for lookup. Built once at the end of set_argv()
/// by chaining m_argv -> m_local -> m_global -> m_builtin.
Every version in version_chain() is pushed as a default, in order,
so @p target resolves the whole chain. Accepts any name in
- version_aliases().
+ version_aliases(), including release aliases such as "v0.11".
This attaches to a caller's Innie rather than returning one because
an Innie's fallback list does not survive being copied: the copy
/// Return the set of section-name suffixes immediately under @p prefix.
/// E.g. sections("scan.extent") returns {"128K", "512K", ...}.
set<string> sections(const string &prefix) const;
- /// Return the merged Innie for direct key/section access. Used by the
- /// config dump helpers below, which walk every visible section rather
- /// than looking up known keys through the typed get() template.
+ /// Return the merged Innie for direct key/section access. Used where
+ /// sections must be enumerated rather than looked up by name, which the
+ /// typed get() template cannot do.
const Innie &innie() const;
/**