From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id 7D8BC1381F3 for ; Mon, 24 Jun 2013 09:30:19 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 054F5E0919; Mon, 24 Jun 2013 09:30:15 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 8FCBDE0919 for ; Mon, 24 Jun 2013 09:30:14 +0000 (UTC) Received: from hornbill.gentoo.org (hornbill.gentoo.org [94.100.119.163]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 6606533DC38 for ; Mon, 24 Jun 2013 09:30:13 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by hornbill.gentoo.org (Postfix) with ESMTP id EFA31E468F for ; Mon, 24 Jun 2013 09:30:11 +0000 (UTC) From: "Arfrever Frehtes Taifersar Arahesis" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Arfrever Frehtes Taifersar Arahesis" Message-ID: <1372066091.5cc7fd215076d3fda765bae77e08991c8a6e0439.arfrever@gentoo> Subject: [gentoo-commits] proj/portage:master commit in: man/ X-VCS-Repository: proj/portage X-VCS-Files: man/portage.5 X-VCS-Directories: man/ X-VCS-Committer: arfrever X-VCS-Committer-Name: Arfrever Frehtes Taifersar Arahesis X-VCS-Revision: 5cc7fd215076d3fda765bae77e08991c8a6e0439 X-VCS-Branch: master Date: Mon, 24 Jun 2013 09:30:11 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: b1ba0bfc-ee82-4869-a74c-a154dc515d0b X-Archives-Hash: 21110785b54290f9c6b5d91b8cde607d commit: 5cc7fd215076d3fda765bae77e08991c8a6e0439 Author: Arfrever Frehtes Taifersar Arahesis Apache Org> AuthorDate: Mon Jun 24 09:28:11 2013 +0000 Commit: Arfrever Frehtes Taifersar Arahesis gmail com> CommitDate: Mon Jun 24 09:28:11 2013 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=proj/portage.git;a=commit;h=5cc7fd21 Update notes about aliases, eclass-overrides and masters attributes in repos.conf and layout.conf. --- man/portage.5 | 22 ++++++++++++---------- 1 file changed, 12 insertions(+), 10 deletions(-) diff --git a/man/portage.5 b/man/portage.5 index 505990c..31c6c88 100644 --- a/man/portage.5 +++ b/man/portage.5 @@ -756,13 +756,15 @@ x11\-libs/qt \-mysql .TP .BR repos.conf Specifies \fIsite\-specific\fR repository configuration information. Note that -local configuration overrides which are specified here do not apply to tools -such as \fBrepoman\fR(1) and \fBegencache\fR(1), since operations -performed by these tools -are inherently \fBnot\fR \fIsite\-specific\fR. \fBWARNING:\fR Use of -\fBrepos.conf\fR is generally not recommended since resulting changes in -eclass inheritance (especially due to \fBeclass\-overrides\fR) may trigger -performance issues under some circumstances (see \fBbug #124041\fR). +local configuration overrides (i.e. \fBaliases\fR, \fBeclass-overrides\fR and +\fBmasters\fR attributes) which are specified here do not apply to tools +such as \fBrepoman\fR(1) and \fBegencache\fR(1), since operations performed by +these tools are inherently \fBnot\fR \fIsite\-specific\fR. +.br +\fBWARNING:\fR Setting \fBaliases\fR, \fBeclass-overrides\fR or \fBmasters\fR +attributes in \fBrepos.conf\fR is generally not recommended since resulting +changes in eclass inheritance may trigger performance issues due to invalidation +of metadata cache. .I Example: .nf @@ -852,9 +854,9 @@ behaves like an "aliases" attribute in \fBrepos.conf\fR. \fISite-specific\fR overrides to \fBlayout.conf\fR settings may be specified in \fB/etc/portage/repos.conf\fR. Settings in \fBrepos.conf\fR take precedence over settings in \fBlayout.conf\fR, except tools such as -\fBrepoman\fR(1) and \fBegencache\fR(1) will entirely ignore -\fBrepos.conf\fR since their operations are inherently \fBnot\fR -\fIsite\-specific\fR. +\fBrepoman\fR(1) and \fBegencache\fR(1) ignore "aliases", "eclass-overrides" +and "masters" attributes set in \fBrepos.conf\fR since their operations are +inherently \fBnot\fR \fIsite\-specific\fR. .I Example: .nf