[sdk/kdesrc-build/docbook_historied_per_file] doc: If the user is:

[Michael Pyne]

Git commit 762cabf5015e2b8487640480d6695d9507f0cab2 by Michael Pyne.
Committed on 05/07/2005 at 02:04.
Pushed by ashark into branch 'docbook_historied_per_file'.

If the user is:
1) Using svn+ssh
2) Using ssh-agent (as detected by environment)
3) Hasn't set disable-agent-check,

kdesvn-build will now make sure that the ssh agent is actually maintaining a
list of identities, and if it isn't will run ssh-add for you.  Hopefully this
will go far towards fixing the problem where if you forgot to run ssh-add that
kdesvn-build would merrily sit and wait for your to type your passphrase.

svn path=/trunk/KDE/kdesdk/doc/scripts/kdesvn-build/; revision=431712

Original commit: acb52a60
https://invent.kde.org/sdk/kdesrc-build/-/commit/acb52a60e96d862171dff3c8392100f622006089

M  +1    -1    doc/getting-started/before-building.docbook
M  +12   -0    doc/kdesvn-buildrc/index.docbook

https://invent.kde.org/sdk/kdesrc-build/-/commit/762cabf5015e2b8487640480d6695d9507f0cab2

diff --git a/doc/getting-started/before-building.docbook b/doc/getting-started/before-building.docbook
index 84b46a43..c03bc382 100644
--- a/doc/getting-started/before-building.docbook
+++ b/doc/getting-started/before-building.docbook
@@ -48,7 +48,7 @@ required for the script to run, like configuration options,
 compiling options, location of the sources, the destination of the installation
 (prefix), the modules that should be built, &etc;. The default configuration
 data is provided by the <filename>kdesvn-buildrc-sample</filename> file.
-You can find more information about the sintax of the configuration file
+You can find more information about the syntax of the configuration file
 in <xref linkend="configure-data" /> and in <xref linkend="kdesvn-buildrc" />.
 </para>
 
diff --git a/doc/kdesvn-buildrc/index.docbook b/doc/kdesvn-buildrc/index.docbook
index 47ecfa06..71922cdb 100644
--- a/doc/kdesvn-buildrc/index.docbook
+++ b/doc/kdesvn-buildrc/index.docbook
@@ -55,6 +55,7 @@ authors using the address you can find <link linkend="authors">above</link>.
 <listitem><para><link linkend="conf-configure-flags">configure-flags</link> to define what flags to configure a module with.</para></listitem>
 <listitem><para><link linkend="conf-cxxflags">cxxflags</link> to define the <envar>CXXFLAGS</envar> variable.</para></listitem>
 <listitem><para><link linkend="conf-dest-dir">dest-dir</link> to change the directory name for a module.</para></listitem>
+<listitem><para><link linkend="conf-disable-agent-check">disable-agent-check</link>, to keep kdesvn-build from checking on ssh-agent's status.</para></listitem>
 <listitem><para><link linkend="conf-do-not-compile">do-not-compile</link>, to mark directories to skip building.</para></listitem>
 <listitem><para><link linkend="conf-inst-apps">inst-apps</link>, to only build and install some directories.</para></listitem>
 <listitem><para><link linkend="conf-install-after-build">install-after-build</link>, to avoid installing after the build process.</para></listitem>
@@ -226,6 +227,17 @@ extragear-network using this option.
 </entry>
 </row>
 
+<row id="conf-disable-agent-check">
+<entry>disable-agent-check</entry>
+<entry>Can't be overridden</entry>
+<entry>Normally if you're using SSH to download the Subversion sources (such as
+if you're using the svn+ssh protocol), kdesvn-build will try and make sure that
+if you're using ssh-agent, it is actually managing some SSH identities.  This is
+to try and prevent SSH from asking for your passphrase for every module.  You can
+disable this check by setting disable-agent-check to true.
+</entry>
+</row>
+
 <row id="conf-do-not-compile">
 <entry>do-not-compile</entry>
 <entry>Overrides global</entry>