aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorFabian Groffen <grobian@gentoo.org>2013-09-13 20:01:05 +0200
committerFabian Groffen <grobian@gentoo.org>2013-09-13 20:01:05 +0200
commit2c40532f5b2aedbe9ceaa4c4595fc905773f72a0 (patch)
treea20a30ecf095e1bf42b692527d30a9ccb90e3900 /man
parentemerge-webrsync: remove double shebang (diff)
parentBug #484730: In sync mode, use repos.conf section name when repo_name file is... (diff)
downloadportage-2c40532f5b2aedbe9ceaa4c4595fc905773f72a0.tar.gz
portage-2c40532f5b2aedbe9ceaa4c4595fc905773f72a0.tar.bz2
portage-2c40532f5b2aedbe9ceaa4c4595fc905773f72a0.zip
Merge remote-tracking branch 'overlays-gentoo-org/master' into prefix
Conflicts: bin/ebuild-helpers/unprivileged/chown
Diffstat (limited to 'man')
-rw-r--r--man/make.conf.527
-rw-r--r--man/portage.513
-rw-r--r--man/repoman.19
-rw-r--r--man/ru/ebuild.14
4 files changed, 44 insertions, 9 deletions
diff --git a/man/make.conf.5 b/man/make.conf.5
index 00d822dbf..4bf520d1c 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -1,10 +1,19 @@
-.TH "MAKE.CONF" "5" "Jul 2013" "Portage VERSION" "Portage"
+.TH "MAKE.CONF" "5" "Aug 2013" "Portage VERSION" "Portage"
.SH "NAME"
make.conf \- custom settings for Portage
.SH "SYNOPSIS"
\fB/etc/make.conf\fR and \fB/etc/portage/make.conf\fR
.SH "DESCRIPTION"
-This file contains various variables that are used by Portage.
+
+This file contains various variables that are used by Portage. The file has a
+newline\-delimited list of \fI<key>=<value>\fR pairs (see the default file for
+examples) which are accessible from the environment of ebuilds. It supports
+simple shell\-like expansion of the form \fIvar="${var}"\fR, the source
+keyword and variable substitution, but not some of the more advanced BASH
+features like arrays and special parameter expansions. For more details, see
+the Simple lexical analysis documentation:
+\fLhttp://docs.python.org/3/library/shlex.html\fR.
+.br
Portage will check the currently\-defined environment variables
first for any settings. If no environment settings are found,
Portage then checks the make.conf files. Both /etc/make.conf and
@@ -270,6 +279,10 @@ like "File not recognized: File truncated"), try recompiling the application
with ccache disabled before reporting a bug. Unless you are doing development
work, do not enable ccache.
.TP
+.B cgroup
+Use Linux control group to control processes spawned by ebuilds. This allows
+emerge to safely kill all subprocesses when ebuild phase exits.
+.TP
.B clean\-logs
Enable automatic execution of the command specified by the
PORT_LOGDIR_CLEAN variable. The default PORT_LOGDIR_CLEAN setting will
@@ -379,6 +392,10 @@ would otherwise be useless with prefix configurations. This brings
compatibility with the prefix branch of portage, which also supports EPREFIX
for all EAPIs (for obvious reasons).
.TP
+.B ipc\-sandbox
+Isolate the ebuild phase functions from host IPC namespace. Supported
+only on Linux. Requires network namespace support in kernel.
+.TP
.B lmirror
When \fImirror\fR is enabled in \fBFEATURES\fR, fetch files even
when \fImirror\fR is also in the \fBebuild\fR(5) \fBRESTRICT\fR variable.
@@ -409,6 +426,10 @@ isn't a symlink to /usr/lib64. To find the bad packages, we have a
portage feature called \fImultilib\-strict\fR. It will prevent emerge
from putting 64bit libraries into anything other than (/usr)/lib64.
.TP
+.B network\-sandbox
+Isolate the ebuild phase functions from host network interfaces.
+Supported only on Linux. Requires network namespace support in kernel.
+.TP
.B news
Enable GLEP 42 news support. See
\fIhttp://www.gentoo.org/proj/en/glep/glep-0042.html\fR.
@@ -1091,6 +1112,6 @@ Contains a list of all local USE variables.
.BR ebuild (1),
.BR ebuild (5)
.TP
-The \fI/usr/sbin/ebuild.sh\fR script.
+The \fI/usr/lib/portage/bin/ebuild.sh\fR script.
.TP
The helper apps in \fI/usr/lib/portage/bin\fR.
diff --git a/man/portage.5 b/man/portage.5
index 38c6d8ca3..a57eaf0a1 100644
--- a/man/portage.5
+++ b/man/portage.5
@@ -1,4 +1,4 @@
-.TH "PORTAGE" "5" "Jul 2013" "Portage VERSION" "Portage"
+.TH "PORTAGE" "5" "Aug 2013" "Portage VERSION" "Portage"
.SH NAME
portage \- the heart of Gentoo
.SH "DESCRIPTION"
@@ -679,7 +679,12 @@ single package.
.BR package.env
Per\-package environment variable settings. Entries refer to
environment files that are placed in the \fB/etc/portage/env/\fR
-directory and have the same format as \fBmake.conf\fR(5).
+directory and have the same format as \fBmake.conf\fR(5). Note that these
+files are interpreted much earlier than the package\-specific \fIbashrc\fR
+files which are described in a later section about \fB/etc/portage/env/\fR.
+Beginners should be careful to recognize the difference between these two types
+of files. When environment variable settings are all that's needed,
+\fBpackage.env\fR is the recommended approach to use.
.I Format:
.nf
@@ -935,7 +940,9 @@ needed, then \fB/etc/portage/package.env\fR should be used instead of the
bashrc approach that is described here. Also note that special variables
such as \fBFEATURES\fR and \fBINSTALL_MASK\fR will not produce the intended
results if they are set in bashrc, and therefore
-\fB/etc/portage/package.env\fR should be used instead.
+\fB/etc/portage/package.env\fR should be used instead. Lastly, note that these
+files are interpreted much later than the portage environment file
+\fBpackage.env\fR.
Portage will source all of these bashrc files after \fB/etc/portage/bashrc\fR
in the following order:
diff --git a/man/repoman.1 b/man/repoman.1
index d4ced1dfb..a78f94e90 100644
--- a/man/repoman.1
+++ b/man/repoman.1
@@ -1,4 +1,4 @@
-.TH "REPOMAN" "1" "May 2013" "Portage VERSION" "Portage"
+.TH "REPOMAN" "1" "Aug 2013" "Portage VERSION" "Portage"
.SH NAME
repoman \- Gentoo's program to enforce a minimal level of quality assurance in
packages added to the portage tree
@@ -65,6 +65,10 @@ can be enabled by default for a particular repository by setting
"update\-changelog = true" in metadata/layout.conf (see
\fBportage(5)\fR).
.TP
+\fB\-\-experimental\-inherit=<y|n>\fR
+Enable experimental inherit.missing checks which may misbehave when the
+internal eclass database becomes outdated.
+.TP
\fB\-\-if\-modified=<y|n>\fR
Only check packages that have uncommitted modifications
.TP
@@ -84,6 +88,9 @@ profiles for dependency checks.
\fB\-d\fR, \fB\-\-include\-dev\fR
Include dev profiles in dependency checks.
.TP
+\fB\-e <y|n>\fR, \fB\-\-include\-exp\-profiles=<y|n>\fR
+Include exp profiles in dependency checks.
+.TP
\fB\-\-unmatched\-removal\fR
Enable strict checking of package.mask and package.unmask files for
unmatched removal atoms.
diff --git a/man/ru/ebuild.1 b/man/ru/ebuild.1
index c0524f7d9..37aadb464 100644
--- a/man/ru/ebuild.1
+++ b/man/ru/ebuild.1
@@ -1,4 +1,4 @@
-.TH "EBUILD" "1" "Jan 2013" "Portage VERSION" "Portage"
+.TH "EBUILD" "1" "Aug 2013" "Portage VERSION" "Portage"
.SH "НАЗВАНИЕ"
ebuild \- низкоуровневый интерфейс системы Portage
.SH "СИНТАКСИС"
@@ -234,7 +234,7 @@ Mike Frysinger <vapier@gentoo.org>
.BR make.conf (5),
.BR color.map (5)
.TP
-Сценарий \fI/usr/sbin/ebuild.sh\fR.
+Сценарий \fI/usr/lib/portage/bin/ebuild.sh\fR.
.TP
Вспомогательные приложения в \fI/usr/lib/portage/bin\fR.