qt-copy is gone, replace it with qt

CCMAIL:mpyne@kde.org
wilder
Burkhard Lück 14 years ago
parent 767942ff72
commit 60139c74bb
  1. 52
      doc/index.docbook

@ -254,7 +254,7 @@ to use the &Qt; copy, you need to do these things:</para>
<itemizedlist>
<listitem>
<para>Make sure to remove the qt-copy module from your <link
<para>Make sure to remove the qt module from your <link
linkend="configure-data">configuration file</link>, as you will not need it,
and having it would add extra time to your build.</para>
</listitem>
@ -403,11 +403,11 @@ destination directory that &kde; is installed to. This defaults to
<listitem><para><link linkend="conf-qtdir">qtdir</link>, which controls the
path to the installation of &Qt; to use. The default is to use a &Qt; compiled
by &kdesrc-build;, using the special qt-copy module and the latest available
by &kdesrc-build;, using the special qt module and the latest available
source code.
(<filename class="directory">~/kdesrc/build/qt-copy</filename>).</para>
(<filename class="directory">~/kdesrc/build/qt</filename>).</para>
<note><para>This also controls where to install qt-copy.</para></note>
<note><para>This also controls where to install qt.</para></note>
</listitem>
<listitem><para><link linkend="conf-svn-server">svn-server</link>, which
@ -562,7 +562,7 @@ global
<option><link linkend="conf-git-repository-base">git-repository-base</link></option> <replaceable>kde-git</replaceable> <replaceable>kde:</replaceable>
end global
module <replaceable>qt-copy</replaceable>
module <replaceable>qt</replaceable>
# Options removed for brevity
end module
@ -829,10 +829,10 @@ samples given in this section for your particular shell.</para></important>
Open or create the <filename>.bash_profile</filename> file in the home directory with your favorite editor,
and add to the end of the file:
If you are building the qt-copy module (you are by default), add instead:
If you are building the qt module (you are by default), add instead:
<programlisting>
QTDIR=(path to qtdir) # Such as ~/kdesrc/build/qt-copy by default.
QTDIR=(path to qtdir) # Such as ~/kdesrc/build/qt by default.
KDEDIR=(path to kdedir) # Such as ~/kde by default.
KDEDIRS=$KDEDIR
PATH=$KDEDIR/bin:$QTDIR/bin:$PATH
@ -848,7 +848,7 @@ fi
export QTDIR KDEDIRS PATH MANPATH LD_LIBRARY_PATH
</programlisting>
or, if you are not building qt-copy (and are using your system &Qt; instead), add
or, if you are not building qt (and are using your system &Qt; instead), add
this instead:
<programlisting>
@ -1028,8 +1028,8 @@ including optionally applying &kde;-recommended bugfix and optimization patches
to the module.
<note><para>For historical reasons, the &kdesrc-build; module used to build
&Qt; should be called <literal>qt-copy</literal>. See also <xref
linkend="using-qt-copy"/>.
&Qt; should be called <literal>qt</literal>. See also <xref
linkend="using-qt"/>.
</para></note>
</para></listitem>
@ -1130,7 +1130,7 @@ a base &kde; single-user installation from the anonymous source repositories.
<listitem><para>
Tilde-expansion for your configuration options. For example, you can
specify:
<programlisting>qtdir ~/kdesrc/build/qt-copy</programlisting>
<programlisting>qtdir ~/kdesrc/build/qt</programlisting>
</para></listitem>
<listitem><para>
@ -1436,7 +1436,7 @@ for older modules of course.</para>
<entry>apply-qt-patches</entry>
<entry></entry>
<entry>This option was removed in kdesrc-build 1.10. To get the same effect,
see <xref linkend="using-qt-copy" /> and the <link
see <xref linkend="using-qt" /> and the <link
linkend="conf-repository">repository</link> option.</entry>
</row>
@ -1531,7 +1531,7 @@ time, especially if you run &kdesrc-build; daily, or more frequently.</para>
<important><para>This feature is provided as an optimization only. Like many
other optimizations, there are trade-offs for the correctness of your
installation. For instance, changes to the qt-copy or kdelibs modules may cause
installation. For instance, changes to the qt or kdelibs modules may cause
a rebuild of other modules to be necessary, even if the source code doesn't
change at all.</para></important>
</entry>
@ -1554,14 +1554,14 @@ operation of the &git; source control system.</para>
<row id="conf-cmake-options">
<entry>cmake-options</entry>
<entry>Appends to global options (not applicable to qt-copy)</entry>
<entry>Appends to global options (not applicable to qt)</entry>
<entry><para>Use this option to specify what flags to pass to &cmake; when
creating the build system for the module. When this is used as a global option,
it is applied to all modules that this script builds. When used as a module
option, it is added to the end of the global options. This allows you to
specify common &cmake; options in the global section.</para>
<para>This option does not apply to qt-copy (which does not use &cmake;). Use
<para>This option does not apply to qt (which does not use &cmake;). Use
<link linkend="conf-configure-flags">configure-flags</link> instead.</para>
<para>Since these options are passed directly to the &cmake; command line, they
@ -1592,7 +1592,7 @@ color codes to anything but a terminal (such as xterm, &konsole;, or the normal
<entry><para>Use this option to specify what flags to pass to ./configure when
creating the build system for the module. When this is used as a global-option,
it is applied to all modules that this script builds. <emphasis>This option
only works for qt-copy.</emphasis></para>
only works for qt.</emphasis></para>
<para>To change configuration settings for KDE 4 modules, see
<link linkend="conf-cmake-options">cmake-options</link>.
@ -1950,8 +1950,8 @@ deleted or not. The default value is <replaceable>true</replaceable>.</para>
<entry>Set this option to set the environment variable <envar>QTDIR</envar> while building.
You cannot override this setting in a module option. If you do not specify
this option, it defaults to
<filename class="directory"><symbol>${source-dir}</symbol>/build/qt-copy</filename>,
which uses the qt-copy module included in the &kde; source repository.
<filename class="directory"><symbol>${source-dir}</symbol>/build/qt</filename>,
which uses the qt module included in the &kde; source repository.
You may use a tilde (~) to represent your home directory.
</entry>
</row>
@ -1983,7 +1983,7 @@ since &kdesrc-build; will be unable to perform incremental builds.</para>
<entry>Module setting overrides global</entry>
<entry><para>This option was introduced with version 1.10, and is used to
specify the &git; repository to download the source code for the module.
&Qt; (and therefore qt-copy) would need this option, as well as various
&Qt; (and therefore qt) would need this option, as well as various
&kde; modules that are in the process of conversion to use &git;.</para></entry>
</row>
@ -2694,11 +2694,11 @@ do with this tool.</para>
<sect1 id="basic-features">
<title>Basic &kdesrc-build; features</title>
<sect2 id="using-qt-copy">
<title>qt-copy support</title>
<sect2 id="using-qt">
<title>qt support</title>
<para>&kdesrc-build; supports building the &Qt; toolkit used by &kde; software
as a convenience to users. This support is handled by a special module named
qt-copy.</para>
qt.</para>
<note><para>&Qt; is developed under a separate repository from &kde; software
located at <ulink
@ -2708,10 +2708,10 @@ url="http://qt.gitorious.org/qt">http://qt.gitorious.org/qt</ulink>.</para></not
<link linkend="conf-qtdir">qtdir</link> setting is set to the directory you'd
like to install &Qt; to, as described in <xref linkend="configure-data"/>.</para>
<para>You should then ensure that the qt-copy module is added to
<para>You should then ensure that the qt module is added to
your <filename>.kdesrc-buildrc</filename>, before any other modules in the
file. If you are using the sample configuration file, you can simply
uncomment the existing qt-copy module entry.</para>
uncomment the existing qt module entry.</para>
<para>Now you should verify the <link
linkend="conf-repository">repository</link> option and <link
@ -2723,7 +2723,7 @@ on the &kde; source repositories (no other changes are applied, it is simply
a clone of the official source). This is highly recommended due to occasional
issues with cloning the full &Qt; module from its official repository.</para>
<para>You can set the <option>repository</option> option for the qt-copy
<para>You can set the <option>repository</option> option for the qt
module to <userinput>kde:qt</userinput> to use this option.</para>
</listitem>
@ -3438,7 +3438,7 @@ if you are actually using them, at least until you are done using
<para>Also, if you already have a &Qt; installed by your distribution (and
the odds are good that you do), you probably do not need to install the
qt-copy module. That will shave about 200 megabytes off of the on-disk source
qt module. That will shave about 200 megabytes off of the on-disk source
size.</para>
<para>One thing to note is that due to the way &subversion; works: there are actually

Loading…
Cancel
Save