comparison docs/introduction.rst @ 682:7c41a52253bf

Docs
author Franz Glasner <fzglas.hg@dom66.de>
date Sat, 10 Jun 2023 04:08:40 +0200
parents 8647eb175bb9
children 3062b63325c4
comparison
equal deleted inserted replaced
681:6a55cbc836f1 682:7c41a52253bf
354 2. The namespace ``ref`` to be used for configuration references. 354 2. The namespace ``ref`` to be used for configuration references.
355 355
356 This is a namespace that is handled special within "ConfigMix". 356 This is a namespace that is handled special within "ConfigMix".
357 357
358 Must be Filters are **not** supported. 358 Must be Filters are **not** supported.
359
360 Think of them as symbolic links.
359 361
360 3. The namespace ``OS`` 362 3. The namespace ``OS``
361 363
362 Available functions: 364 Available functions:
363 365
636 assert value == jvalue2 == "get this as `tree1.tree2.key4'" 638 assert value == jvalue2 == "get this as `tree1.tree2.key4'"
637 639
638 .. note:: A jailed configuration holds a strong reference to the unjailed 640 .. note:: A jailed configuration holds a strong reference to the unjailed
639 base configuration. 641 base configuration.
640 642
643 .. note:: If a jail's root path points to a location with a variable
644 substitutions the jail does not work: it is not possible to
645 expand the substitution.
646
647 Using ``ref`` namespaces instead works: think of
648 symbolic links.
649
641 650
642 Custom filename extensions and custom loaders 651 Custom filename extensions and custom loaders
643 --------------------------------------------- 652 ---------------------------------------------
644 653
645 If you want to have custom configuration file extensions and/or custom loaders 654 If you want to have custom configuration file extensions and/or custom loaders