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>
