You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
256 lines
9.2 KiB
256 lines
9.2 KiB
# --- 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 <pattern>" to enable packages
|
|
Use "O <pattern>" to disable packages
|
|
Use "- <pattern>" 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.
|
|
|
|
|