db/pgbackrest
1
0
Fork 0
mirror of https://github.com/pgbackrest/pgbackrest.git synced 2025-02-13 13:59:28 +02:00
Code Issues Releases Activity

Clarify behavior of multiple configuration files.

Browse Source
This commit is contained in:
David Steele 2024-12-19 13:52:59 -05:00
parent 3210c9283f
commit 48ecbe422d
3 changed files with 21 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
doc/xml/release/2025/2.55.0.xml
View File

@ -52,4 +52,18 @@
</release-item>
</release-development-list>
</release-core-list>
<release-doc-list>
<release-improvement-list>
<release-item>
<release-item-contributor-list>
<release-item-ideator id="paul.bierly"/>
<release-item-contributor id="david.steele"/>
<release-item-reviewer id="paul.bierly"/>
</release-item-contributor-list>
<p>Clarify behavior of multiple configuration files.</p>
</release-item>
</release-improvement-list>
</release-doc-list>
</release>

5
doc/xml/release/contributor.xml
View File

@ -840,6 +840,11 @@
<contributor-id type="github">hitech73</contributor-id>
</contributor>
<contributor id="paul.bierly">
<contributor-name-display>Paul Bierly</contributor-name-display>
<contributor-id type="github">ubergoober</contributor-id>
</contributor>
<contributor id="pavel.suderevsky">
<contributor-name-display>Pavel Suderevsky</contributor-name-display>
<contributor-id type="github">psuderevsky</contributor-id>

4
doc/xml/user-guide.xml
View File

@ -1164,7 +1164,7 @@
<backrest-config-option section="global" key="log-timestamp">n</backrest-config-option>
</backrest-config>
<p><backrest/> configuration files follow the Windows INI convention. Sections are denoted by text in brackets and key/value pairs are contained in each section. Lines beginning with <id>#</id> are ignored and can be used as comments.</p>
<p><backrest/> configuration files follow a Windows INI-like convention. Sections are denoted by text in brackets and key/value pairs are contained in each section. Lines beginning with <id>#</id> are ignored and can be used as comments. Quoting is not supported and whitespace is trimmed from keys and values. Sections will be merged if they appear more than once.</p>
<p>There are multiple ways the <backrest/> configuration files can be loaded:</p>
<list>
@ -1175,7 +1175,7 @@
<list-item><br-option>config-path</br-option> is specified: this setting will override the base path for the default location of the config file and/or the base path of the default config-include-path setting unless the config and/or config-include-path option is explicitly set.</list-item>
</list>
<p>The files are concatenated as if they were one big file; order doesn't matter, but there is precedence based on sections. The precedence (highest to lowest) is:</p>
<p>Files are concatenated as if they were one big file and each file must be valid individually. This means sections must be specified in each file where they are needed to store a key/value. Order doesn't matter but there is precedence based on sections. The precedence (highest to lowest) is:</p>
<list>
<list-item>[<i>stanza</i>:<i>command</i>]</list-item>