diff options
author | Guido Günther <agx@sigxcpu.org> | 2016-07-04 11:33:25 +0200 |
---|---|---|
committer | Guido Günther <agx@sigxcpu.org> | 2016-07-04 14:09:50 +0200 |
commit | 870c901710cc07f3cdb4ca15dbd5eee660e26ca7 (patch) | |
tree | 4c9f8d2506b295c94749ab84c0536c27bf900a01 /docs | |
parent | 2bc3801a5f4ffacce4d8b34cdf2e22f6291401e2 (diff) |
Docs: Clarify on possible key names and priorities in gbp.conf
Diffstat (limited to 'docs')
-rw-r--r-- | docs/manpages/gbp.conf.sgml | 21 |
1 files changed, 14 insertions, 7 deletions
diff --git a/docs/manpages/gbp.conf.sgml b/docs/manpages/gbp.conf.sgml index 369979d1..322340d7 100644 --- a/docs/manpages/gbp.conf.sgml +++ b/docs/manpages/gbp.conf.sgml @@ -56,15 +56,17 @@ zero or one sections for each &gbp; command. Additionally, there can be an arbitrary number of <option>remote-config</option> sections. Comments start with a - hash sign (<option>#</option>). The syntax is: + hash sign (<option>#</option>). The overall layout is: </para> <programlisting> [DEFAULT] - # This section is for global settings. Affects all commands + # This section is for global settings. Affects all commands. + # Options set here have the lowest priority. key = value [<command>] # Specific sections for each command, like <command>buildpackage</command> + # Options set here have lower priority than command line options key = value [remote-config <name>] @@ -81,15 +83,20 @@ </para> <para> - The <option>key=value</option> pairs of the command sections are - named like the command-line options of the corresponding command - with the '--' stripped off and can hold the same values (but see - below for details). For example, + The keys in the + <option>key</option>=<parameter>value</parameter> pairs are named + like the command-line options of the corresponding command (with the + '--' stripped off) and can hold the same values, but see below for + details. In case of &gbp-buildpackage; and &gbp-buildpackage-rpm; + the key needs '--git-' instead of '--' stripped off. +</para> +<para> + For example, the <xref linkend="man.gbp.buildpackage"/> manual page documents the <option>--git-export-dir</option>=<parameter>directory</parameter> option which can be turned into configuration file setting by dropping the - <option>--git</option> prefix: + <option>--git-</option> prefix: </para> <programlisting> |