From 4123be718760f8cbfc7ba7100bd0177575946fbf Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Wed, 16 Nov 2011 13:52:50 -0600 Subject: Additional renaming of kde to tde --- doc/scripts/kdesvn-build/index.docbook | 136 ++++++++++++++++----------------- 1 file changed, 68 insertions(+), 68 deletions(-) (limited to 'doc/scripts/kdesvn-build/index.docbook') diff --git a/doc/scripts/kdesvn-build/index.docbook b/doc/scripts/kdesvn-build/index.docbook index e54dbb9b..4ae84648 100644 --- a/doc/scripts/kdesvn-build/index.docbook +++ b/doc/scripts/kdesvn-build/index.docbook @@ -1,17 +1,17 @@ - + + Subversion"> - kdesvn-build"> + tdesvn-build"> ]> -&kdesvn-build; Script Manual +&tdesvn-build; Script Manual @@ -45,12 +45,12 @@ 0.98 -The &kdesvn-build; is a Perl script which builds and installs &kde; directly from the sources found in the &kde; &svn; repository. +The &tdesvn-build; is a Perl script which builds and installs &kde; directly from the sources found in the &kde; &svn; repository. KDE -kdesdk +tdesdk SVN Subversion KDE development @@ -63,18 +63,18 @@ Introduction -&kdesvn-build; is a Perl script to help users install &kde; from &svn;. You may also want to -consider the kde-build script include with &kde;'s kdesdk module. +consider the kde-build script include with &kde;'s tdesdk module. -Here we document the &kdesvn-build; configuration file syntax and options, its +Here we document the &tdesvn-build; configuration file syntax and options, its command line options, features, and an overview of all necessary steps required to build &kde; from source, including the steps which you should perform using other tools, or in other words, steps that are not automatically performed -by the &kdesvn-build; script. +by the &tdesvn-build; script. @@ -83,7 +83,7 @@ by the &kdesvn-build; script. Getting Started -In this chapter, we show how to use the &kdesvn-build; to checkout modules from the +In this chapter, we show how to use the &tdesvn-build; to checkout modules from the &kde; repository and build them. We also provide a basic explanation of the &kde; &svn; structure and the steps you have to perform before running the script. @@ -117,7 +117,7 @@ does not cover a root installation. If you are performing a system wide install, you probably already know what you are doing anyway. -Before using the &kdesvn-build; script (or any other building +Before using the &tdesvn-build; script (or any other building strategy) you must install the development tools and libraries needed for &kde;. You need the Qt library, version 3.3.0 or greater, Automake 1.8, Autoconf 2.5X (better if >=2.57 as a bug was reported with lower versions), @@ -141,25 +141,25 @@ required software. -You probably already have a version of the &kdesvn-build; script installed -in your system. &kdesvn-build;requires you to create a configuration file, named -.kdesvn-buildrc. This file should be installed on +You probably already have a version of the &tdesvn-build; script installed +in your system. &tdesvn-build;requires you to create a configuration file, named +.tdesvn-buildrc. This file should be installed on the home folder (~/), and contain all configuration data required for the script to run, like configuration options, compiling options, location of the sources, the destination of the installation (prefix), the modules that should be built, &etc;. The default configuration -data is provided by the kdesvn-buildrc-sample file. +data is provided by the tdesvn-buildrc-sample file. You can find more information about the syntax of the configuration file -in and in . +in and in . -A good way to get the latest version is to browse the kdesdk/scripts page +A good way to get the latest version is to browse the tdesdk/scripts page at the websvn.kde.org website. -You will see a list of the files available in the kdesdk/scripts directory in -the &kde; &svn; repository. Click the &kdesvn-build; link and download +You will see a list of the files available in the tdesdk/scripts directory in +the &kde; &svn; repository. Click the &tdesvn-build; link and download the latest version of the script. Do the same for the -kdesvn-buildrc-sample file. +tdesvn-buildrc-sample file. Make the script executable, and be sure it is in your path. @@ -170,12 +170,12 @@ Make the script executable, and be sure it is in your path. To use the script, you must have a file in your home directory called -.kdesvn-buildrc, which sets the general options and sets the modules +.tdesvn-buildrc, which sets the general options and sets the modules you would like to download and build. -Use the kdesvn-buildrc-sample file as a +Use the tdesvn-buildrc-sample file as a template, setting global options, and the modules you want to build. @@ -193,26 +193,26 @@ Pay close attention to the kdedir and qtdir global variables, as the first sets where your &kde; build is going to be installed, (by default to ~/kde), and the second where (and if) your qt library is going to be built and installed, (by default to -~/kdesvn/build/qt-copy). You will need to know the +~/tdesvn/build/qt-copy). You will need to know the kdedir and qtdir location later, to set up the environment variables that are necessary to run your new installation. Check if the listed modules are in fact the modules you want to build. -The default options from the kdesvn-buildrc-sample file +The default options from the tdesvn-buildrc-sample file should be enough to get a fairly complete &kde; installation. -Save the resulting as .kdesvn-buildrc in your home +Save the resulting as .tdesvn-buildrc in your home folder. -If you wish to fine tune your .kdesvn-buildrc, -consult for detailed information +If you wish to fine tune your .tdesvn-buildrc, +consult for detailed information about all configuration options. -Using the &kdesvn-build; script +Using the &tdesvn-build; script Now you are ready to run the script. From a terminal window, @@ -220,7 +220,7 @@ log in to the user you are using to compile &kde; and execute the script: %su devel-username -%kdesvn-build +%tdesvn-build @@ -353,7 +353,7 @@ the stable KDE desktop. Script Features -&kdesvn-build; features include: +&tdesvn-build; features include: @@ -391,7 +391,7 @@ support. Tilde-expansion for your configuration options. For example, you can specify: -qtdir ~/kdesvn/build/qt-copy +qtdir ~/tdesvn/build/qt-copy @@ -415,7 +415,7 @@ you can specify options to apply to individual modules as well. Since the autotools sometimes get out of sync with changes to the source tree, you can force a rebuild of a module by creating a file called .refresh-me in the build directory of the module in question, or by running -&kdesvn-build; with the option. +&tdesvn-build; with the option. @@ -473,7 +473,7 @@ configuration option. -Things that &kdesvn-build; does NOT do: +Things that &tdesvn-build; does NOT do: @@ -496,12 +496,12 @@ The script probably is not bug-free. Sorry. - -The Format of .kdesvn-buildrc + +The Format of .tdesvn-buildrc To use the script, you must have a file in your home directory called -.kdesvn-buildrc, which describes the modules you would +.tdesvn-buildrc, which describes the modules you would like to download and build. @@ -532,7 +532,7 @@ end module module-name must be a module from the &kde; &svn; repository (for -example, kdelibs or kdebase). Some options override global options, some +example, tdelibs or tdebase). Some options override global options, some add to global options, and some global options simply can't be overridden. @@ -553,7 +553,7 @@ authors using the address you can find above. configure-flags to define what flags to configure a module with. cxxflags to define the CXXFLAGS variable. dest-dir to change the directory name for a module. -disable-agent-check, to keep kdesvn-build from checking on ssh-agent's status. +disable-agent-check, to keep tdesvn-build from checking on ssh-agent's status. do-not-compile, to mark directories to skip building. inst-apps, to only build and install some directories. install-after-build, to avoid installing after the build process. @@ -569,7 +569,7 @@ authors using the address you can find above. qtdir, to set the path to Qt. set-env, to set an environment variable. source-dir, to change where to download the source code to. -stop-on-failure, to make kdesvn-build stop as soon as a failure is encountered. +stop-on-failure, to make tdesvn-build stop as soon as a failure is encountered. svn-server, to change the server the sources are downloaded from. use-qt-builddir-hack, to give Qt a separate build directory from its source like KDE. use-unsermake, to use the advanced unsermake build system. @@ -599,10 +599,10 @@ as well. apidox Overrides global -Set this option to true in order to have &kdesvn-build; automatically +Set this option to true in order to have &tdesvn-build; automatically build and install the API documentation for the module after the normal build/install process. This only works for modules where make apidox does something, -including kdelibs, kdebase, and koffice, among others. +including tdelibs, tdebase, and koffice, among others. @@ -638,7 +638,7 @@ KDE 3.4 branch, you would set this option to "3.4". Note that some modules use a different branch name. Notably, the required arts module doesn't go by KDE version numbers. The arts that accompanied KDE 3.4 was version 1.4. -If kdesvn-build fails to properly download a branch with this option, you +If tdesvn-build fails to properly download a branch with this option, you may have to manually specify the URL to download from using the override-url option. @@ -698,8 +698,8 @@ set of configure options than the rest of &kde;, so this option colorful-output Can't be overridden -Set this option to false to disable the colorful output of &kdesvn-build;. -This option defaults to true. Note that &kdesvn-build; won't output the +Set this option to false to disable the colorful output of &tdesvn-build;. +This option defaults to true. Note that &tdesvn-build; won't output the color codes to anything but a terminal (such as xterm, &konsole;, or the normal Linux console). @@ -729,7 +729,7 @@ extragear-network using this option. disable-agent-check Can't be overridden Normally if you're using SSH to download the Subversion sources (such as -if you're using the svn+ssh protocol), kdesvn-build will try and make sure that +if you're using the svn+ssh protocol), tdesvn-build will try and make sure that if you're using ssh-agent, it is actually managing some SSH identities. This is to try and prevent SSH from asking for your passphrase for every module. You can disable this check by setting disable-agent-check to true. @@ -755,7 +755,7 @@ directive to choose directories that you want to check out. email-address Can't be overridden -Set this option to the e-mail address kdesvn-build should send from should +Set this option to the e-mail address tdesvn-build should send from should it ever need to send e-mail. You do not need to worry about this if you don't use any feature which send e-mail. (They are all disabled by default). @@ -771,13 +771,13 @@ needs this option. Can't be overridden You can set this option to the email address to send a report to when a -module fails to build. kdesvn-build will wait until all the modules are done +module fails to build. tdesvn-build will wait until all the modules are done and collate all of the results in the report. The report is only sent if a module fails to build. Please see the email-address -option to set the address kdesvn-build should send from, since the default +option to set the address tdesvn-build should send from, since the default is usually not what you want. @@ -887,11 +887,11 @@ option for a module, then you have pretty much commented it out. module-base-path Overrides global -Set this option to override &kdesvn-build;'s default directory path to the +Set this option to override &tdesvn-build;'s default directory path to the module in question. This can be used, for example, to pull specific branches or tagged versions of libraries. The &kde; Source Viewer is invaluable in helping to pick the right path. -Note that &kdesvn-build; constructs the final path according to the +Note that &tdesvn-build; constructs the final path according to the following template: $svn-server/home/kde/$module-base-path/$module-name. @@ -904,25 +904,25 @@ following template: niceness Can't be overridden Set this option to a number between 20 and 0. The higher the number, the -lower a priority &kdesvn-build; will set for itself. The default is 10. +lower a priority &tdesvn-build; will set for itself. The default is 10. no-rebuild-on-fail Overrides global -Set this option value to true to always prevent &kdesvn-build; from trying +Set this option value to true to always prevent &tdesvn-build; from trying to rebuild this module if it should fail an incremental build. Normally -&kdesvn-build; will try to rebuild the module from scratch to counteract the +&tdesvn-build; will try to rebuild the module from scratch to counteract the effect of a stray &svn; update messing up the build system. override-url Overrides global -If you set this option, kdesvn-build will use its value as the URL +If you set this option, tdesvn-build will use its value as the URL to pass to Subversion completely unchanged. You should -generally use this if you want to download a specific release but kdesvn-build +generally use this if you want to download a specific release but tdesvn-build can't figure out what you mean using branch. @@ -957,7 +957,7 @@ installed. Note that using this option can have a significant detrimental impact on both your bandwidth usage (if you use 'all') and the time taken to compile KDE, -since kdesvn-build will be unable to perform incremental builds. +since tdesvn-build will be unable to perform incremental builds. @@ -981,7 +981,7 @@ globally). Can't be overridden This option is used to set the directory on your computer to store the &kde; &svn; sources at. If you don't specify this value, the default is -~/kdesvn. If +~/tdesvn. If you do specify this value, use an absolute path name. @@ -1010,7 +1010,7 @@ by default. to use this option. KDE releases are available in tarball form from The KDE FTP site or one of its mirrors. -If you are using kdesvn-build because you have having trouble getting +If you are using tdesvn-build because you have having trouble getting a KDE release to build on your distribution, consider using the Konstruct build tool instead, which works from the release tarballs. @@ -1023,7 +1023,7 @@ instead, which works from the release tarballs. Although this option overrides the global option, it only makes sense for qt-copy. Set this option to true to enable the script's experimental srcdir != builddir mode. When enabled, -&kdesvn-build; will copy the qt-copy source module to the build directory, +&tdesvn-build; will copy the qt-copy source module to the build directory, and perform builds from there. That means your QTDIR environment variable should be set to $(qt-copy-build-dir)/qt-copy/lib @@ -1046,10 +1046,10 @@ script. This can lead to some serious decreases in build time, especially for systems. This option defaults to true (for most modules). -Normally if you use this option kdesvn-build will automatically keep +Normally if you use this option tdesvn-build will automatically keep unsermake up-to-date. This may start to get annoying, especially if you are managing unsermake yourself. If this is the case, you can set this option to -self, and kdesvn-build will still use unsermake, but will not +self, and tdesvn-build will still use unsermake, but will not do anything special to keep it updated. @@ -1138,7 +1138,7 @@ Only output warnings and errors. -Be very descriptive about what's going on, and what kdesvn-build is doing. +Be very descriptive about what's going on, and what tdesvn-build is doing. @@ -1199,7 +1199,7 @@ verbose about what they're doing in debugging mode. don't try and -rebuild modules that have failed building from scratch. &kdesvn-build; will +rebuild modules that have failed building from scratch. &tdesvn-build; will never try to do this to a module that already was tried to be built from scratch. @@ -1255,7 +1255,7 @@ other module names on the command line. which interprets the next command line parameter as the file to read the configuration options from. The default -value for this parameter is ~/.kdesvn-buildrc. +value for this parameter is ~/.tdesvn-buildrc. @@ -1271,7 +1271,7 @@ This option implies stop after running make Makefile.cvs. The configure -script will still need to be run, which &kdesvn-build; will do next time. This lets you +script will still need to be run, which &tdesvn-build; will do next time. This lets you prepare all the configure scripts at once so you can view the ./configure for each module, and edit your configure-flags accordingly. @@ -1300,8 +1300,8 @@ linkend="conf-log-dir">log-dir option, you would do: You can use this option to override an option in your configuration file for a specific module. For instance, to override the use-unsermake option for kdemultimedia, you -would do: . +linkend="conf-use-unsermake">use-unsermake option for tdemultimedia, you +would do: . -- cgit v1.2.1