diff options
author | Ken Dreyer <kdreyer@redhat.com> | 2017-08-11 14:51:53 -0600 |
---|---|---|
committer | Guido Günther <agx@sigxcpu.org> | 2017-08-11 18:27:09 -0300 |
commit | 0ca528383899720e9f44a6c828fce6731811d033 (patch) | |
tree | 97ceb7ea9d2414190fb4b0ea911a17bc1254b77d | |
parent | 9819ae97abcbec0f967e385fa54f8ab5104b4e10 (diff) |
doc: expand --git-pbuilder-options docs
Give an example of how to use the --git-pbuilder-options option, and
explain how it interacts with git-pbuilder.
Signed-off-by: Guido Günther <agx@sigxcpu.org>
-rw-r--r-- | docs/manpages/gbp-buildpackage.sgml | 19 |
1 files changed, 18 insertions, 1 deletions
diff --git a/docs/manpages/gbp-buildpackage.sgml b/docs/manpages/gbp-buildpackage.sgml index 31faabc4..3da4573c 100644 --- a/docs/manpages/gbp-buildpackage.sgml +++ b/docs/manpages/gbp-buildpackage.sgml @@ -417,7 +417,24 @@ <para> Options to pass to pbuilder when building via &git-pbuilder; (either via <option>--git-pbuilder</option>, <option>--git-qemubuilder</option> - or the corresponding configuration file options). + or the corresponding configuration file options). It does so by + using the <envar>GIT_PBUILDER_OPTIONS</envar> environment + variable to pass options to &git-pbuilder;. + </para> + <para> + As an example, to tell pbuilder to use an alternate + .pbuilderrc file, you may run &gbp-buildpackage; with + <option>--git-pbuilder-options=<replaceable>"--configfile + /tmp/my/pbuilderrc"</replaceable></option>. See + <citerefentry> + <refentrytitle>pbuilder</refentrytitle> + <manvolnum>8</manvolnum> + </citerefentry> + for more options to pass through here. + </para> + <para> + If unset the <envar>GIT_PBUILDER_OPTIONS</envar> environment + variable will be left untouched. </para> </listitem> </varlistentry> |