[sdk/kdesrc-build/docbook_historied_per_file] doc: Update kdesvn-build documentation to account for option changes

Michael Pyne null at kde.org
Fri May 10 10:14:26 BST 2024


Git commit 9d4aab1b90af37d371bf79bd45f74f96ff067e62 by Michael Pyne.
Committed on 09/08/2008 at 23:04.
Pushed by ashark into branch 'docbook_historied_per_file'.

Update kdesvn-build documentation to account for option changes

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

Original commit: 8611c4ad
https://invent.kde.org/sdk/kdesrc-build/-/commit/8611c4ada08b1686fc40141841ec089540bed797

M  +0    -6    doc/features/features-overview.docbook
M  +2    -2    doc/index.docbook
M  +6    -9    doc/kde-cmake/kde-cmake-intro.docbook
M  +15   -20   doc/kdesvn-buildrc/index.docbook
M  +0    -48   doc/using-kdesvn-build/developer-features.docbook

https://invent.kde.org/sdk/kdesrc-build/-/commit/9d4aab1b90af37d371bf79bd45f74f96ff067e62

diff --git a/doc/features/features-overview.docbook b/doc/features/features-overview.docbook
index 51245bf7..0c090070 100644
--- a/doc/features/features-overview.docbook
+++ b/doc/features/features-overview.docbook
@@ -7,12 +7,6 @@
 
 <itemizedlist>
 
-<listitem><para>
-For developers: Supports <link linkend="building-apidox">building the API
-documentation</link> for a module. Note that this only works for &kde; 3
-modules when not using the &unsermake; script.
-</para></listitem>
-
 <listitem><para>
 Supports <link linkend="changing-verbosity">output message levels</link>
 ranging from being very quiet to a full debug level.
diff --git a/doc/index.docbook b/doc/index.docbook
index 6fde3060..2d4a889a 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -112,8 +112,8 @@
 
 <legalnotice>&FDLNotice;</legalnotice>
 
-<date>2008-01-14</date>
-<releaseinfo>1.6</releaseinfo>
+<date>2008-08-09</date>
+<releaseinfo>1.6.3</releaseinfo>
 
 <abstract>
 <para>&kdesvn-build; is a script which builds and installs &kde; directly from the sources found in the &kde; &subversion; repository.</para>
diff --git a/doc/kde-cmake/kde-cmake-intro.docbook b/doc/kde-cmake/kde-cmake-intro.docbook
index e2c0680b..9056daa3 100644
--- a/doc/kde-cmake/kde-cmake-intro.docbook
+++ b/doc/kde-cmake/kde-cmake-intro.docbook
@@ -6,28 +6,25 @@ beat out several competitors and was selected to be the build system for &kde; 4
 autotools-based system that &kde; has used from the beginning.</para>
 
 <para>A introduction to &cmake; page is available on the <ulink
-url="http://wiki.kde.org/tiki-index.php?page=KDECMakeIntro">&kde; Wiki</ulink>.
+url="http://techbase.kde.org/Development/Tutorials/CMake">&kde; TechBase</ulink>.
 Basically, instead of running <userinput><command>make</command> <option>-f</option> 
 <filename>Makefile.cvs</filename></userinput>, then <command>configure</command>,
 then &unsermake; (or &make;), we simply run &cmake; and then &make;.
 </para>
 
-<para>&kdesvn-build; has initial support for &cmake;. A few features of &kdesvn-build;
+<para>&kdesvn-build; has support for &cmake;. A few features of &kdesvn-build;
 were really features of the underlying buildsystem, including <link linkend="conf-inst-apps">inst-apps</link>,
 <link linkend="conf-configure-flags">configure-flags</link>, 
 and <link linkend="conf-do-not-compile">do-not-compile</link>. When equivalent
 features are available, they are provided. For instance, the equivalent to the
-configure-flags option is <link linkend="conf-cmake-options">cmake-options</link>.
+configure-flags option is <link linkend="conf-cmake-options">cmake-options</link>, and the
+<link linkend="conf-do-not-compile">do-not-compile</link> option is also supported for &cmake;
+as of &kdesvn-build; version 1.6.3.
 </para>
 
-<para>However, some options, like inst-apps or do-not-compile, have no direct
+<para>However, some options (like <link linkend="conf-inst-apps">inst-apps</link>) have no direct
 equivalent, and are disabled. Should I find a way to implement them with &cmake;
 I will do so and re-enable the option. However, more or less everything works
 the same.</para>
 
-<para>Not all of &kde; has been ported to use &cmake; at this point. For example,
-the <link linkend="conf-apidox">apidox</link> option is rather useless until the
-equivalent infrastructure is ready. I have tried to warn about such things but
-not all deficiencies may be caught by &kdesvn-build; for now.</para>
-
 </sect1>
diff --git a/doc/kdesvn-buildrc/index.docbook b/doc/kdesvn-buildrc/index.docbook
index 83e3f66e..1b33e318 100644
--- a/doc/kdesvn-buildrc/index.docbook
+++ b/doc/kdesvn-buildrc/index.docbook
@@ -43,7 +43,6 @@ authors using the address you can find <link linkend="authors">above</link>.
 </para>
 
 <itemizedlist>
-<listitem><para><link linkend="conf-apidox">apidox</link>, to build API Documentation.</para></listitem>
 <listitem><para><link linkend="conf-apply-qt-patches">apply-qt-patches</link>, to enhance qt-copy.</para></listitem>
 <listitem><para><link linkend="conf-async">async</link>, to update and build at the same time.</para></listitem>
 <listitem><para><link linkend="conf-binpath">binpath</link>, to set the <envar>PATH</envar> variable.</para></listitem>
