[sdk/kdesrc-build/docbook_historied_per_file] doc/kdesrc-buildrc: Allow setting http-proxy settings.

[Michael Pyne]

Git commit 808c836b4a3d051c42415f9c2c3d638259fc0a21 by Michael Pyne.
Committed on 19/08/2012 at 21:56.
Pushed by ashark into branch 'docbook_historied_per_file'.

Allow setting http-proxy settings.

Right now this will be utilized for anything needing libwww-perl
(kde_projects.xml download, tarball snapshots), and will be propagated
to subprocesses via http_proxy environment variable, unless that
variable is already set.

Tested by using a simple HTTP proxy utilizing HTTP::Proxy from CPAN.

Implements wish 305411.

BUG:305411
FIXED-IN:1.16

Original commit: da098beb
https://invent.kde.org/sdk/kdesrc-build/-/commit/da098bebfd5da903f49ead490a5e1178df5f6954

M  +18   -0    doc/kdesrc-buildrc/conf-options-table.docbook

https://invent.kde.org/sdk/kdesrc-build/-/commit/808c836b4a3d051c42415f9c2c3d638259fc0a21

diff --git a/doc/kdesrc-buildrc/conf-options-table.docbook b/doc/kdesrc-buildrc/conf-options-table.docbook
index fc64a8c8..e16dba09 100644
--- a/doc/kdesrc-buildrc/conf-options-table.docbook
+++ b/doc/kdesrc-buildrc/conf-options-table.docbook
@@ -379,6 +379,24 @@ different module sets.</para></tip>
 </entry>
 </row>
 
+<row id="conf-http-proxy">
+<entry>http-proxy</entry>
+<entry>Module setting overrides global</entry>
+
+<entry><para>This option, if set, uses the specified URL as a proxy server to use for
+any HTTP network communications (for example, when downloading snapshots for
+new modules, or the <link linkend="kde-projects-module-sets">KDE project
+database</link>).</para>
+
+<para>In addition, &kdesrc-build; will try to ensure that the tools it depends
+on also use that proxy server, if possible, by setting the
+<envar>http_proxy</envar> environment variable to the indicated server,
+<emphasis>if that environment variable is not already set</emphasis>.</para>
+
+<para>This option was introduced with &kdesrc-build; 1.16.</para>
+</entry>
+</row>
+
 <row id="conf-install-after-build">
 <entry>install-after-build</entry>
 <entry>Module setting overrides global</entry>