[sdk/kdesrc-build/docbook_historied_per_file] doc/kdesrc-buildrc: Allow using HTTP for kde-projects modules.

[Michael Pyne]

Git commit 61d2e601a8a2d587af5ae9fa8a5a326c55e7ea26 by Michael Pyne.
Committed on 19/08/2012 at 23:19.
Pushed by ashark into branch 'docbook_historied_per_file'.

Allow using HTTP for kde-projects modules.

This adds an option git-desired-protocol to allow for using HTTP instead
of git protocol when updating git modules.

For non kde-projects modules, it should already be possible to use an
http:// URL as a repository instead of git:// (though I haven't tested
this yet).

This should implement wish 305409.

BUG:305409
FIXED-IN:1.16

Original commit: 08372a53
https://invent.kde.org/sdk/kdesrc-build/-/commit/08372a530b584e86ef5757398e255a646741b37e

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

https://invent.kde.org/sdk/kdesrc-build/-/commit/61d2e601a8a2d587af5ae9fa8a5a326c55e7ea26

diff --git a/doc/kdesrc-buildrc/conf-options-table.docbook b/doc/kdesrc-buildrc/conf-options-table.docbook
index 119f113d..9e47c5c5 100644
--- a/doc/kdesrc-buildrc/conf-options-table.docbook
+++ b/doc/kdesrc-buildrc/conf-options-table.docbook
@@ -318,6 +318,34 @@ This option was removed in version 1.10
 </entry>
 </row>
 
+<row id="conf-git-desired-protocol">
+<entry>git-desired-protocol</entry>
+<entry>Cannot be overridden</entry>
+<entry><para>This option only applies to modules from a <link
+linkend="kde-projects-module-sets">&kde; project</link> repository.</para>
+
+<para>What this option actually does is configure which network protocol to
+prefer when updating source code for these modules. Normally the very-efficient
+<literal>git</literal> protocol is used, but this may be blocked in some
+networks (e.g. corporate intranets, public Wi-Fi). An alternative protocol
+which is much better supported is the <literal>HTTP</literal> protocol used for
+Internet web sites.</para>
+
+<para>If you are using one of these constrained networks you can set this
+option to <userinput>http</userinput> to prefer <literal>HTTP</literal>
+communications instead.</para>
+
+<tip><para>You may also need the <link
+linkend="conf-http-proxy">http-proxy</link> option if an HTTP proxy is also
+needed for network traffic.</para></tip>
+
+<para>In any other situation you should not set this option as the default
+protocol is most efficient.</para>
+
+<para>This option was added in &kdesrc-build; 1.16.</para>
+</entry>
+</row>
+
 <row id="conf-git-repository-base">
 <entry>git-repository-base</entry>
 <entry>Cannot be overridden</entry>