# --- SDE-COPYRIGHT-NOTE-BEGIN --- # This copyright note is auto-generated by ./scripts/Create-CopyPatch. # # Filename: lib/sde-config/config.hlp # Copyright (C) 2006 - 2010 The OpenSDE Project # Copyright (C) 2004 - 2006 The T2 SDE Project # Copyright (C) 1998 - 2003 Clifford Wolf # # More information can be found in the files COPYING and README. # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 2 of the License. A copy of the # GNU General Public License can be found in the file COPYING. # --- SDE-COPYRIGHT-NOTE-END --- COMMENT_ARCHCPUOPT In this section you are able to select the architecture, the CPU and whether you are cross-building/porting to another architecture. COMMENT_TARGET In this section you can select which distribution target you would like to use. COMMENT_LICENSE This distribution may contain software that is not publicly distributable. Please check the following to testify that you are aware of this fact. SDECFG_LICENSE_ISSUE The user of the Open System Development Environment (OpenSDE) is responsible for himself to verify that packages that carry a limitation for re-distribution are not redistributed in any form (e.g. ISOs). The developers of the OpenSDE deny any responsibility for mis-use of these packages. COMMENT_BUILD_SYS_CONF Here you can set some basic options for our beautifull distribution build system. SDECFG_ARCH This options controls the target architecture like alpha, ia64, mips, ppc, sparc or x86. SDECFG_CROSSBUILD This option needs to be selected to perform a cross-build to another architecture. SDECFG_TARGET Please select the Target you want to build. SDECFG_PARALLEL_MAX This option specifes the amount of parallel build jobs that are tried to be kept active. This option is used by make and scons - and should also be defined when you use distcc to perform distributed builds. SDECFG_CONTINUE_ON_ERROR_AFTER The build will continue after a package build error only on an stage greater than the value selected SDECFG_RETRY_BROKEN This options controls whether the Build-System should try to build a package that has not built flawlessly during the last build. SDECFG_ALWAYS_CLEAN When a package built flawlessly then the temporary directory which was used for building is deleted. Select this options if you also want this cleanup for packages with build error. (This safes disk-space but makes debugging hard ...) SDECFG_XTRACE Please check here if you want additional (debug)-output in the build log-files. SDECFG_SRC_TMPFS Check here if you want package builds to use tmpfs instead of the regular filesystem. SDECFG_SRC_TMPFS_OPT Please enter the tmpfs mount options here. For example: size=800M,nr_inodes=100k will mount an 800 Megabyte tmp-filesystem with 100,000 inodes. size=4G,nr_inodes=500k will mount a 4 Gigabyte tmp-filesystem with 500,000 inodes. Please make sure that the filesystem is big enough to hold - package-sources (unpacked) - compile-time binaries - and the binary package The filesystem size also must not be so big as to hog all your RAM or else your system might crash or start swapping. SDECFG_SRC_TMPFS_LOG Please enter the path to the tmpfs-logfile. SDECFG_EXPERT This button will enable a lot of additional configuration options. Some of these will make small changes to what the system will look like while others will have a huge impact on performance, stability and usability of the final system. Don't touch these if you don't know what you are doing. YOU HAVE BEEN WARNED! SDECFG_PKGFILE_TYPE The option allows to control the binary package format to be created. The default is to create an ordenary .tar.bz2 - but tar.gz or .gem are also among the options. SDECFG_PKGFILE_VER If selected the package version number will be added to the binary package filenme. SDECFG_PKGSEL If selected you can modify the package list for the build. MENU_PKGSEL_RULES Here you can modify the package list for the build. You have the choice between enable, disable or complete removal. A disabled package can still be reenabled by a target, while a removed one can not be selected by a target. Use "X " to enable packages Use "O " to disable packages Use "- " to remove packages For example: "- gnome*" will not build Gnome at all. SDECFG_SHOW_PKGLIST This will display the complete, current package list. SDECFG_CONFOPT_FILE:0 Here you can specify additional parameters passed to every ./configure script. Use "--with-option" to enable a feature Use "--without-option" to disable a feature Use "--option[=value]" to specify a custom option The Build-Syste will always check whether the configure script supports the options before the options is really passed as argument. COMMENT_FLIST Please see the help for the choice-menu. SDECFG_FLIST This help is taken from Rolling ROCK Issue #2 2003 and updated for OpenSDE. The build scripts of OpenSDE auto-detect which files are created by a package build and use this information to create the package file-list. There are three techniques which can be used to auto-detect this file list: * flist-wrapper The flist-wrapper is the recommended way of doing it. It's an "elf preload library". This is a library which is loaded _before_ the c-library and so can overwrite functions of the c library. The flist-wrapper lib is overwriting all functions which can be used to create files and is writing the filenames to a log file before running the original c library function. This log file is used to create the package file list after the build has been completed. The problem with the flist-wrapper lib is that it doesn't work with statically built binaries or with non glibc c libraries. In such environments (e.g. when building a dietlibc based system), other techniques - such as those described below - must be used for creating the file list. * strace This one is rather easy: The whole build is running in a process- tree which is monitored by strace. The log file created by strace is later used to create the package file list. However: this does only work on architectures which do have an strace command - which is not the case for all architectures the Linux kernel and glibc have been ported to. * find This one is rather ugly (but sometimes the only alternative): When the build is started, a 'timestamp-file' is created. After the build has been completed, the find program is used to find all files which are newer than the 'timestamp-file'. This is really slow now and has the disadvantage that nothing else than the build process may create or modify files while the build is running. This should only be used if no other system for creating the file list can be used. SDECFG_USE_CROSSCC This option controls whether to bootstrap a new, clean and up-to-date toolchain to bootstrap the target system - even for native (non cross) builds. This is needed when the host and target compiler or C library differ in the ABI. THIS IS STRONGLY RECOMMENDED! SDECFG_DO_REBUILD_STAGE This options controls whether to rebuild all packages in the final rebuild-stage. Each and every package is rebuilt in Stage 9 once more and only then are the binary-packages created. This has the advantage that circular dependencies are resolved, but it also almost doubles the build time. In former times this was recommended - but nowadays this is only a paranoia thing. SDECFG_DO_CHECK This options enables to run a make check / test target for packages with support for this. This can be used as extended quality assurance to make sure the resulting binaries work correct. SDECFG_OPT With this option, the type of optimisation can be selected. SDECFG_DEBUG Enable this option if you want to have debug symbols in your binaries. SDECFG_LIMITCXX Check here if you want to disable the C++ exceptions run-time type identification. This can make the C++ binaries about 25% smaller, but any C++ sources using exceptions or rtti, for example QT/KDE, will fail to compile. If you don't know, don't touch. SDECFG_MULTILIB Enable installing several versions of the same library. SDECFG_LD_AS_NEEDED Enabling this option will instruct the linker to only mark the shared objections as needed in the relevant ELF section that are referenced by the executable generated. This does often reduce the dependencies of a binary quite a lot and can help speeding up application start up time. Currently this feature is considered expermental and thus disabled by default. SDECFG_DISABLE_NLS Please check here if you do not want to use Native Language Support. SDECFG_CREATE_CACHE Please check here if you want to create *.cache files after a build has completed. This is the same as a reference build. SDECFG_PARANOIA_CHECK Please check here if you want to run sanity checks before building. THIS IS STRONGLY RECOMMENDED! SDECFG_IDCKSUM Please check here if you want to use a checksum instead of the long explanatory SDECFG-ID.