You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
755 lines
32 KiB
755 lines
32 KiB
13 years ago
|
<appendix id="tdevelop-install">
|
||
15 years ago
|
|
||
|
<appendixinfo>
|
||
|
<authorgroup>
|
||
|
<author><firstname>Bernd</firstname><surname>Pol</surname></author>
|
||
|
<author><firstname>Anne-Marie</firstname><surname>Mahfouf</surname></author>
|
||
|
<!-- ROLES_OF_TRANSLATORS -->
|
||
|
</authorgroup>
|
||
|
</appendixinfo>
|
||
|
|
||
13 years ago
|
<title>Installing &tdevelop;</title>
|
||
15 years ago
|
|
||
13 years ago
|
<indexterm zone="tdevelop-install">
|
||
15 years ago
|
<primary>installation</primary></indexterm>
|
||
|
|
||
|
<para>
|
||
13 years ago
|
In this chapter we will discuss the steps necessary to compile and install the &tdevelop; IDE:
|
||
15 years ago
|
|
||
|
<itemizedlist>
|
||
|
<listitem><para>
|
||
13 years ago
|
<link linkend="tdevelop-install-howto">How to obtain &tdevelop;</link> mainly concentrates on downloading the most recent &tdevelop; sources from svn.
|
||
15 years ago
|
</para></listitem>
|
||
|
<listitem><para>
|
||
13 years ago
|
<link linkend="requirements">&tdevelop; requirements</link> lists the programs and libraries which you need installed to successfully compile the IDE.
|
||
15 years ago
|
</para></listitem>
|
||
|
<listitem><para>
|
||
13 years ago
|
<link linkend="compile-and-install">&tdevelop; compilation and installation</link> leads you through all the steps of compilation and installation of the application.
|
||
15 years ago
|
</para></listitem>
|
||
|
<listitem><para>
|
||
13 years ago
|
<link linkend="make-api">How to obtain a &tdevelop; &API; documentation</link> tells what an API is and how you get such a useful tool for navigating the &tdevelop; sources.
|
||
15 years ago
|
</para></listitem>
|
||
|
</itemizedlist>
|
||
|
</para>
|
||
|
|
||
13 years ago
|
<sect1 id="tdevelop-install-howto">
|
||
|
<title>How to Obtain &tdevelop;</title>
|
||
15 years ago
|
|
||
13 years ago
|
<indexterm zone="tdevelop-install-howto">
|
||
|
<primary>obtain &tdevelop;</primary></indexterm>
|
||
|
<indexterm zone="tdevelop-install-howto">
|
||
|
<primary>&tdevelop;</primary>
|
||
15 years ago
|
<secondary>obtain</secondary></indexterm>
|
||
|
|
||
|
<para>
|
||
13 years ago
|
&tdevelop; is available in binary form from many different &Linux; distributions such as <!--&SuSE;, &RedHat;//--> SuSE, RedHat and others. These binaries are packed in some convenient format, mostly RPM, for easy installation. To install, follow the standard instructions given in your distribution.
|
||
15 years ago
|
</para>
|
||
|
<para>
|
||
13 years ago
|
You may as well obtain the &tdevelop; sources, compile and install them by yourself. These sources can be found via the project home page at <ulink url="http://www.tdevelop.org"> http://www.tdevelop.org</ulink> or via the <ulink url="http://download.kde.org">&kde; ftp site</ulink>.
|
||
15 years ago
|
</para>
|
||
|
|
||
|
<sect2 id="howto-svn">
|
||
13 years ago
|
<title>Get Daily &tdevelop; Snapshots from svn</title>
|
||
15 years ago
|
|
||
|
<indexterm zone="howto-svn">
|
||
|
<primary>svn</primary></indexterm>
|
||
|
|
||
|
<para>If you want to be in front of current development, anonymous svn repository snapshots are available.</para>
|
||
13 years ago
|
<para>The module name is <emphasis>tdevelop</emphasis> at <filename class="directory">svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/tdevelop</filename>.
|
||
15 years ago
|
</para>
|
||
|
|
||
|
<sect3 id="howto-svn-co">
|
||
|
<title>Initial svn Checkout</title>
|
||
|
|
||
|
<indexterm zone="howto-svn-co">
|
||
|
<primary>checkout</primary></indexterm>
|
||
|
<indexterm zone="howto-svn-co">
|
||
13 years ago
|
<primary>&tdevelop;</primary>
|
||
15 years ago
|
<secondary>svn</secondary>
|
||
|
<tertiary>checkout</tertiary></indexterm>
|
||
|
|
||
|
<para>
|
||
13 years ago
|
To obtain an initial version of &tdevelop; you must download it from anonymous svn. For this so-called <emphasis>checkout</emphasis> operation follow these steps.
|
||
15 years ago
|
</para>
|
||
|
|
||
|
<note><para>
|
||
13 years ago
|
We assume you want to put your &tdevelop; copy into the <filename class="directory">trinitysrc</filename> subdirectory of your home directory (<filename class="directory">~</filename>).
|
||
15 years ago
|
</para></note>
|
||
|
|
||
|
<informalexample><simplelist>
|
||
|
<member>
|
||
|
# Create the destination directory, if necessary:
|
||
|
</member>
|
||
|
<member>
|
||
|
<prompt>~> </prompt>
|
||
13 years ago
|
<userinput>mkdir trinitysrc</userinput>
|
||
15 years ago
|
</member>
|
||
|
<member>
|
||
|
<prompt>~> </prompt>
|
||
13 years ago
|
<userinput>cd trinitysrc</userinput>
|
||
15 years ago
|
</member>
|
||
|
<member>
|
||
13 years ago
|
<prompt>~/trinitysrc> </prompt>
|
||
13 years ago
|
<userinput>svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/tdevelop</userinput>
|
||
15 years ago
|
</member>
|
||
|
<member>
|
||
13 years ago
|
<prompt>~/trinitysrc> </prompt>
|
||
13 years ago
|
<userinput>cd tdevelop</userinput>
|
||
15 years ago
|
</member>
|
||
|
</simplelist></informalexample>
|
||
|
|
||
|
<note><para>
|
||
13 years ago
|
Once you have successfully checked out your &tdevelop; version, you may keep up with the changes using the update procedure shown in the next section.
|
||
15 years ago
|
</para></note>
|
||
|
|
||
|
<important><para>
|
||
13 years ago
|
Keep the server load low. <emphasis>Please do not checkout every time you want to keep your &tdevelop; up to date!</emphasis> Use svn update for this purpose.
|
||
15 years ago
|
</para></important>
|
||
|
|
||
|
<para>
|
||
13 years ago
|
Now you may compile your &tdevelop; version as shown in the <link linkend="compile-and-install">&tdevelop; Compilation and Installation</link> section.
|
||
15 years ago
|
</para>
|
||
|
|
||
|
</sect3> <!-- howto-svn-co -->
|
||
|
|
||
|
<sect3 id="howto-svn-up">
|
||
|
<title>Keeping Your svn Copy up to Date</title>
|
||
|
|
||
|
<indexterm zone="howto-svn-up">
|
||
|
<primary>update</primary></indexterm>
|
||
|
<indexterm zone="howto-svn-up">
|
||
13 years ago
|
<primary>&tdevelop;</primary>
|
||
15 years ago
|
<secondary>svn</secondary>
|
||
|
<tertiary>update</tertiary></indexterm>
|
||
|
|
||
|
<para>
|
||
13 years ago
|
After you checked out (and successfully compiled) &tdevelop; from svn as shown above, you'll want to keep it up to date in order to get all the patches. Follow these steps. (We again assume you have put your &tdevelop; copy into the <filename class="directory">trinitysrc</filename> directory.)
|
||
15 years ago
|
</para>
|
||
|
<para>
|
||
|
Note the <command>up</command> (= <emphasis>update</emphasis>) command instead of the <command>co</command> (which stands for <emphasis>checkout</emphasis>).
|
||
|
</para>
|
||
|
|
||
|
<informalexample><simplelist>
|
||
|
<member>
|
||
|
<prompt>~> </prompt>
|
||
13 years ago
|
<userinput>cd trinitysrc</userinput>
|
||
15 years ago
|
</member>
|
||
|
<member>
|
||
13 years ago
|
<prompt>~/trinitysrc> </prompt>
|
||
13 years ago
|
<userinput>cd tdevelop</userinput>
|
||
15 years ago
|
</member>
|
||
|
<member>
|
||
13 years ago
|
<prompt>~/trinitysrc> </prompt>
|
||
15 years ago
|
<userinput>svn up</userinput>
|
||
|
</member>
|
||
|
</simplelist></informalexample>
|
||
|
|
||
|
<note><para>
|
||
|
Keep an eye on the messages svn produces during the update sequence. The exact steps in the compilation sequence depend on this.
|
||
|
</para></note>
|
||
|
|
||
|
<para>
|
||
13 years ago
|
Now you can compile a new &tdevelop; version as shown in the <link linkend="compile-and-install-make-svn">Special svn compilation considerations</link> chapter.
|
||
15 years ago
|
</para>
|
||
|
</sect3> <!-- howto-svn-up -->
|
||
|
|
||
|
</sect2> <!-- howto-svn -->
|
||
|
|
||
|
</sect1> <!-- howto -->
|
||
|
|
||
|
<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
|
||
|
|
||
|
<sect1 id="requirements">
|
||
13 years ago
|
<title>&tdevelop; Requirements</title>
|
||
15 years ago
|
|
||
|
<indexterm zone="requirements">
|
||
|
<primary>requirements</primary></indexterm>
|
||
|
<indexterm zone="requirements">
|
||
13 years ago
|
<primary>&tdevelop;</primary>
|
||
15 years ago
|
<secondary>requirements</secondary></indexterm>
|
||
|
<indexterm zone="requirements">
|
||
|
<primary>GNU</primary>
|
||
|
<secondary>requirements</secondary></indexterm>
|
||
|
|
||
|
<para>
|
||
13 years ago
|
In order to successfully compile and use &tdevelop;, you need the following programs and libraries. They are available on most platforms as distribution packages and thereby can be installed easily.
|
||
15 years ago
|
</para>
|
||
|
|
||
|
<itemizedlist>
|
||
|
<title>Required:</title>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
<application>gcc/g++</application> ≥ 2.95.3 (or compatible)
|
||
|
<indexterm>
|
||
|
<primary>gcc</primary>
|
||
|
<secondary>requirements</secondary></indexterm>
|
||
|
<indexterm>
|
||
|
<primary>g++</primary>
|
||
|
<secondary>requirements</secondary></indexterm>
|
||
|
</para>
|
||
|
<para>
|
||
|
Available from <ulink url="gcc.gnu.org">gcc.gnu.org</ulink>
|
||
|
</para>
|
||
|
</listitem>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
<application>&GNU; make</application> (or compatible)
|
||
|
<indexterm>
|
||
|
<primary>make</primary>
|
||
|
<secondary>requirements</secondary></indexterm>
|
||
|
</para>
|
||
|
<para>
|
||
|
Available from <ulink url="www.gnu.org/software/make">www.gnu.org/software/make</ulink>
|
||
|
</para>
|
||
|
</listitem>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
&perl; 5.004 (or higher)
|
||
|
<indexterm>
|
||
|
<primary>Perl</primary>
|
||
|
<secondary>requirements</secondary></indexterm>
|
||
|
</para>
|
||
|
<para>
|
||
|
Available from <ulink url="www.perl.com">www.perl.com</ulink>
|
||
|
</para>
|
||
|
</listitem>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
<application>autoconf</application> ≥ 2.52 (or higher)
|
||
|
<indexterm>
|
||
|
<primary>autoconf</primary>
|
||
|
<secondary>requirements</secondary></indexterm>
|
||
|
</para>
|
||
|
<para>
|
||
|
Available from <ulink url="www.gnu.org/software/autoconf">www.gnu.org/software/autoconf</ulink>
|
||
|
</para>
|
||
|
</listitem>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
<application>automake</application> ≥ 1.6 (or higher)
|
||
|
<indexterm>
|
||
|
<primary>automake</primary>
|
||
|
<secondary>requirements</secondary></indexterm>
|
||
|
</para>
|
||
|
<para>
|
||
|
Available from <ulink url="www.gnu.org/software/automake">www.gnu.org/software/automake</ulink>
|
||
|
</para>
|
||
|
</listitem>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
<application>flex</application> 2.5.4 (or higher)
|
||
|
<indexterm>
|
||
|
<primary>flex</primary>
|
||
|
<secondary>requirements</secondary></indexterm>
|
||
|
</para>
|
||
|
<para>
|
||
|
Available from <ulink url="www.gnu.org/software/flex">www.gnu.org/software/flex</ulink>
|
||
|
</para>
|
||
|
</listitem>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
&Qt; ≥ 3.3.0 (or higher)
|
||
|
<indexterm>
|
||
|
<primary>Qt</primary>
|
||
|
<secondary>requirements</secondary></indexterm>
|
||
|
</para>
|
||
|
<para>
|
||
|
Available from <ulink url="www.trolltech.com/products/qt">www.trolltech.com/products/qt</ulink>
|
||
|
</para>
|
||
|
</listitem>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
<application>KDE</application> ≥ 3.4.0 (or higher)
|
||
|
<indexterm>
|
||
|
<primary>KDE</primary>
|
||
|
<secondary>requirements</secondary></indexterm>
|
||
|
</para>
|
||
|
<para>
|
||
|
Available from <ulink url="www.kde.org">www.kde.org</ulink>
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</itemizedlist>
|
||
|
|
||
|
<itemizedlist>
|
||
|
<title>Optional:</title>
|
||
|
<listitem><para>
|
||
|
The <emphasis><application>ctags</application></emphasis> source navigation tool, from <ulink url="http://ctags.sourceforge.net">http://ctags.sourceforge.net</ulink>, which enables you fast access to declarations and definitions by a few simple clicks on a name in the editor.
|
||
|
<indexterm><primary>ctags</primary></indexterm>
|
||
|
</para></listitem>
|
||
|
<listitem><para>
|
||
|
<emphasis><application>dot</application></emphasis>, a graphics language compiler, from <ulink url="http://www.graphviz.org">http:/www.graphviz.org</ulink>. This
|
||
|
<!-- ### temporarily disabled until the graphical class browser works again
|
||
|
allows you to navigate in a graphical view of your classes' dependencies. Likewise the <application>dot</application> //-->
|
||
|
tool is needed in conjunction with &doxygen; below if you want to have class relationships graphically displayed (which is highly recommended).
|
||
|
<indexterm><primary>dot</primary></indexterm>
|
||
|
</para></listitem>
|
||
|
<listitem><para>
|
||
|
The <emphasis>&doxygen;</emphasis> documentation tool, from <ulink url="http://www.doxygen.org">http://www.doxygen.org</ulink> if you want to generate concise and powerful API documentation from your projects.
|
||
|
<indexterm><primary>doxygen</primary></indexterm>
|
||
|
</para></listitem>
|
||
|
<listitem><para>
|
||
|
<emphasis><application>valgrind</application></emphasis> from <ulink url="http://developer.kde.org/~sewardj/">http://developer.kde.org/~sewardj/</ulink> helps you to find memory management problems in your applications.
|
||
|
<indexterm><primary>valgrind</primary></indexterm>
|
||
|
</para></listitem>
|
||
|
<listitem><para>
|
||
|
<emphasis><application>svn</application></emphasis> from <ulink url="http://subversion.tigris.org/">http://subversion.tigris.org/</ulink> if you want to use the svn versioning system.
|
||
|
<indexterm>
|
||
|
<primary>svn</primary>
|
||
|
<secondary>requirements</secondary></indexterm>
|
||
|
</para></listitem>
|
||
|
<listitem><para>
|
||
|
Any other compiler and/or tool in case you want to develop for another language/platform than C++/&kde; or use some special facility.
|
||
|
</para></listitem>
|
||
|
</itemizedlist>
|
||
|
|
||
|
<note>
|
||
|
<orderedlist>
|
||
|
<listitem>
|
||
|
<para>
|
||
13 years ago
|
You can, to a certain extent, circumvent the need for &autoconf; ≥ 2.52 and &automake; ≥ 1.6. Just remove the <filename class="directory">admin</filename> directory in your &tdevelop; installation directory and type
|
||
15 years ago
|
<indexterm>
|
||
|
<primary>autoconf</primary>
|
||
|
<secondary>circumvent version need</secondary></indexterm>
|
||
|
<indexterm>
|
||
|
<primary>automake</primary>
|
||
|
<secondary>circumvent version need</secondary></indexterm>
|
||
|
<indexterm>
|
||
|
<primary>version need</primary>
|
||
|
<secondary>circumvent for autoconf/automake</secondary></indexterm>
|
||
|
</para>
|
||
|
<informalexample><simplelist>
|
||
13 years ago
|
<member><prompt>(your-tdevelop-directory)> </prompt>
|
||
|
<userinput>ln -s $KDEDIR/share/apps/tdelibs/admin admin</userinput></member>
|
||
15 years ago
|
</simplelist></informalexample>
|
||
|
<para>
|
||
13 years ago
|
at the console. This causes &tdevelop; to use the standard settings in the &kde; <filename class="directory">admin</filename> directory instead.
|
||
15 years ago
|
</para>
|
||
|
</listitem>
|
||
|
<listitem>
|
||
|
<para>
|
||
13 years ago
|
Be careful <emphasis>not to mix &Qt; versions</emphasis>. Always link &tdevelop; to the same &Qt; version your &kde; library was compiled. Otherwise you will most likely experience <emphasis>very strange</emphasis> behaviours.
|
||
15 years ago
|
</para>
|
||
|
</listitem>
|
||
|
</orderedlist>
|
||
|
</note>
|
||
|
|
||
|
</sect1> <!-- requirements -->
|
||
|
|
||
|
<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
|
||
|
|
||
|
<sect1 id="compile-and-install">
|
||
13 years ago
|
<title>&tdevelop; Compilation and Installation</title>
|
||
15 years ago
|
|
||
|
<indexterm zone="compile-and-install">
|
||
13 years ago
|
<primary>&tdevelop;</primary>
|
||
15 years ago
|
<secondary>compilation</secondary></indexterm>
|
||
|
<indexterm zone="compile-and-install">
|
||
13 years ago
|
<primary>&tdevelop;</primary>
|
||
15 years ago
|
<secondary>installation</secondary></indexterm>
|
||
|
|
||
|
<para>
|
||
13 years ago
|
Once all requirements are met, you are ready to compile and install &tdevelop;. This appendix will discuss the necessary steps to do so.
|
||
15 years ago
|
</para>
|
||
|
<itemizedlist>
|
||
|
<listitem><para>
|
||
|
<link linkend="compile-and-install-preliminaries">Preliminary Steps</link> tells you about setting up a proper environment.
|
||
|
</para></listitem>
|
||
|
<listitem><para>
|
||
13 years ago
|
<link linkend="compile-and-install-make">Compile &tdevelop;</link> deals with obtaining the &tdevelop; sources from svn, how to prepare them for the installation process, and finally shows the steps necessary to compile and install &tdevelop;.
|
||
15 years ago
|
</para></listitem>
|
||
|
<listitem><para>
|
||
13 years ago
|
<link linkend="compile-and-install-options">Some Notes on configure Options</link> tells you how to run &tdevelop; if it has been installed in a location other than the &kde; directory.
|
||
15 years ago
|
</para></listitem>
|
||
|
</itemizedlist>
|
||
|
|
||
|
<sect2 id="compile-and-install-preliminaries">
|
||
|
<title>Preliminary Steps</title>
|
||
|
|
||
|
<indexterm zone="compile-and-install-preliminaries">
|
||
|
<primary>preliminaries</primary>
|
||
13 years ago
|
<secondary>&tdevelop; installation</secondary></indexterm>
|
||
15 years ago
|
<indexterm zone="compile-and-install-preliminaries">
|
||
|
<primary>KDEDIR</primary></indexterm>
|
||
|
<indexterm zone="compile-and-install-preliminaries">
|
||
|
<primary>QTDIR</primary></indexterm>
|
||
|
<indexterm zone="compile-and-install-preliminaries">
|
||
|
<primary>LD_LIBRARY_PATH</primary></indexterm>
|
||
|
<indexterm zone="compile-and-install-preliminaries">
|
||
|
<primary>LIBRARY_PATH</primary></indexterm>
|
||
|
<indexterm zone="compile-and-install-preliminaries">
|
||
|
<primary>PATH</primary></indexterm>
|
||
|
|
||
|
<para>
|
||
|
Before entering the compile sequence you must make sure all libraries and tools are available to the make system. To accomplish this some environment variables need to be properly set. The actual steps to be performed depend on the console shell you use.
|
||
|
</para>
|
||
|
|
||
|
<note><para>
|
||
|
To avoid typing in all the statements that set the necessary environment variables every time you want to compile, you should put them into your <filename>.bashrc</filename> or <filename>.cshrc</filename> file. This way the environment variables will be properly set every time you start the shell.
|
||
|
</para></note>
|
||
|
|
||
|
<sect3 id="compile-and-install-preliminaries-bash">
|
||
|
<title>Setting the Environment for the bash Shell</title>
|
||
|
|
||
|
<para>
|
||
|
If you use the bash shell add the following lines:
|
||
|
</para>
|
||
|
|
||
|
<informalexample><simplelist>
|
||
|
<member><userinput>export KDEDIR=</userinput>(path to your KDE installation)</member>
|
||
|
<member><userinput>export QTDIR=</userinput>(path to your Qt library)</member>
|
||
|
<member><userinput>export LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LD_LIBRARY_PATH</userinput></member>
|
||
|
<member><userinput>export LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LIBRARY_PATH</userinput></member>
|
||
|
<member><userinput>export PATH=$QTDIR/bin:$KDEDIR/bin:$PATH</userinput></member>
|
||
|
</simplelist></informalexample>
|
||
|
<para></para>
|
||
|
|
||
|
</sect3> <!-- compile-and-install-preliminaries-bash -->
|
||
|
|
||
|
<sect3 id="compile-and-install-preliminaries-tcsh">
|
||
|
<title>Setting the Environment for the tcsh Shell</title>
|
||
|
|
||
|
<para>
|
||
|
If you use the tcsh shell add the following lines:
|
||
|
</para>
|
||
|
<para>
|
||
|
<informalexample><simplelist>
|
||
|
<member><userinput>setenv KDEDIR </userinput>(path to your KDE installation)</member>
|
||
|
<member><userinput>setenv QTDIR </userinput>(path to your Qt library)</member>
|
||
|
<member><userinput>setenv LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LD_LIBRARY_PATH</userinput></member>
|
||
|
<member><userinput>setenv LIBRARY_PATH $QTDIR/lib:$KDEDIR/lib:$LIBRARY_PATH</userinput></member>
|
||
|
<member><userinput>setenv PATH $QTDIR/bin:$KDEDIR/bin:$PATH</userinput></member>
|
||
|
</simplelist></informalexample>
|
||
|
</para>
|
||
|
|
||
|
</sect3> <!-- compile-and-install-preliminaries-tcs -->
|
||
|
|
||
|
</sect2> <!-- compile-and-install-preliminaries -->
|
||
|
|
||
|
<sect2 id="compile-and-install-make">
|
||
13 years ago
|
<title>Compile &tdevelop;</title>
|
||
15 years ago
|
|
||
|
<indexterm zone="compile-and-install-make">
|
||
|
<primary>make</primary>
|
||
13 years ago
|
<secondary>&tdevelop; installation</secondary></indexterm>
|
||
15 years ago
|
<indexterm zone="compile-and-install-make">
|
||
|
<primary>compiling</primary>
|
||
13 years ago
|
<secondary>&tdevelop;</secondary></indexterm>
|
||
15 years ago
|
|
||
|
<note><para>
|
||
13 years ago
|
In the following discussion we assume that you have put your &tdevelop; sources in the <filename class="directory">~/trinitysrc/tdevelop</filename> directory.
|
||
15 years ago
|
</para></note>
|
||
|
|
||
|
<sect3 id="compile-and-install-make-svn">
|
||
|
<title>Special svn Compilation Considerations</title>
|
||
|
|
||
|
<para>
|
||
13 years ago
|
In case you use a &tdevelop; snapshot from svn the initial compilation steps depend on whether you just did a complete checkout or only updated the source.
|
||
15 years ago
|
</para>
|
||
|
|
||
|
<variablelist>
|
||
|
<varlistentry>
|
||
|
<term id="compile-and-install-make-svn-co">After a svn Checkout</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
You must <emphasis>initialize the make system</emphasis> after a fresh checkout. The same is true every time you need to start over from scratch. Type:
|
||
|
</para>
|
||
|
|
||
|
<informalexample><simplelist><member>
|
||
13 years ago
|
<prompt>~/trinitysrc/tdevelop> </prompt>
|
||
15 years ago
|
<userinput>make -f admin/Makefile.common svn-clean</userinput>
|
||
|
</member></simplelist></informalexample>
|
||
|
<para>
|
||
|
and then <emphasis>all of the following steps</emphasis>.
|
||
|
</para>
|
||
|
<note><para>
|
||
|
You might need access to the svn repository for the clean-up if any corrupted or missing files must be reconstructed.
|
||
|
</para></note>
|
||
|
<important><para>
|
||
|
The <command>svn-clean</command> command will <emphasis>remove every file</emphasis> not in svn from the directory! Make sure to back up any valuable information before you issue this clean-up command.
|
||
|
</para></important>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term id="compile-and-install-make-svn-up">After a svn Update</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
The next step depends on the output of the svn update sequence. If you got something like (there may be a U or a P marker in the leftmost column, both denoting the file has been changed):
|
||
|
</para>
|
||
|
|
||
|
<screen>
|
||
|
U /some_directory_path/Makefile.am
|
||
|
</screen>
|
||
|
<para>
|
||
|
or if you just did a full checkout, you must enter:
|
||
|
</para>
|
||
|
<informalexample><simplelist><member>
|
||
13 years ago
|
<prompt>~/trinitysrc/tdevelop> </prompt>
|
||
15 years ago
|
<userinput>make -f Makefile.svn</userinput>
|
||
|
</member></simplelist></informalexample>
|
||
|
<para>
|
||
|
before you proceed with <emphasis>all of the following steps</emphasis>.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
</variablelist>
|
||
|
</sect3> <!-- compile-and-install-make-svn -->
|
||
|
|
||
|
<sect3 id="compile-and-install-make-basic">
|
||
|
<title>Basic <command>make</command> Command Sequence</title>
|
||
|
|
||
|
<para>
|
||
13 years ago
|
Once the basic make system is set up you must decide which type of the &tdevelop; system you want to use. This is done in the following configure step which builds the actual <filename>Makefile</filename>s the <command>make</command> command will use.
|
||
15 years ago
|
</para>
|
||
|
|
||
|
<note><para>
|
||
13 years ago
|
You may drop the <option>--prefix</option> option in the following <command>configure</command> command lines if you want &tdevelop; be installed in the default &kde; directory. See the <link linkend="compile-and-install-options">Some notes on configure options</link> chapter for this.
|
||
15 years ago
|
</para></note>
|
||
|
|
||
|
<variablelist>
|
||
|
<varlistentry>
|
||
|
<term>A Debug-Compiled Version</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
13 years ago
|
If you want to keep track of what your &tdevelop; application does at run-time you may build a debug-compiled version. Just command <command>configure</command> to do so:
|
||
15 years ago
|
</para>
|
||
|
|
||
|
<informalexample><simplelist><member>
|
||
13 years ago
|
<prompt>~/trinitysrc/tdevelop> </prompt>
|
||
13 years ago
|
<userinput>./configure --enable-debug=full --prefix=</userinput>(where-your-trinity-is)
|
||
15 years ago
|
</member></simplelist></informalexample>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term>A Release-Compiled Version</term>
|
||
|
<listitem>
|
||
13 years ago
|
<para>If you only want to use &tdevelop; as-is a (smaller and faster
|
||
15 years ago
|
running) release version suffices. <command>configure</command> defaults to
|
||
|
this.</para>
|
||
|
|
||
|
<informalexample><simplelist><member>
|
||
13 years ago
|
<prompt>~/trinitysrc/tdevelop> </prompt>
|
||
13 years ago
|
<userinput>./configure --prefix=</userinput>(where-your-trinity-is)
|
||
15 years ago
|
</member></simplelist></informalexample>
|
||
|
|
||
|
<note>
|
||
|
<para>
|
||
13 years ago
|
If you want to build your own <link linkend="make-api">API documentation</link> for &tdevelop; you must include yet another option in the <command>configure</command> command:
|
||
15 years ago
|
</para>
|
||
|
<informalexample><simplelist>
|
||
13 years ago
|
<member><prompt>~/trinitysrc/tdevelop> </prompt>
|
||
|
<userinput>./configure --</userinput>(options-as-above) <userinput>\</userinput></member> <member><userinput>--with-tdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/tdelibs-apidocs</userinput></member>
|
||
15 years ago
|
</simplelist></informalexample>
|
||
|
</note>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
13 years ago
|
<term>Make and Install &tdevelop;</term>
|
||
15 years ago
|
<listitem>
|
||
|
<para>
|
||
|
<command>configure</command> will check the system and build some <filename>Makefile</filename>s according to what it found. The <command>make</command> command will use the main <filename>Makefile</filename> by default. Thus
|
||
|
</para>
|
||
|
|
||
|
<informalexample><simplelist><member>
|
||
13 years ago
|
<prompt>~/trinitysrc/tdevelop> </prompt>
|
||
15 years ago
|
<userinput>make</userinput>
|
||
|
</member></simplelist></informalexample>
|
||
|
<para>
|
||
|
suffices. If necessary, now gain root user rights using the command
|
||
|
</para>
|
||
|
<informalexample><simplelist><member>
|
||
13 years ago
|
<prompt>~/trinitysrc/tdevelop> </prompt>
|
||
15 years ago
|
<userinput>su</userinput>
|
||
|
</member></simplelist></informalexample>
|
||
|
<para>
|
||
|
and entering the root password. Then install the application:
|
||
|
</para>
|
||
|
<informalexample><simplelist><member>
|
||
13 years ago
|
<prompt>~/trinitysrc/tdevelop> </prompt>
|
||
15 years ago
|
<userinput>make install</userinput>
|
||
|
</member></simplelist></informalexample>
|
||
|
<para>
|
||
13 years ago
|
That's all. If you installed &tdevelop; in the default &kde; directory you may now run the IDE. Otherwise some additional steps will be necessary as shown in the <link linkend="compile-and-install-options-dir">Non-default installation directory</link> section below.
|
||
15 years ago
|
</para>
|
||
|
|
||
|
<note>
|
||
|
<para>
|
||
13 years ago
|
In fact there usually will have been three &tdevelop;-based applications installed:
|
||
15 years ago
|
</para>
|
||
|
<itemizedlist>
|
||
13 years ago
|
<listitem><para>The &tdevelop; IDE — this is the place where you will usually work.</para></listitem>
|
||
|
<listitem><para>The stand-alone &tdevelop; Assistant documentation browser — isolates all the powerful documentation facilities of the &tdevelop; IDE in a separate tool. This comes in handy when you want to look up some programming documentation but do not want to start the full IDE.</para></listitem>
|
||
|
<listitem><para>The &tdevelop; Designer — enhances the &Qt; User Interface Designer by &kde; specific elements and integrates nicely in the &tdevelop; IDE.</para></listitem>
|
||
15 years ago
|
</itemizedlist>
|
||
|
</note>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
</variablelist>
|
||
|
|
||
|
|
||
|
</sect3> <!-- compile-and-install-make-basic -->
|
||
|
</sect2> <!-- compile-and-install-make -->
|
||
|
|
||
|
|
||
|
<sect2 id="compile-and-install-options">
|
||
|
<title>Some Notes on <command>configure</command> Options</title>
|
||
|
|
||
|
<sect3 id="compile-and-install-options-dir">
|
||
|
<title>Non-default Installation Directory</title>
|
||
|
|
||
|
<indexterm zone="compile-and-install-options-dir">
|
||
13 years ago
|
<primary>&tdevelop;</primary>
|
||
15 years ago
|
<secondary>installation</secondary>
|
||
|
<tertiary>non-default directory</tertiary></indexterm>
|
||
|
<indexterm zone="compile-and-install-options-dir">
|
||
|
<primary>non-default directory</primary></indexterm>
|
||
|
<indexterm zone="compile-and-install-options-dir">
|
||
|
<primary>KDEDIRS</primary></indexterm>
|
||
|
<indexterm zone="compile-and-install-options-dir">
|
||
|
<primary>kbuildsycoca</primary></indexterm>
|
||
|
|
||
|
<para>
|
||
13 years ago
|
By default <command>configure</command> prepares the IDE to be installed in the default &kde; directory. This is necessary because &tdevelop; assumes direct access to some tools and parts which reside there. If want to use your own installation directory, you must tell <command>configure</command> this by the <option>--prefix</option> option:
|
||
15 years ago
|
</para>
|
||
|
<informalexample><simplelist><member>
|
||
13 years ago
|
<prompt>~/trinitysrc/tdevelop> </prompt>
|
||
13 years ago
|
<userinput>./configure --prefix=</userinput>(where-your-trinity-is)
|
||
15 years ago
|
</member></simplelist></informalexample>
|
||
|
<para>
|
||
13 years ago
|
There is a caveat if you do so. You must provide a means for &tdevelop; to access the needed tools and parts in the &kde; directory when running. (You can still use the IDE without doing so, but with very restrained capabilities.)
|
||
15 years ago
|
</para>
|
||
|
<para>
|
||
13 years ago
|
Call up a shell and have the following commands executed before you start &tdevelop; at the shell prompt.
|
||
15 years ago
|
</para>
|
||
|
|
||
|
<note><para>
|
||
|
<emphasis>Take care to use the plural:</emphasis> It is <quote><envar>KDEDIRS</envar></quote>, not just <quote><envar>KDEDIR</envar></quote>)
|
||
|
</para></note>
|
||
|
|
||
|
<informalexample><simplelist>
|
||
|
<member>
|
||
|
<prompt>~> </prompt>
|
||
13 years ago
|
<userinput>export KDEDIRS=/usr/local/kde:/opt/trinity</userinput>
|
||
15 years ago
|
</member>
|
||
|
<member>
|
||
|
<prompt>~> </prompt>
|
||
|
<userinput>kbuildsycoca</userinput>
|
||
|
</member>
|
||
|
<member>
|
||
13 years ago
|
(Now start &tdevelop;:)
|
||
15 years ago
|
</member>
|
||
|
<member>
|
||
|
<prompt>~> </prompt>
|
||
13 years ago
|
<userinput>tdevelop</userinput>
|
||
15 years ago
|
</member>
|
||
|
</simplelist></informalexample>
|
||
|
|
||
|
<note><simplelist>
|
||
|
<member>The <envar>KDEDIRS</envar> environment variable must be set to the <emphasis>list of active &kde; directories</emphasis> in your system. We use</member>
|
||
13 years ago
|
<member><filename class="directory">/usr/local/kde</filename>:<filename class="directory">/opt/trinity</filename></member>
|
||
15 years ago
|
<member>as an example only.</member>
|
||
13 years ago
|
<member>The <filename class="directory">/usr/local/kde</filename> directory may for instance contain an incomplete &kde; version you compiled for debug purposes, and the <filename class="directory">/opt/trinity</filename> directory may in addition contain the standard &kde; version from your distribution that is used for everyday work.</member>
|
||
15 years ago
|
</simplelist></note>
|
||
|
|
||
|
<para>
|
||
|
In a tcsh shell you must set the environment variables using:
|
||
|
</para>
|
||
|
<informalexample><simplelist><member>
|
||
|
<prompt>~> </prompt>
|
||
13 years ago
|
<userinput>setenv KDEDIRS /usr/local/kde:/opt/trinity</userinput>
|
||
15 years ago
|
</member></simplelist></informalexample>
|
||
|
<para>
|
||
13 years ago
|
The <command>kbuildsycoca</command> command (<quote>build system control cache</quote>) looks around for libraries and caches their location and version, so that &tdevelop; can find them. The caveat is that it takes noticeable time—and it has to be run any time you call up the shell to start &tdevelop; from a non-default directory. You may want to put the above commands into a shell script to reduce the typing effort.
|
||
15 years ago
|
</para>
|
||
|
<para>
|
||
|
(You could as well put the lines in your <filename>.bashrc</filename> or <filename>.cshrc</filename> file, but this is not advisable as <command>kbuildsycoca</command> will then be run any time you call up the shell.)
|
||
|
</para>
|
||
|
|
||
|
<note><para>
|
||
|
The <command>kbuildsycoca</command> command does not run from within the root. You must call it from a non-root user. (But is <emphasis>not a very good idea</emphasis> after all to do software development from within the root!)
|
||
|
</para></note>
|
||
|
</sect3> <!-- compile-and-install-options-dir -->
|
||
|
|
||
|
<!-- ### put a sect3 with other configuration options here -->
|
||
|
|
||
|
</sect2> <!-- compile-and-install-options -->
|
||
|
|
||
|
</sect1> <!-- compile-and-install -->
|
||
|
|
||
|
<sect1 id="make-api">
|
||
13 years ago
|
<title>How to Obtain a &tdevelop; API Documentation</title>
|
||
15 years ago
|
|
||
|
<indexterm zone="make-api">
|
||
|
<primary>API</primary>
|
||
13 years ago
|
<secondary>&tdevelop;</secondary></indexterm>
|
||
15 years ago
|
<indexterm zone="make-api">
|
||
13 years ago
|
<primary>&tdevelop;</primary>
|
||
15 years ago
|
<secondary>API</secondary></indexterm>
|
||
|
<indexterm zone="make-api">
|
||
|
<primary>compiling</primary>
|
||
13 years ago
|
<secondary>&tdevelop;</secondary>
|
||
15 years ago
|
<tertiary>API</tertiary></indexterm>
|
||
|
<indexterm zone="make-api">
|
||
|
<primary>configure</primary>
|
||
13 years ago
|
<secondary>&tdevelop; API</secondary></indexterm>
|
||
15 years ago
|
|
||
|
<para>
|
||
|
API is the short form of <quote>Application Program Interface</quote>. Actually such an API cotains a series of descriptions (&ie; calling conventions) by which an application program can access the operating system and other services. In our context, however, a broader definition was adopted. The API of a &kde; or &Qt; application is an abstract of the classes and methods interfaces, a synopsis to be used like a dictionary to navigate the sources.
|
||
|
</para>
|
||
|
<para>
|
||
13 years ago
|
There is a version of the most current API available at the <ulink url="http://www.tdevelop.org/HEAD/doc/api/html/index.html">KDevelop-Home website</ulink>. It will be automatically updated every 24 hours so you can keep up.
|
||
15 years ago
|
</para>
|
||
|
<para>
|
||
13 years ago
|
Alas, this version is best used read-only over the internet. If you do not always have internet access you may as well build your own API documentation from the &tdevelop; sources. To do so, you must tell the automake system where to find the KDELIBS API in your system. This is accomplished by the special option <option>--with-tdelibsdoxy-dir</option> in the <command>configure</command> command when you prepare to compile the &tdevelop; sources:
|
||
15 years ago
|
</para>
|
||
|
|
||
|
<informalexample><simplelist>
|
||
|
<member>
|
||
13 years ago
|
<prompt>~/trinitysrc/tdevelop> </prompt>
|
||
15 years ago
|
<userinput>./configure --</userinput>(options-as-usual)<userinput> \</userinput>
|
||
|
</member>
|
||
|
<member>
|
||
13 years ago
|
<userinput>--with-tdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/tdelibs-apidocs</userinput>
|
||
15 years ago
|
</member>
|
||
|
</simplelist></informalexample>
|
||
|
|
||
|
<para>
|
||
13 years ago
|
(<command>make</command> will replace the global <varname>$KDEDIR</varname> variable with the actual &kde; directory setting recorded therein.) Then issue a <command>make</command> command <link linkend="compile-and-install-make-basic">as usual</link>. After the &tdevelop; IDE has been built you have the option to build the API as well. For this you must issue
|
||
15 years ago
|
</para>
|
||
|
<informalexample><simplelist><member>
|
||
13 years ago
|
<prompt>~/trinitysrc/tdevelop> </prompt>
|
||
15 years ago
|
<userinput>make apidocs</userinput>
|
||
|
</member></simplelist></informalexample>
|
||
|
|
||
|
<para>
|
||
13 years ago
|
This will build a <filename>Doxyfile</filename> in your &tdevelop; base directory which in turn will be processed by the <application>Doxygen</application> application to build quite a lot of <filename>.html</filename> API files. When this rather lengthy API building process (may last more than an hour on a slow system) finally comes to an end, you must install the API just like you have to install the &tdevelop; IDE itself. If necessary obtain superuser rights by
|
||
15 years ago
|
</para>
|
||
|
|
||
|
<informalexample><simplelist><member>
|
||
13 years ago
|
<prompt>~/trinitysrc/tdevelop> </prompt>
|
||
15 years ago
|
<userinput>su</userinput>
|
||
|
</member></simplelist></informalexample>
|
||
|
|
||
|
<para>
|
||
|
and entering the root password. Then install the API files:
|
||
|
</para>
|
||
|
|
||
|
<informalexample><simplelist><member>
|
||
13 years ago
|
<prompt>~/trinitysrc/tdevelop> </prompt>
|
||
15 years ago
|
<userinput>make install-apidox</userinput>
|
||
|
</member></simplelist></informalexample>
|
||
|
|
||
|
<para>
|
||
13 years ago
|
Once this is done, <command>make</command> will inform you about the directory where you can finally look at the API documentation's contents. Note this address, you can use it from &konqueror; as well as from inside &tdevelop;, in case you have set up the &tdevelop; sources themselves as a project to work on.
|
||
15 years ago
|
</para>
|
||
|
|
||
|
<note><para>
|
||
13 years ago
|
You will most probably see a lot of warning and/or error messages during the API build run by <application>Doxygen</application>. It is best to ignore them, they are of interest to the &tdevelop; developers only. If the API generation ever comes to a successful end, the <filename>.html</filename> API files will be usable.
|
||
15 years ago
|
</para></note>
|
||
|
|
||
|
</sect1> <!-- make-api -->
|
||
|
|
||
13 years ago
|
</appendix> <!-- tdevelop-install -->
|