[sdk/kdesrc-build/docbook_historied_per_file] doc/kdesvn-buildrc: Be more descriptive about what is needed to get cxxflags to work in the Docbook documentation for kdesvn-build

[Michael Pyne]

Git commit 076c24f1da2f2cc4acf08fd764567c6adf0fd045 by Michael Pyne.
Committed on 28/09/2008 at 04:10.
Pushed by ashark into branch 'docbook_historied_per_file'.

Be more descriptive about what is needed to get cxxflags to work in the Docbook documentation for kdesvn-build

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

Original commit: d7b88456
https://invent.kde.org/sdk/kdesrc-build/-/commit/d7b884567084c3f7311c79eec124b769c27866ce

M  +7    -3    doc/kdesvn-buildrc/index.docbook

https://invent.kde.org/sdk/kdesrc-build/-/commit/076c24f1da2f2cc4acf08fd764567c6adf0fd045

diff --git a/doc/kdesvn-buildrc/index.docbook b/doc/kdesvn-buildrc/index.docbook
index d65af538..57192b41 100644
--- a/doc/kdesvn-buildrc/index.docbook
+++ b/doc/kdesvn-buildrc/index.docbook
@@ -215,7 +215,7 @@ for all &kde; 4 modules, since they use &cmake; to build.</para>
 <para>Since these options are passed directly to the &cmake; command line, they
 should be given as they would be typed into &cmake;. For example:</para>
 
-<screen>  cmake-options -DKDE4_BUILD_TESTS=ON
+<screen>  cmake-options -DCMAKE_BUILD_TYPE=RelWithDebInfo
 </screen>
 
 <para>Since this is a hassle, &kdesvn-build; takes pains to ensure that as long
@@ -252,12 +252,16 @@ color codes to anything but a terminal (such as xterm, &konsole;, or the normal
 <row id="conf-cxxflags">
 <entry>cxxflags</entry>
 <entry>Appends to global option</entry>
-<entry>Use this option to specify what flags to pass to <command>./configure</command> as the
+<entry><para>Use this option to specify what flags to pass to <command>./configure</command> as the
 <envar>CXXFLAGS</envar> when creating the build system for the module. This option is
 specified here instead of with <link
 linkend="conf-configure-flags">configure-flags</link> or <link
 linkend="conf-cmake-options">cmake-options</link> because this option will also
-set the environment variable <envar>CXXFLAGS</envar> during the build process.
+set the environment variable <envar>CXXFLAGS</envar> during the build process.</para>
+
+<para>Note that for &kde; 4 and any other modules that use &cmake;, it is necessary to set the
+CMAKE_BUILD_TYPE option to "none" when configuring the module.  This can be done using the
+<link linkend="conf-cmake-options">cmake-options</link> option.</para>
 </entry>
 </row>