@@ -101,17 +100,13 @@ as well.
 <row id="conf-apidox">
 <entry>apidox</entry>
 <entry>Overrides global</entry>
-<entry><para>
-Set this option to <replaceable>true</replaceable> in order to have &kdesvn-build; automatically
-build and install the API documentation for the module after the normal build/install
-process. This only works for modules where <command>make apidox</command> does something,
-including kdelibs, kdebase and koffice, among others.
-</para>
-<para>This option does not work for modules using &unsermake; support, due to
-deficiencies in the &unsermake; build system. This option does not work for
-&kde; 4 modules because the required build system support has been migrated to
-a different program which &kdesvn-build; has not been corrected to use yet.
-</para>
+<entry><para>This option was used to allow for building KDE module API documentation.
+It was removed in &kdesvn-build; 1.6.3 due to it not being supported in KDE 4.  Online
+API documentation is available from <ulink url="http://api.kde.org/">kde.org</ulink>.
+In addition it is possible to build KDE 4's API documentation using a script included in
+the kdesdk module (/scripts directory).  See <ulink url="http://techbase.kde.org/Development/Tools/apidox">KDE
+TechBase</ulink> for more details.  It is still possible to manually build API documentation
+for older modules of course.</para>
 </entry>
 </row>
 
@@ -220,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 -DRPATH_STYLE=default
+<screen>  cmake-options -DKDE4_BUILD_TESTS=ON
 </screen>
 
 <para>Since this is a hassle, &kdesvn-build; takes pains to ensure that as long
@@ -293,18 +288,18 @@ disable this check by setting <option>disable-agent-check</option> to <replaceab
 <row id="conf-do-not-compile">
 <entry>do-not-compile</entry>
 <entry>Overrides global</entry>
-<entry><para>Use this option to set the <envar>DO_NOT_COMPILE</envar> environment variable prior to
-running the configure script. According to the <ulink
-url="http://developer.kde.org/documentation/other/developer-faq.html">&kde;
-Developer FAQ</ulink>, this should cause any top-level directory you pass to not be
-built. The directories should be space-separated.</para>
+<entry><para>Use this option to select a specific set of directories to be built in a
+module (instead of all of them).  The directories to build should be space-separated.</para>
+
+<para>This feature is supported for both &kde; 3 and &kde; 4.  KDE 4 support was added in
+&kdesvn-build; 1.6.3.</para>
 
 <para>Note that the sources to the programs will still be downloaded. You can use
 the <link linkend="conf-checkout-only">checkout-only</link>
 directive to choose directories that you want to check out.</para>
 
-<important><para>This option does not yet work with modules built using
-&cmake;.</para></important>
+<para>For example, to hold &juk; and &kscd; in the kdemultimedia module from
+compiling, you would add "do-not-compile juk kscd" to your kdemultimedia settings.</para>
 </entry>
 </row>
 
diff --git a/doc/using-kdesvn-build/developer-features.docbook b/doc/using-kdesvn-build/developer-features.docbook
index 88bf9107..ac4c5e4f 100644
--- a/doc/using-kdesvn-build/developer-features.docbook
+++ b/doc/using-kdesvn-build/developer-features.docbook
@@ -1,54 +1,6 @@
 <sect1 id="developer-features">
 <title>Features for &kde; developers</title>
 
-<sect2 id="building-apidox">
-<title>Building API Documentation</title>
-<para>&kdesvn-build; can automatically install additional documentation
-generated from the sources in a module. This only works on some modules,
-and is only useful for &kde; developers.</para>
-
-<important>
-<para>This feature does not work for modules built using the <link linkend="using-unsermake">&unsermake;</link>
-build system. Since this is the default build system for modules that can
-use &unsermake;, you would need to disable &unsermake; support. See <link
-linkend="example-apidox">example below</link> for more information.
-</para>
-</important>
-
-<para>To enable this, simply set the &apidox; option to <replaceable>true</replaceable> in the <link linkend="configure-data">configuration file</link>,
-for the module that you would like documentation for. Not all modules have
-documentation. Modules that do include kdelibs, kdebase and kdepim.
-</para>
-
-<note>
-<para>If you have access to the Internet, the API documentation for &kde; is
-also available online. In &konqueror;, you can use the shortcut <quote>kde:<replaceable>className</replaceable></quote>.
-</para>
-
-<para>You can also visit the &kde; documentation web site at <ulink
-url="http://www.englishbreakfastnetwork.org/apidocs/">English Breakfast Network</ulink>.
-</para>
-
-<para>Finally, it is possible to download the documentation in an archived
-form, from <ulink url="http://developer.kde.org/documentation/library/libraryref.php">The &kde; Developer's Corner</ulink>.
-Click on the &kde; version you want documented, and then you can download
-an offline copy for the module you want.
-</para>
-</note>
-
-<informalexample id="example-apidox">
-<para>Installing API Documentation for kdelibs:</para>
-
-<screen>
-module kdelibs
-  use-unsermake false    # unsermake cannot build apidox
-  apidox        true     # build and install apidox
-end module
-</screen>
-</informalexample>
-
-</sect2>
-
 <sect2 id="ssh-agent-reminder">
 <title>&ssh; Agent checks</title>
 <para>&kdesvn-build; can ensure that &kde; developers that use &ssh; to



More information about the kde-doc-english mailing list