From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1QLjpn-0001d0-S2 for garchives@archives.gentoo.org; Sun, 15 May 2011 22:30:48 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 440EA1C0E2; Sun, 15 May 2011 22:30:40 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id E12861C0E2 for ; Sun, 15 May 2011 22:30:39 +0000 (UTC) Received: from pelican.gentoo.org (unknown [66.219.59.40]) (using TLSv1 with cipher ADH-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 58FC11B4022 for ; Sun, 15 May 2011 22:30:39 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by pelican.gentoo.org (Postfix) with ESMTP id 7D96980504 for ; Sun, 15 May 2011 22:30:38 +0000 (UTC) From: "Zac Medico" To: gentoo-commits@lists.gentoo.org Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Zac Medico" Message-ID: <2b02757d04b9a36e9750f5d5008ae4cf6ce82e6f.zmedico@gentoo> Subject: [gentoo-commits] proj/portage:master commit in: / X-VCS-Repository: proj/portage X-VCS-Files: make.conf.txt X-VCS-Directories: / X-VCS-Committer: zmedico X-VCS-Committer-Name: Zac Medico X-VCS-Revision: 2b02757d04b9a36e9750f5d5008ae4cf6ce82e6f Date: Sun, 15 May 2011 22:30:38 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: quoted-printable X-Archives-Salt: X-Archives-Hash: ed4df937ca9ca8b89559ab21adc1a1b9 commit: 2b02757d04b9a36e9750f5d5008ae4cf6ce82e6f Author: Zac Medico gentoo org> AuthorDate: Sun May 15 22:29:15 2011 +0000 Commit: Zac Medico gentoo org> CommitDate: Sun May 15 22:29:15 2011 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=3Dproj/portage.git;a= =3Dcommit;h=3D2b02757d make.conf.txt: remove because unused/unmaintained --- make.conf.txt | 719 ---------------------------------------------------= ------ 1 files changed, 0 insertions(+), 719 deletions(-) diff --git a/make.conf.txt b/make.conf.txt deleted file mode 100644 index beb4b0c..0000000 --- a/make.conf.txt +++ /dev/null @@ -1,719 +0,0 @@ -make.conf -********* - -Available make.conf settings for portage - -SYNOPSIS -=3D=3D=3D=3D=3D=3D=3D=3D - -/etc/make.conf - -DESCRIPTION -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D - -This file contains various variables that are used by Portage. -Portage will check the currently-defined environment variables -first for any settings. If no environment settings are found, -Portage then checks /etc/make.conf. If no setting is found -in /etc/make.conf, Portage checks the profile's default setting -from /etc/make.profile/make.defaults. If no setting is found there,=20 -it finally checks make.globals. -Please note that all user -settings should be made in the environment or in /etc/make.conf, -which is intended to be customized by the user. - -VARIABLES -=3D=3D=3D=3D=3D=3D=3D=3D=3D - -ACCEPT_KEYWORDS ---------------- - -:suggest: |accept_keywords| -:valdesc: space delimited list of KEYWORDS - -Enable testing of ebuilds that have not yet been deemed 'stable'. Users -of the 'x86' architecture would set this to '~x86' while ppc users would -set this to '~ppc'. This is an incremental variable. - -CCACHE_DIR ----------- - -:suggest: ${PORTAGE_TMPDIR}/ccache -:valdesc: path - -Defines the location of the ccache working directory. See the ccache(1) = man=20 -page for more information. - -CCACHE_SIZE ------------ - -:valdesc: size - -This controls the space use limitations for ccache. The default is 2 gi= gabytes=20 -('2G'). Sizes are specified with 'G', 'M', or 'K'. - -CFLAGS ------- - -:suggest: |cflags| -:valdesc: valid gcc flags, see gcc manual - -Use these variables to set the desired optimization/CPU instruction sett= ings -for applications that you compile. Nearly all ebuild files will take ad= vantage -of your custom settings, resulting in a Gentoo Linux that is fully custo= mized -to your specifications. Please use sane settings as some packages will = fail to -compile/run if the optimizations are too extreme. - -CXXFLAGS --------- - -:suggest: ${CFLAGS} -:valdesc: valid gcc flags, see gcc manual - -`CFLAGS`_ - -CHOST ------ - -:suggest: |chost| - -This variable is passed by the ebuild scripts to the configure step as=20 ---host=3D${CHOST}. This way you can force the build-host. - -CLEAN_DELAY ------------ - -:default: 5 -:valdesc: integer - -Determines how long the countdown delay will be for unmerge operations (= including=20 -autoclean). - -COLLISION_IGNORE ----------------- - -:valdesc: space delimited list of files and/or directories - -This variable allows the user to disable `collision-protect`_ for specif= ic files=20 -and/or directories. - -CONFIG_PROTECT --------------- - -:default: /etc -:valdesc: space delimited list of files and/or directories - -All files and/or directories that are defined here will have "config= file=20 -protection" enabled for them (unless overridden by _`CONFIG_PROTECT_MASK= `). - -CONFIG_PROTECT_MASK -------------------- - -:default: /etc/env.d -:valdesc: space delimited list of files and/or directories - -All files and/or directories that are defined here will have "config= file=20 -protection" disabled for them. - -DISTCC_DIR ----------- - -:suggest: ${PORTAGE_TMPDIR}/.distcc -:valdesc: path - -Defines the location of the distcc working directory. See the distcc(1) = man=20 -page for more information. - -DISTDIR -------- - -:default: |portdir|/distfiles -:valdesc: path - -Defines the location of your local source file repository. - -EBEEP_IGNORE ------------- - -Defines whether or not to ignore audible beeps when displaying important= =20 -informational messages. This variable is unset by default. - -EMERGE_DEFAULT_OPTS -------------------- - -:valdesc: emerge options - -Options to append to the end of the emerge(1) command line on every inv= ocation. -These options will not be appended to the command line if --ignore-defau= lt-opts=20 -is specified. - -EPAUSE_IGNORE -------------- - -Defines whether or not to ignore short pauses that occur when displaying= =20 -important informational messages. This variable is unset by default. - -FEATURES --------- - -:default: sandbox distlocks metadata-transfer -:suggest: userpriv usersandbox -:valdesc: space separated list of feature flags - -Various settings affecting portage behavior. Don't disable the defaults = without -a good reason. This is an incremental variable. It can take a combinatio= n of the -following flags: - -_`assume-digests` - When commiting work to cvs with repoman(1), assume that all existing SR= C_URI=20 - digests are correct. This feature also affects digest generation via=20 - ebuild(1) and emerge(1) (emerge generates digests only when the digest=20 - feature is enabled). - -_`buildpkg` - Binary packages will be created for all packages that are merged. - -_`buildsyspkg` - Build binary packages for just packages in the system set. - -_`ccache` - Enable portage support for the ccache package. If ${CCACHE_DIR} is not= set=20 - in the users environment, then portage will default to ${PORTAGE_TMPDI= R}/ccache=20 - (with userpriv) and to /root/.ccache otherwise. - -_`collision-protect` - A QA-feature to ensure that a package doesn't overwrite files it doesn'= t own. - The `COLLISION_IGNORE`_ variable can be used to selectively disable thi= s feature. - -_`digest` - Autogenerate digests for packages when running the emerge(1) command. I= f - the `assume-digests`_ feature is also enabled then existing SRC_URI dig= ests - will be reused whenever they are available. - -_`distcc` - Enable portage support for the distcc package. - -_`distlocks` - Portage uses lockfiles to ensure competing instances don't clobber - each other's files. This feature is enabled by default but may cause - heartache on less intelligent remote filesystems like NFSv2 and some - strangely configured Samba server (oplocks off, NFS re\-export). A tool - /usr/lib/portage/bin/clean_locks exists to help handle lock issues - when a problem arises (normally due to a crash or disconnect). - -_`fixpackages` - Updates dependencies in binary packages to match the current tree, for=20 - example after package moves. This can take a ot of time if you have man= y - binary packages in `PKGDIR`_. - -_`getbinpkg` - Force emerges to always try to fetch files from the `PORTAGE_BINHOST`_. - -_`installsources` - Install source code into /usr/src/debug/${CATEGORY}/${PF} (also see - `splitdebug`_). This feature works only if debugedit is installed. - -_`keeptemp` - Do not delete the temporary ebuild directory ${T} after the merge proce= ss. - -_`keepwork` - Do not delete the build directory ${WORKDIR} after the merge process. T= his - may occupy a lot of diskspace. - -_`metadata-transfer` - Automatically perform a metadata transfer when emerge --sync is run. - -_`mirror` - This will cause `FETCHCOMMAND`_ to always be run even if the file alrea= dy=20 - exists in `DISTDIR`_. - -_`noauto` - When utilizing ebuild(1), only run the requested function. - -_`noclean` - Do no delete the source and temporary files after the merge process. - -_`nodoc` - Do not install documentation files in /usr/share/doc. - -_`noinfo` - Do not install info pages. - -_`noman` - Do not install manpages. - -_`nostrip` - Prevents the stripping of binaries that are merged to the live filesyst= em. - -_`notitles` - Disables xterm titlebar updates (which contains status info). - -_`parallel-fetch` - Fetch in the background while compiling. - -_`sandbox` - Use sys-apps/sandbox when building packages to protect the live filesys= tem. - -_`sfperms` - Stands for Smart Filesystem Permissions. Before merging packages to the - live filesystem, automatically search for and set permissions on setuid - and setgid files. Files that are setuid have the group and other read - bits removed while files that are setgid have the other read bit remove= d. - See also `suidctl`_ below. - -_`sign` - When commiting work to cvs with repoman(1), sign the Manifest with=20 - a GPG key. Read about the `PORTAGE_GPG_KEY`_ variable. - -_`splitdebug` - Prior to stripping ELF etdyn and etexec files, the debugging info is=20 - stored for later use by debuggers. This feature is disabled by - `nostrip`_. For installation of source code, see `installsources`_. - -_`strict` - Have portage react strongly to conditions that have the potential to be= =20 - dangerous (like missing or incorrect Manifests entries). - -_`stricter` - Have portage react strongly to conditions that may conflict with system - security provisions (for example textrels, executable stack). Read abou= t - the `QA_STRICT`_ variables below. - -_`suidctl` - Before merging packages to the live filesystem, automatically strip set= uid=20 - bits from any file that is not listed in /etc/portage/suidctl.conf. - -_`test` - Run package-specific tests during each merge to help make sure=20 - the package compiled properly. See *test* in ebuild(1)=20 - and *src_test()* in ebuild(5). - -_`userfetch` - When portage is run as root, drop privileges to portage:portage during = the - fetching of package sources. - -_`userpriv` - Allow portage to drop root privileges and compile packages as=20 - portage:portage without `sandbox`_ (unless `usersandbox`_ is also used)= . - -_`usersandbox` - Enable the sandbox in the compile phase, when running without root priv= s=20 - (`userpriv`_). - -FETCHCOMMAND ------------- - -:default: /usr/bin/wget -t 5 -T 60 --passive-ftp -P \${DISTDIR} \${URI} -:suggest: /usr/bin/wget -t 5 -T 60 --passive-ftp --limit-rate=3D200k \${= URI} -P \${DISTDIR} - -This variable contains the command used for fetching package sources fro= m -the internet. It must contain the full path to the executable as well as= the -place-holders \${DISTDIR} and \${URI}. - -GENTOO_MIRRORS --------------- - -:default: http://distfiles.gentoo.org http://distro.ibiblio.org/pub/linu= x/distributions/gentoo -:valdesc: space separated list of mirror locations - -Insert your space-separated list of local mirrors here. These locations = are=20 -used to download files before the ones listed in the ebuild scripts. Mer= ging=20 -'app-portage/mirrorselect' can help to select an appropriate mirror. - -INSTALL_MASK ------------- - -:valdesc: space delimited list of file names - -Use this variable if you want to selectively prevent certain files from = being -copied into your file system tree. This does not work on symlinks, but = only on -actual files. Useful if you wish to filter out files like HACKING.gz an= d -TODO.gz. - -MAKEOPTS --------- - -:suggest: -j2 -:valdesc: make options - -Use this variable if you want to use parallel make. For example, if you -have a dual-processor system, set this variable to "-j2" or "-j3" for=20 -enhanced build performance with many packages. Suggested settings are -between CPUs+1 and 2*CPUs+1. For more information, see make(1). - -NOCOLOR -------- - -:default: false -:valdesc: true | false - -Defines if color should be disabled (this is overridden by CLI options). - -PKGDIR ------- - -:default: |portdir|/packages -:valdesc: path - -Defines the location where created .tbz2 binary packages will be stored. - -PORT_LOGDIR ------------ - -:suggest: /var/log/portage -:valdesc: path - -This variable defines the directory in which per-ebuild logs are kept. -Logs are created only when this is set and writable. - -PORTAGE_BINHOST ---------------- - -:suggest: ftp://login:pass@grp.mirror.site/pub/grp/i686/athlon-xp -:valdesc: URI to a binary package server - -This is the host from which portage will grab prebuilt-binary packages. -The list is a single entry specifying the full address of the directory=20 -serving the tbz2's for your system. This is only used when running with= =20 -the get binary pkg options are given to emerge. Review emerge(1)=20 -for more information. Note that it should point to the 'All' directory = on=20 -the host that creates the binary packages and not to the root of the `PK= GDIR`_. - -PORTAGE_ELOG_CLASSES --------------------- - -:default: log warn error -:valdesc: space separated list of logging levels - -This variable defines which ebuild messages should be logged by the elog= =20 -subsystem. Possible values are info, log, warn and error. - -PORTAGE_ELOG_SYSTEM -------------------- - -:suggest: save mail -:valdesc: space separated list of elog handlers - -Selects which elog message handlers are invoked by portage to deliver me= ssages -captured by elog. If no handler is specified logging is effectively disa= bled. -Default handlers (other packages may contain additional handlers) are: - -save - saves one logfile per package in ${PORT_LOGDIR}/elog, /var/log/portage/= elog=20 - if `PORT_LOGDIR`_ is unset - -custom - passes all messages to `PORTAGE_ELOG_COMMAND`_ - -syslog - sends all messages to syslog - -mail - sends all messages to the address configured in `PORTAGE_ELOG_MAILURI`_ - -PORTAGE_ELOG_COMMAND --------------------- - -:suggest: /path/to/logprocessor -p '\${PACKAGE}' -f '\${LOGFILE}' - -Only used with the "custom" logging module. Specifies a command -to process log messages. Two variables are expanded: - -${PACKAGE} - expands to the cpv entry of the processed package (see PVR in ebuild(5)= ) - -${LOGFILE} - absolute path to the logfile - -Both variables have to be quoted with single quotes - -PORTAGE_ELOG_MAILURI --------------------- - -:default: root -:suggest: user@some.domain mail.some.domain - -This variable holds all important settings for the mail module. In most = cases=20 -listing the recipient address andthe receiving mailserver should be suff= icient, -but you can also use advanced settings like authentication or TLS. The f= ull=20 -syntax is: -``address [[user:passwd@]mailserver[:port]]`` -where - -address - recipient address - -user - username for smtp auth (defaults to none) - -passwd - password for smtp auth (defaults to none) - -mailserver - SMTP server that should be used to deliver the mail (defaults to localh= ost). - Alternatively this can also be a the path to a sendmail binary if you d= on't - want to use SMTP (e.g. if you only need local delivery to a mbox). - -port - port to use on the given SMTP server (defaults to 25, values > 100000=20 - indicate that starttls should be used on (port-100000)) - -PORTAGE_ELOG_MAILFROM ---------------------- - -:default: portage -:suggest: portage@some.domain -:valdesc: sender address - -You can set the from-address of logmails with this variable, if unset ma= ils=20 -are sent by "portage" (this default may fail in some environments). - -PORTAGE_ELOG_MAILSUBJECT ------------------------- - -:default: [portage] ebuild log for \${PACKAGE} on \${HOST} -:suggest: package \${PACKAGE} merged on \${HOST} with notice -:valdesc: mail subject template - -Template string to be used as subject for logmails. The following variab= les=20 -are exanded: - -${PACKAGE} - see description of `PORTAGE_ELOG_COMMAND`_ - -${HOST} - FQDN of the host portage is running on - -PORTAGE_GPG_KEY ---------------- - -:valdesc: GPG key id - -This variable tells repoman which GPG key to use for signing Manifests. - -PORTAGE_NICENESS ----------------- - -:suggest: 3 -:valdesc: integer - -The value of this variable will be added to the current nice level that=20 -emerge is running at. In other words, this will not set the nice level,=20 -it will increment it. For more information about nice levels and what=20 -are acceptable ranges, see nice(1). - -PORTAGE_RSYNC_EXTRA_OPTS ------------------------- - -:suggest: --exclude=3D/etc/portage/rsync_exclude -:valdesc: rsync options - -Additional rsync options to be used by emerge --sync. - -PORTAGE_RSYNC_OPTS ------------------- - -:default: --recursive --links --safe-links --perms --times --compress --= force --whole-file --delete --delete-after --stats --timeout=3D180 --excl= ude=3D/distfiles --exclude=3D/local --exclude=3D/packages -:valdesc: rsync options - -Default rsync options to be used by emerge --sync. **Don't change this u= nless -you know exactly what you're doing!** - -PORTAGE_RSYNC_RETRIES ---------------------- - -:default: -1 -:valdesc: integer - -The number of times rsync should retry on failed connections before givi= ng up. - -PORTAGE_TMPDIR --------------- - -:default: /var/tmp -:valdesc: path - -Defines the location of the temporary build directories. - -PORTDIR -------- - -:default: |portdir| -:valdesc: path - -Defines the location of your Portage tree. - -PORTDIR_OVERLAY ---------------- - -:suggest: |portdir|/local -:valdesc: space separated list of overlay paths - -Defines the directories in which user made ebuilds are be stored. - -RESUMECOMMAND -------------- - -:default: /usr/bin/wget -c -t 5 -T 60 --passive-ftp -P \${DISTDIR} \${UR= I} -:suggest: /usr/bin/wget -c -t 5 -T 60 --passive-ftp --limit-rate=3D200k = \${URI} -P \${DISTDIR} - -This variable contains the command used for resuming package sources tha= t -have been partially downloaded. It should be defined using the same form= at -as `FETCHCOMMAND`_. - -.. _QA_STRICT: - -QA_STRICT_EXECSTACK -------------------- - -:suggest: set - -Set this to instruct portage to ignore any QA_EXECSTACK override setting= s from -ebuilds. See also ebuild(5). - -QA_STRICT_WX_LOAD ------------------ - -:suggest: set - -Set this to instruct portage to ignore any QA_WX_LOAD override settings = from -ebuilds. See also ebuild(5). - -QA_STRICT_TEXTRELS ------------------- - -:suggest: set - -Set this to instruct portage to ignore any QA_TEXTRELS override settings= from -ebuilds. See also ebuild(5). - -ROOT ----- - -:default: / -:valdesc: path - -Use this variable to specify the target root filesystem to be used for m= erging=20 -packages or ebuilds. All RDEPEND and PDEPEND will be installed=20 -into ROOT while all DEPEND will be still be installed into /. =20 -Typically, you should set this setting in the environment rather than in= =20 -/etc/make.conf itself. It's commonly used for creating new build=20 -images. Make sure you use an absolute path. - -RPMDIR ------- - -:default: |portdir|/rpm -:valdesc: path - -Defines the location where created RPM packages will be stored. Note tha= t RPM=20 -support in portage is experimental at best. - -SYNC ----- - -:default: rsync://rsync.gentoo.org/gentoo-portage -:valdesc: URI to a portage tree server (rsync or cvs) - -Insert your preferred rsync mirror here. This rsync server is used to s= ync=20 -the local portage tree when emerge --sync is run. Only one server can be= =20 -specified. - -USE ---- - -:suggest: X gtk gnome -alsa -:valdesc: space delimited list of USE items - -This variable contains options that control the build behavior of severa= l -packages. More information in ebuild(5). Possible USE values -can be found in |portdir|/profiles/use.desc and |portdir|/profiles/use.l= ocal.desc. - -USE_EXPAND ----------- - -:suggest: LINGUAS VIDEO_CARDS -:valdesc: space separated list of variable names - -Any variable listed here will be used to augment `USE`_ by inserting a n= ew flag -for every value in that variable, so USE_EXPAND=3D"FOO" and FOO=3D"bar b= la" results -in USE=3D"foo_bar foo_bla". - -USE_EXPAND_HIDDEN ------------------ - -:valdesc: space separated list of variable names - -Names of `USE_EXPAND`_ variables that should not be shown in the verbose= merge -list output of the emerge(1) command. - -USE_ORDER ---------- - -:default: env:pkg:conf:defaults:pkginternal -:valdesc: colon separated list of portage config layers - -Determines the precedence of layers in the incremental stacking of the U= SE -variable. Precedence decreases from left to right such that env override= s -pkg, pkg overrides conf, and so forth. *Don't change this unless you kno= w what=20 -you're doing!* Available layers are: - -env - USE from the current USE environment variable if it exists - -pkg - Per-package USE from /etc/portage/package.use (see portage(5)) - -conf - USE from make.conf - -defaults - USE from make.defaults and package.use in the profile (see portage(5)) - -pkginternal - USE from ebuild IUSE defaults (flags enabled via a + prefix; see ebuild= (5)) - -REPORTING BUGS -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D - -Please report bugs via http://bugs.gentoo.org/ - -AUTHORS -=3D=3D=3D=3D=3D=3D=3D - -- Daniel Robbins -- Nicholas Jones -- Mike Frysinger -- Saleem Abdulrasool -- Marius Mauch - -FILES -=3D=3D=3D=3D=3D - -/etc/make.conf - Contains user-supplied variables and overwrites those in make.defaults. - -/usr/share/portage/config/make.globals - Contains portage defaults for many variables listed here. Don't change = this, - edit /etc/make.conf instead. - -|portdir|/profiles/use.desc - Contains a list of all global USE flags with brief descriptions. - -|portdir|/profiles/use.local.desc - Contains a list of all local USE variables with brief descriptions. - -SEE ALSO -=3D=3D=3D=3D=3D=3D=3D=3D - -- emerge(1) -- portage(5) -- ebuild(1) -- ebuild(5) - -.. Substitutions: -.. |accept_keywords| replace:: ~x86 -.. |cflags| replace:: -march=3Di686 -O2 -pipe -.. |chost| replace:: i686-gentoo-linux-gnu -.. |portdir| replace:: /usr/portage -