From d2cf40850dab2ee14c85fa680d33590a16bee9eb Mon Sep 17 00:00:00 2001 From: Stefan Fiedler Date: Sat, 3 Nov 2007 09:59:08 +0000 Subject: [PATCH] Stefan Fiedler: some cleanups in Documentation/Developers/PKG-BUILD-VARS [2007082619143230956] (https://www.rocklinux.net/submaster) git-svn-id: http://www.rocklinux.org/svn/rock-linux/trunk@8810 c5f82cb5-29bc-0310-9cd0-bff59a50e3bc --- Documentation/Developers/PKG-BUILD-VARS | 78 +++++++++++++------------ 1 file changed, 41 insertions(+), 37 deletions(-) diff --git a/Documentation/Developers/PKG-BUILD-VARS b/Documentation/Developers/PKG-BUILD-VARS index f3fb7ff46..c9aea980b 100644 --- a/Documentation/Developers/PKG-BUILD-VARS +++ b/Documentation/Developers/PKG-BUILD-VARS @@ -16,7 +16,9 @@ id ............ unique ID for this Build-Pkg invocation arch .......... architecture (subdir name in architecture) target ........ target distribution (subdir name in targets) stagelevel .... stagelevel (0-1 = crossbuild, 2-8 = native, 9 = rebuild) +crossnative ... has the value 'cross' or 'native' +archprefix .... prefix for binutils and compiler binaries (for cross-building) arch_sizeof_long_long .... arch setting from architecture/*/archtest.out arch_sizeof_int .......... arch setting from architecture/*/archtest.out arch_machine ............. arch setting from architecture/*/archtest.out @@ -30,19 +32,19 @@ arch_build ............... like 'arch_target' - but for the build host archdir ....... directory containing the package tar files (download/..) confdir ....... directory containing the package build config (package/..) targetdir ..... directory containing the target config (target/...) -builddir ...... directory in which the package is build (src.$id) -base .......... ROCK Linux sources base directory -root .......... root directory (usually '/') -xroot ......... real root (/R.work/build/... when in chroot mode) -prefix ........ install prefix (usually '/usr' or '/opt/...') -prefix_auto ... '1' = you may auto-detect a better value for $prefix in *.conf +builddir ...... directory in which the package is build (src.$id) +base .......... ROCK Linux sources base directory (/usr/src/rock-src) +xroot ......... real root ($base/build/...) +root .......... root directory (equals $xroot, empty in chroot mode) build_logs .... Big build log file ...... (Build-Target only) -build_pkgs .... Packagefiles go here .... (Build-Target only) +build_pkgs .... Package files go here .... (Build-Target only) build_root .... Chroot dir name ......... (Build-Target only) build_rock .... ROCK build system data .. (Build-Target only) +prefix_auto ... '1' = you may auto-detect a better value for $prefix in *.conf +prefix ........ install prefix (usually '/usr' or '/opt/...') bindir ........ where the binaries (programs) should be installed sbindir ....... where the system binaries should be installed libdir ........ where the library files should be installed @@ -55,41 +57,44 @@ infodir ....... where the info files should be installed includedir .... where the header files should be installed autoextract ... '0' = skip automatic untar -autopatch ..... '0' = skip automatic patching -chownsrcdir ... '0' = don't make a chown to root after extracting the $srctar -desktopfiles .. filenames of the desktop files to install ($confdir/*.desktop) - set to an empty string to deactivate desktop file installation -desktopauto ... '0' = disable automatic changes to .desktop files -nocvsinsrcdir . '0' = don't remove CVS and .svn directories in $srcdir srctar ........ filename of source tar file ('auto' = autodetect) srcdir ........ directory in source tar file ('auto' = autodetect) xsrctar ....... filename of source tar file after 'auto' has been processed xsrcdir ....... directory in source tar file after 'auto' has been processed taropt ........ tar options for extracting +autopatch ..... '0' = skip automatic patching +patchfiles .... list of patchfiles found in $confdir +patchopt ...... options passed to the patch program + +chownsrcdir ... '0' = don't make a chown to root after extracting the $srctar +nocvsinsrcdir . '0' = don't remove CVS and .svn directories in $srcdir createprefix .. '0' = skip creation for directory skeleton for $prefix createdocs .... '0' = skip automatic copying of documentation files autoso2a ...... '1' = automatically create *.a files for all *.so files forcefpic ..... set to '0' to disable the force -fPIC mechanism -custmain ...... command to execute instead of 'configure, make, make install' -mainfunction .. alternate main function instead of build_this_package() +desktopfiles .. filenames of the desktop files to install ($confdir/*.desktop) + set to an empty string to deactivate desktop file installation +desktopauto ... '0' = disable automatic changes to .desktop files + +flistdel ...... regex describing files which shouldn't go to package db +flistrfilter .. regex describing which lines to ignore in flist rlog +flistroot ..... list of top-level directories which should be used for flist + +check_shared ...... Check for files which are shared with other packages +check_usrlocal .... Check for files which are installed in usr/local +check_badfiles .... Check for files which are registered 'bad files' -prepare ....... command to execute before main build-block -prepatch ...... command to execute before automatic patching -patchfiles .... list of patchfiles found in $confdir -postpatch ..... command to execute after automatic patching -patchopt ...... options passed to the patch program -preconf ....... command to execute before running configure -runconf ....... set to '0' if you want to skip running configure autogen ....... set to '1' if you want to run the autogen script automakever ... automake version prefix (e.g. "-1.7") for $autogen + +runconf ....... set to '0' if you want to skip running configure confopt ....... options for GNU autoconf './configure' extraconfopt .. options which should be appended to $confopt by set_confopt() configprefix .. variable declarations only for GNU autoconf './configure' configscript .. script file name of the GNU autoconf configure script configexec .... command for executing $configscript (default=bash) -pyconfopt ..... options for 'setup.py' - Python setup scripts runcmake ...... set to '0' if you want to skip running 'cmake .' cmakesrcdir ... set to path of srcdir when requesting an out-of-source build @@ -97,28 +102,28 @@ cmakedefs ..... options passed to cmake runxmkmf ...... set to '0' if you want to skip running 'xmkmf' runmkpl ....... set to '0' if you want to skip running 'perl Makefile.PL' + runpysetup .... set to '0' if you want to skip running 'python setup.py' +pyconfopt ..... options for 'setup.py' - Python setup scripts -premake ....... command to execute before running 'make' makeopt ....... options for 'make' (default = ' ') -inmake ........ command to execute between 'make' and 'make install' makeinstopt ... options for 'make install' (default = 'install') -postmake ...... command to execute after running 'make install' + +custmain ...... command to execute instead of 'configure, make, make install' +mainfunction .. alternate main function instead of build_this_package() + +prepare ....... command to execute before main build-block +prepatch ...... command to execute before automatic patching +postpatch ..... command to execute after automatic patching +preconf ....... command to execute before running configure +premake ....... command to execute before running 'make' +inmake ........ command to execute between 'make' and 'make install' +postmake ...... command to execute after running 'make install' postflist ..... command to execute after creating the flist postinstall ... command to execute after finishing all the standard stuff finish ........ command to execute after everything else outside build-block -crossnative ... has the value 'cross' or 'native' -archprefix .... prefix for binutils and compiler binaries (for cross-building) - -flistdel ...... regex describing files which shouldn't go to package db -flistrfilter .. regex describing which lines to ignore in flist rlog -flistroot ..... list of top-level directories which should be used for flist - -check_shared ...... Check for files which are shared with other packages -check_usrlocal .... Check for files which are installed in usr/local -check_badfiles .... Check for files which are registered 'bad files' BUILDCC ....... C compiler for helper apps (usually that's just 'cc') BUILD_CC ...... C compiler for helper apps (must be the same as $BUILDCC) @@ -145,4 +150,3 @@ STRIP_WRAPPER_* ... configuration for strip wrapper ROCK_BUILD_TARGET ... set to '1' in Build-Target ROCKCFG_* ........... configuration from 'Config' file -