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>
