Chapter 5. Command Line Options and Environment Variables

This script doesn't use environment variables. If you need to set environment variables for the build or install process, please see the set-env option.

The script accepts the following command-line options:

--help: only display simple help on this script.
--version: display the program version.
--author: display contact information for the author.
--color: enable colorful output.
--no-color: disable colorful output.
--pretend (or -p): don't actually DO anything, but act like you did.
--quiet (or -q): Don't be as noisy with the output. With this switch only the basics are output.
--really-quiet: Only output warnings and errors.
--verbose: Be very descriptive about what's going on, and what kdesvn-build is doing.
--svn-only: only perform the source update.
--build-only: only perform the build process.
--ignore-modules: don't include the modules passed on the rest of the command line in the update/build process.
--no-svn: skip contacting the Subversion server.
--no-build: skip the build process.
--no-install: don't automatically install packages after they're built.
--debug: enables debug mode for the script. Currently this means that all output will be dumped to STDOUT in addition to being logged in the log directory like normal. Also, many functions are much more verbose about what they're doing in debugging mode.
--no-rebuild-on-fail: don't try and rebuild modules that have failed building from scratch. kdesvn-build will never try to do this to a module that already was tried to be built from scratch.
--refresh-build: recreate the build system and make from scratch.
--reconfigure: run the configure script again without cleaning the build directory.
--recreate-configure: run make -f Makefile.cvs again to create the configure script, and continue building as normal. This option implies --reconfigure.
--resume: which tries to continue building from where the script stopped last time. The script starts building the module after the last module to be compiled last time the script was run, whether or not it succeeded. This option implies --no-svn. You should not specify other module names on the command line.
--resume-from: which is like --resume, except that you supply the module to start building from as the next parameter on the command line. This option implies --no-svn. You should not specify other module names on the command line.
--rc-file: 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.
--prefix=</path/to/kde>: which allows you to change the directory that KDE will be installed to from the command line. This option implies --reconfigure.
--build-system-only: stop after running make -f Makefile.cvs. The configure script will still need to be run, which kdesvn-build will do next time. This lets you prepare all the configure scripts at once so you can view the ./configure --help for each module, and edit your configure-flags accordingly.
--install: If this is the only command-line option, it tries to install all of the modules contained in successfully-built, except for qt-copy, which doesn't need installation. If command-line options are specified after --install, they are all assumed to be modules to install.
--<option-name>=: You can use this option to override an option in your configuration file for every module. For instance, to override the log-dir option, you would do: --log-dir=/path/to/dir.
--<module-name>,<option-name>=: 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: --kdemultimedia,use-unsermake=false.

Any other command-line options are assumed to be modules to update and build. Please, don't mix building with installing.