[sdk/kdesrc-build/docbook_historied_per_file] doc: Fix XML.

[Yuri Chornoivan]

Git commit e2adb1cf92db77282b053a6dc9f586129a82cd78 by Yuri Chornoivan.
Committed on 27/05/2012 at 17:50.
Pushed by ashark into branch 'docbook_historied_per_file'.

Fix XML.

Original commit: 496b5cea
https://invent.kde.org/sdk/kdesrc-build/-/commit/496b5cea6f03db014b0902ed9ca51da7240ee319

M  +7    -7    doc/appendix-modules/module-concept.docbook
M  +2    -2    doc/getting-started/before-building.docbook
M  +2    -2    doc/getting-started/configure-data.docbook
M  +4    -4    doc/introduction/brief-intro.docbook

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

diff --git a/doc/appendix-modules/module-concept.docbook b/doc/appendix-modules/module-concept.docbook
index a5a0c53b..b223fe0a 100644
--- a/doc/appendix-modules/module-concept.docbook
+++ b/doc/appendix-modules/module-concept.docbook
@@ -3,8 +3,8 @@
 
 <para>&kde; groups its software into <quote>modules</quote> of various size.
 This was initially a loose grouping of a few large modules, but with the
-introduction of the <ulink href="http://git-scm.com/">Git</ulink>-based <ulink
-href="https://projects.kde.org/">source code repositories</ulink>, these large
+introduction of the <ulink url="http://git-scm.com/">Git</ulink>-based <ulink
+url="https://projects.kde.org/">source code repositories</ulink>, these large
 modules were further split into many smaller modules.
 </para>
 
@@ -23,14 +23,14 @@ file</link>.</para>
 
 <programlisting>
 module <replaceable>kdefoo</replaceable>
-    <replaceable><option>cmake-options</option> -DCMAKE_BUILD_TYPE=Debug</replaceable>
+    <option><replaceable>cmake-options -DCMAKE_BUILD_TYPE=Debug</replaceable></option>
 end module
 </programlisting>
 
-<tip>This is a Subversion-based module since it doesn't use a <link
+<tip><para>This is a Subversion-based module since it doesn't use a <link
 linkend="conf-repository">repository</link> option. Also, the
 <option>cmake-options</option> option is listed as an example only, it is not
-required.</tip>
+required.</para></tip>
 
 </sect2>
 <sect2 id="module-groups">
@@ -49,10 +49,10 @@ module-set <replaceable>base-modules</replaceable>
 end module-set
 </programlisting>
 
-<tip>You can leave the module set name (<replaceable>base-modules</replaceable>
+<tip><para>You can leave the module set name (<replaceable>base-modules</replaceable>
 in this case) empty if you like. This <option>repository</option> setting tells
 &kdesrc-build; where to download the source from, but you can also use a
-<symbol>git://</symbol> URL.</tip>
+<symbol>git://</symbol> URL.</para></tip>
 
 <para>One special feature of the <quote><option>repository</option>
 <literal>kde-projects</literal></quote> is that &kdesrc-build; will
diff --git a/doc/getting-started/before-building.docbook b/doc/getting-started/before-building.docbook
index 3e3a7414..67a2ec3a 100644
--- a/doc/getting-started/before-building.docbook
+++ b/doc/getting-started/before-building.docbook
@@ -129,10 +129,10 @@ program.</para></listitem>
 <listitem><para>Or, you can obtain &kdesrc-build; from its source repository,
 by running:</para>
 <programlisting>
-<prompt>$ </prompt><userinput><command>git</command> <option>clone</option> <option>git://anongit.kde.org/kdesrc-build</option> <replaceable><option><filename class="directory">~/kdesrc-build</filename></option></replaceable></userinput>
+<prompt>$ </prompt><userinput><command>git <option>clone</option> <option>git://anongit.kde.org/kdesrc-build</option> <option><filename class="directory"><replaceable>~/kdesrc-build</replaceable></filename></option></command></userinput>
 </programlisting>
 
-<para>Replace <replaceable><option>~/kdesrc-build</option></replaceable> with
+<para>Replace <option><replaceable>~/kdesrc-build</replaceable></option> with
 the directory you would like to install to.
 </para></listitem>
 </orderedlist>
diff --git a/doc/getting-started/configure-data.docbook b/doc/getting-started/configure-data.docbook
index 580c10cc..9c6266c3 100644
--- a/doc/getting-started/configure-data.docbook
+++ b/doc/getting-started/configure-data.docbook
@@ -55,8 +55,8 @@ selects what &url; to download the sources from. This is useful if you are a
 developer with a <ulink url="http://techbase.kde.org/Contribute/First_Steps_with_your_KDE_SVN_Account">&kde;
 &subversion; account</ulink>.</para></listitem>
 
-<listitem>You will probably want to select different modules to build, which
-is described in <xref linkend="selecting-modules"/>.</listitem>
+<listitem><para>You will probably want to select different modules to build, which
+is described in <xref linkend="selecting-modules"/>.</para></listitem>
 </itemizedlist>
 </para>
 </sect1>
diff --git a/doc/introduction/brief-intro.docbook b/doc/introduction/brief-intro.docbook
index a31c7136..ac82d1c6 100644
--- a/doc/introduction/brief-intro.docbook
+++ b/doc/introduction/brief-intro.docbook
@@ -31,16 +31,16 @@ sequence is followed:
 </para>
 
 <orderedlist>
-<listitem>&kdesrc-build; reads in the <link linkend="cmdline">command
+<listitem><para>&kdesrc-build; reads in the <link linkend="cmdline">command
 line</link> and <link linkend="configure-data">configuration file</link>, to
 determine what to build, compile options to use, where to install,
-etc.</listitem>
+&etc;.</para></listitem>
 
-<listitem>&kdesrc-build; performs a source update for each <link
+<listitem><para>&kdesrc-build; performs a source update for each <link
 linkend="module-concept">module</link>. The update continues until all modules
 have been updated. Modules that fail to update normally do not stop the build
 – you will be notified at the end which modules did not
-update.</listitem>
+update.</para></listitem>
 </orderedlist>
 
 </sect2>