From 2ecab1a194b0dc551b478820e1aaa3b8713354cc Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Wed, 16 Nov 2011 13:53:18 -0600 Subject: Additional renaming of kde to tde --- doc/kdevelop/kdevelop-install.docbook | 190 +++++++++++++++++----------------- 1 file changed, 95 insertions(+), 95 deletions(-) (limited to 'doc/kdevelop/kdevelop-install.docbook') diff --git a/doc/kdevelop/kdevelop-install.docbook b/doc/kdevelop/kdevelop-install.docbook index 028f5e10..62123433 100644 --- a/doc/kdevelop/kdevelop-install.docbook +++ b/doc/kdevelop/kdevelop-install.docbook @@ -1,4 +1,4 @@ - + @@ -8,54 +8,54 @@ -Installing &kdevelop; +Installing &tdevelop; - + installation -In this chapter we will discuss the steps necessary to compile and install the &kdevelop; IDE: +In this chapter we will discuss the steps necessary to compile and install the &tdevelop; IDE: - How to obtain &kdevelop; mainly concentrates on downloading the most recent &kdevelop; sources from svn. + How to obtain &tdevelop; mainly concentrates on downloading the most recent &tdevelop; sources from svn. - &kdevelop; requirements lists the programs and libraries which you need installed to successfully compile the IDE. + &tdevelop; requirements lists the programs and libraries which you need installed to successfully compile the IDE. - &kdevelop; compilation and installation leads you through all the steps of compilation and installation of the application. + &tdevelop; compilation and installation leads you through all the steps of compilation and installation of the application. -How to obtain a &kdevelop; &API; documentation tells what an API is and how you get such a useful tool for navigating the &kdevelop; sources. +How to obtain a &tdevelop; &API; documentation tells what an API is and how you get such a useful tool for navigating the &tdevelop; sources. - -How to Obtain &kdevelop; + +How to Obtain &tdevelop; - - obtain &kdevelop; - - &kdevelop; + + obtain &tdevelop; + + &tdevelop; obtain -&kdevelop; is available in binary form from many different &Linux; distributions such as 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. +&tdevelop; is available in binary form from many different &Linux; distributions such as 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. -You may as well obtain the &kdevelop; sources, compile and install them by yourself. These sources can be found via the project home page at http://www.kdevelop.org or via the &kde; ftp site. +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 http://www.tdevelop.org or via the &kde; ftp site. -Get Daily &kdevelop; Snapshots from svn +Get Daily &tdevelop; Snapshots from svn svn If you want to be in front of current development, anonymous svn repository snapshots are available. -The module name is kdevelop at svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/kdevelop. +The module name is tdevelop at svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/tdevelop. @@ -64,16 +64,16 @@ You may as well obtain the &kdevelop; sources, compile and install them by yours checkout - &kdevelop; + &tdevelop; svn checkout -To obtain an initial version of &kdevelop; you must download it from anonymous svn. For this so-called checkout operation follow these steps. +To obtain an initial version of &tdevelop; you must download it from anonymous svn. For this so-called checkout operation follow these steps. -We assume you want to put your &kdevelop; copy into the trinitysrc subdirectory of your home directory (~). +We assume you want to put your &tdevelop; copy into the trinitysrc subdirectory of your home directory (~). @@ -90,24 +90,24 @@ We assume you want to put your &kdevelop; copy into the &kdevelop; Compilation and Installation section. +Now you may compile your &tdevelop; version as shown in the &tdevelop; Compilation and Installation section. @@ -118,12 +118,12 @@ Now you may compile your &kdevelop; version as shown in the update - &kdevelop; + &tdevelop; svn update -After you checked out (and successfully compiled) &kdevelop; 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 &kdevelop; copy into the trinitysrc directory.) +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 trinitysrc directory.) Note the up (= update) command instead of the co (which stands for checkout). @@ -136,7 +136,7 @@ Note the up (= update) command instead o ~/trinitysrc> - cd kdevelop + cd tdevelop ~/trinitysrc> @@ -149,7 +149,7 @@ Keep an eye on the messages svn produces during the update sequence. The exact s -Now you can compile a new &kdevelop; version as shown in the Special svn compilation considerations chapter. +Now you can compile a new &tdevelop; version as shown in the Special svn compilation considerations chapter. @@ -160,19 +160,19 @@ Now you can compile a new &kdevelop; version as shown in the -&kdevelop; Requirements +&tdevelop; Requirements requirements - &kdevelop; + &tdevelop; requirements GNU requirements -In order to successfully compile and use &kdevelop;, you need the following programs and libraries. They are available on most platforms as distribution packages and thereby can be installed easily. +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. @@ -306,7 +306,7 @@ In order to successfully compile and use &kdevelop;, you need the following prog - You can, to a certain extent, circumvent the need for &autoconf; ≥ 2.52 and &automake; ≥ 1.6. Just remove the admin directory in your &kdevelop; installation directory and type + You can, to a certain extent, circumvent the need for &autoconf; ≥ 2.52 and &automake; ≥ 1.6. Just remove the admin directory in your &tdevelop; installation directory and type autoconf circumvent version need @@ -318,16 +318,16 @@ In order to successfully compile and use &kdevelop;, you need the following prog circumvent for autoconf/automake - (your-kdevelop-directory)> - ln -s $KDEDIR/share/apps/kdelibs/admin admin + (your-tdevelop-directory)> + ln -s $KDEDIR/share/apps/tdelibs/admin admin - at the console. This causes &kdevelop; to use the standard settings in the &kde; admin directory instead. + at the console. This causes &tdevelop; to use the standard settings in the &kde; admin directory instead. - Be careful not to mix &Qt; versions. Always link &kdevelop; to the same &Qt; version your &kde; library was compiled. Otherwise you will most likely experience very strange behaviours. + Be careful not to mix &Qt; versions. Always link &tdevelop; to the same &Qt; version your &kde; library was compiled. Otherwise you will most likely experience very strange behaviours. @@ -338,27 +338,27 @@ In order to successfully compile and use &kdevelop;, you need the following prog -&kdevelop; Compilation and Installation +&tdevelop; Compilation and Installation - &kdevelop; + &tdevelop; compilation - &kdevelop; + &tdevelop; installation -Once all requirements are met, you are ready to compile and install &kdevelop;. This appendix will discuss the necessary steps to do so. +Once all requirements are met, you are ready to compile and install &tdevelop;. This appendix will discuss the necessary steps to do so. Preliminary Steps tells you about setting up a proper environment. - Compile &kdevelop; deals with obtaining the &kdevelop; sources from svn, how to prepare them for the installation process, and finally shows the steps necessary to compile and install &kdevelop;. + Compile &tdevelop; 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;. - Some Notes on configure Options tells you how to run &kdevelop; if it has been installed in a location other than the &kde; directory. + Some Notes on configure Options tells you how to run &tdevelop; if it has been installed in a location other than the &kde; directory. @@ -367,7 +367,7 @@ Once all requirements are met, you are ready to compile and install &kdevelop;. preliminaries - &kdevelop; installation + &tdevelop; installation KDEDIR @@ -426,24 +426,24 @@ If you use the tcsh shell add the following lines: -Compile &kdevelop; +Compile &tdevelop; make - &kdevelop; installation + &tdevelop; installation compiling - &kdevelop; + &tdevelop; -In the following discussion we assume that you have put your &kdevelop; sources in the ~/trinitysrc/kdevelop directory. +In the following discussion we assume that you have put your &tdevelop; sources in the ~/trinitysrc/tdevelop directory. Special svn Compilation Considerations -In case you use a &kdevelop; snapshot from svn the initial compilation steps depend on whether you just did a complete checkout or only updated the source. +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. @@ -455,7 +455,7 @@ You must initialize the make system after a fresh checkout. - ~/trinitysrc/kdevelop> + ~/trinitysrc/tdevelop> make -f admin/Makefile.common svn-clean @@ -484,7 +484,7 @@ U /some_directory_path/Makefile.am or if you just did a full checkout, you must enter: - ~/trinitysrc/kdevelop> + ~/trinitysrc/tdevelop> make -f Makefile.svn @@ -499,11 +499,11 @@ before you proceed with all of the following steps. Basic <command>make</command> Command Sequence -Once the basic make system is set up you must decide which type of the &kdevelop; system you want to use. This is done in the following configure step which builds the actual Makefiles the make command will use. +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 Makefiles the make command will use. -You may drop the option in the following configure command lines if you want &kdevelop; be installed in the default &kde; directory. See the Some notes on configure options chapter for this. +You may drop the option in the following configure command lines if you want &tdevelop; be installed in the default &kde; directory. See the Some notes on configure options chapter for this. @@ -511,11 +511,11 @@ You may drop the option in the following conf A Debug-Compiled Version -If you want to keep track of what your &kdevelop; application does at run-time you may build a debug-compiled version. Just command configure to do so: +If you want to keep track of what your &tdevelop; application does at run-time you may build a debug-compiled version. Just command configure to do so: - ~/trinitysrc/kdevelop> + ~/trinitysrc/tdevelop> ./configure --enable-debug=full --prefix=(where-your-trinity-is) @@ -524,64 +524,64 @@ If you want to keep track of what your &kdevelop; application does at run-time y A Release-Compiled Version -If you only want to use &kdevelop; as-is a (smaller and faster +If you only want to use &tdevelop; as-is a (smaller and faster running) release version suffices. configure defaults to this. - ~/trinitysrc/kdevelop> + ~/trinitysrc/tdevelop> ./configure --prefix=(where-your-trinity-is) -If you want to build your own API documentation for &kdevelop; you must include yet another option in the configure command: +If you want to build your own API documentation for &tdevelop; you must include yet another option in the configure command: - ~/trinitysrc/kdevelop> - ./configure --(options-as-above) \ --with-kdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/kdelibs-apidocs + ~/trinitysrc/tdevelop> + ./configure --(options-as-above) \ --with-tdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/tdelibs-apidocs -Make and Install &kdevelop; +Make and Install &tdevelop; configure will check the system and build some Makefiles according to what it found. The make command will use the main Makefile by default. Thus - ~/trinitysrc/kdevelop> + ~/trinitysrc/tdevelop> make suffices. If necessary, now gain root user rights using the command - ~/trinitysrc/kdevelop> + ~/trinitysrc/tdevelop> su and entering the root password. Then install the application: - ~/trinitysrc/kdevelop> + ~/trinitysrc/tdevelop> make install -That's all. If you installed &kdevelop; in the default &kde; directory you may now run the IDE. Otherwise some additional steps will be necessary as shown in the Non-default installation directory section below. +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 Non-default installation directory section below. - In fact there usually will have been three &kdevelop;-based applications installed: + In fact there usually will have been three &tdevelop;-based applications installed: - The &kdevelop; IDE — this is the place where you will usually work. - The stand-alone &kdevelop; Assistant documentation browser — isolates all the powerful documentation facilities of the &kdevelop; 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. - The &kdevelop; Designer — enhances the &Qt; User Interface Designer by &kde; specific elements and integrates nicely in the &kdevelop; IDE. + The &tdevelop; IDE — this is the place where you will usually work. + 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. + The &tdevelop; Designer — enhances the &Qt; User Interface Designer by &kde; specific elements and integrates nicely in the &tdevelop; IDE. @@ -600,7 +600,7 @@ That's all. If you installed &kdevelop; in the default &kde; directory you may n Non-default Installation Directory - &kdevelop; + &tdevelop; installation non-default directory @@ -611,17 +611,17 @@ That's all. If you installed &kdevelop; in the default &kde; directory you may n kbuildsycoca -By default configure prepares the IDE to be installed in the default &kde; directory. This is necessary because &kdevelop; assumes direct access to some tools and parts which reside there. If want to use your own installation directory, you must tell configure this by the option: +By default configure 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 configure this by the option: - ~/trinitysrc/kdevelop> + ~/trinitysrc/tdevelop> ./configure --prefix=(where-your-trinity-is) -There is a caveat if you do so. You must provide a means for &kdevelop; 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.) +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.) -Call up a shell and have the following commands executed before you start &kdevelop; at the shell prompt. +Call up a shell and have the following commands executed before you start &tdevelop; at the shell prompt. @@ -638,11 +638,11 @@ Call up a shell and have the following commands executed before you start &kdeve kbuildsycoca - (Now start &kdevelop;:) + (Now start &tdevelop;:) ~> - kdevelop + tdevelop @@ -661,7 +661,7 @@ In a tcsh shell you must set the environment variables using: setenv KDEDIRS /usr/local/kde:/opt/trinity -The kbuildsycoca command (build system control cache) looks around for libraries and caches their location and version, so that &kdevelop; 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 &kdevelop; from a non-default directory. You may want to put the above commands into a shell script to reduce the typing effort. +The kbuildsycoca command (build system control cache) 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. (You could as well put the lines in your .bashrc or .cshrc file, but this is not advisable as kbuildsycoca will then be run any time you call up the shell.) @@ -679,56 +679,56 @@ The kbuildsycoca command does not run from within the root. Y -How to Obtain a &kdevelop; API Documentation +How to Obtain a &tdevelop; API Documentation API - &kdevelop; + &tdevelop; - &kdevelop; + &tdevelop; API compiling - &kdevelop; + &tdevelop; API configure - &kdevelop; API + &tdevelop; API API is the short form of Application Program Interface. 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. -There is a version of the most current API available at the KDevelop-Home website. It will be automatically updated every 24 hours so you can keep up. +There is a version of the most current API available at the KDevelop-Home website. It will be automatically updated every 24 hours so you can keep up. -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 &kdevelop; 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 in the configure command when you prepare to compile the &kdevelop; sources: +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 in the configure command when you prepare to compile the &tdevelop; sources: - ~/trinitysrc/kdevelop> + ~/trinitysrc/tdevelop> ./configure --(options-as-usual) \ - --with-kdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/kdelibs-apidocs + --with-tdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/tdelibs-apidocs -(make will replace the global $KDEDIR variable with the actual &kde; directory setting recorded therein.) Then issue a make command as usual. After the &kdevelop; IDE has been built you have the option to build the API as well. For this you must issue +(make will replace the global $KDEDIR variable with the actual &kde; directory setting recorded therein.) Then issue a make command as usual. After the &tdevelop; IDE has been built you have the option to build the API as well. For this you must issue - ~/trinitysrc/kdevelop> + ~/trinitysrc/tdevelop> make apidocs -This will build a Doxyfile in your &kdevelop; base directory which in turn will be processed by the Doxygen application to build quite a lot of .html 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 &kdevelop; IDE itself. If necessary obtain superuser rights by +This will build a Doxyfile in your &tdevelop; base directory which in turn will be processed by the Doxygen application to build quite a lot of .html 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 - ~/trinitysrc/kdevelop> + ~/trinitysrc/tdevelop> su @@ -737,18 +737,18 @@ and entering the root password. Then install the API files: - ~/trinitysrc/kdevelop> + ~/trinitysrc/tdevelop> make install-apidox -Once this is done, make 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 &kdevelop;, in case you have set up the &kdevelop; sources themselves as a project to work on. +Once this is done, make 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. -You will most probably see a lot of warning and/or error messages during the API build run by Doxygen. It is best to ignore them, they are of interest to the &kdevelop; developers only. If the API generation ever comes to a successful end, the .html API files will be usable. +You will most probably see a lot of warning and/or error messages during the API build run by Doxygen. 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 .html API files will be usable. - + -- cgit v1.2.3