KDE SRC Build manual

• 1. Introduction
  • 1.1. A brief introduction to kdesrc-build
    • 1.1.1. What is kdesrc-build?
    • 1.1.2. kdesrc-build operation “in a nutshell”
  • 1.2. Documentation Overview
• 2. Getting Started
  • 2.1. Preparing the System to Build KDE
    • 2.1.1. Setup a new user account
    • 2.1.2. Ensure your system is ready to build KDE software
    • 2.1.3. Setup kdesrc-build
      • 2.1.3.1. Install kdesrc-build
      • 2.1.3.2. Prepare the configuration file
        • 2.1.3.2.1. Manual setup of configuration file
  • 2.2. Setting the Configuration Data
  • 2.3. Using the kdesrc-build script
    • 2.3.1. Loading project metadata
    • 2.3.2. Previewing what will happen when kdesrc-build runs
    • 2.3.3. Resolving build failures
  • 2.4. Building specific modules
  • 2.5. Setting the Environment to Run Your KDE Plasma Desktop
    • 2.5.1. Automatically installing a login driver
      • 2.5.1.1. Adding xsession support for distributions
      • 2.5.1.2. Manually adding support for xsession
    • 2.5.2. Setting up the environment manually
  • 2.6. Module Organization and selection
    • 2.6.1. KDE Software Organization
    • 2.6.2. Selecting modules to build
    • 2.6.3. Module Sets
      • 2.6.3.1. The basic module set concept
      • 2.6.3.2. Special Support for KDE module sets
    • 2.6.4. The official KDE module database
    • 2.6.5. Filtering out KDE project modules
  • 2.7. Getting Started Conclusion
• 3. Script Features
  • 3.1. Feature Overview
  • 3.2. kdesrc-build's build logging
    • 3.2.1. Logging overview
      • 3.2.1.1. Logging directory layout
• 4. Configuring kdesrc-build
  • 4.1. Overview of kdesrc-build configuration
    • 4.1.1. Layout of the configuration file
      • 4.1.1.1. Global configuration
      • 4.1.1.2. Module configuration
      • 4.1.1.3. Processing of option values
      • 4.1.1.4. “options” modules
    • 4.1.2. Including other configuration files
    • 4.1.3. Commonly used configuration options
  • 4.2. Table of available configuration options
    • 4.2.1. Global scope only options
    • 4.2.2. All scopes (module, module-set and global) options
    • 4.2.3. Phase selection options
    • 4.2.4. Modules selection options
• 5. Command Line Options and Environment Variables
  • 5.1. Command Line Usage
    • 5.1.1. Specifying modules to build
    • 5.1.2. Commonly used command line options
  • 5.2. Supported Environment Variables
  • 5.3. Supported command-line parameters
    • 5.3.1. Generic
    • 5.3.2. Resuming and stopping
    • 5.3.3. Modules information
    • 5.3.4. Exclude specific action
    • 5.3.5. Only specific action
    • 5.3.6. Build behavior
    • 5.3.7. Script runtime
    • 5.3.8. Setup
    • 5.3.9. Verbosity level
    • 5.3.10. Script information
• 6. Using kdesrc-build
  • 6.1. Preface
  • 6.2. Basic kdesrc-build features
    • 6.2.1. qt support
    • 6.2.2. Standard flags added by kdesrc-build
    • 6.2.3. Changing kdesrc-build's build priority
    • 6.2.4. Installation as the superuser
    • 6.2.5. Showing the progress of a module build
  • 6.3. Advanced features
    • 6.3.1. Partially building a module
      • 6.3.1.1. Removing directories from a build
    • 6.3.2. Branching and tagging support for kdesrc-build
      • 6.3.2.1. What are branches and tags?
      • 6.3.2.2. How to use branches and tags
    • 6.3.3. Stopping the build early
      • 6.3.3.1. The build normally continues even if failures occur
      • 6.3.3.2. Not stopping early with --no-stop-on-failure
      • 6.3.3.3. Stopping kdesrc-build gracefully when stop-on-failure is false
    • 6.3.4. How kdesrc-build tries to ensure a successful build
      • 6.3.4.1. Automatic rebuilds
      • 6.3.4.2. Manually rebuilding a module
    • 6.3.5. Changing environment variable settings
    • 6.3.6. Resuming builds
      • 6.3.6.1. Resuming a failed or canceled build
      • 6.3.6.2. Ignoring modules in a build
    • 6.3.7. Changing options from the command line
      • 6.3.7.1. Changing global options
      • 6.3.7.2. Changing module options
  • 6.4. Features for KDE developers
    • 6.4.1. SSH Agent checks
  • 6.5. Other kdesrc-build features
    • 6.5.1. Changing the amount of output from kdesrc-build
    • 6.5.2. Color output
    • 6.5.3. Removing unneeded directories after a build
• 7. CMake, the KDE build system
  • 7.1. Introduction to CMake
• 8. Credits And License
• 9. KDE modules and source code organization
  • 9.1. The “Module”
    • 9.1.1. Individual modules
    • 9.1.2. Groups of related modules
    • 9.1.3. Module “branch groups”
• 10. Superseded profile setup procedures
  • 10.1. Setting up a KDE login profile
    • 10.1.1. Changing your startup profile settings
    • 10.1.2. Starting KDE

manual