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 6EE4D1381F3 for ; Mon, 22 Jul 2013 04:44:38 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 03902E076D; Mon, 22 Jul 2013 04:44:38 +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 7526FE076D for ; Mon, 22 Jul 2013 04:44:37 +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 081CF33BF13 for ; Mon, 22 Jul 2013 04:44:36 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by hornbill.gentoo.org (Postfix) with ESMTP id 97160E5458 for ; Mon, 22 Jul 2013 04:44:34 +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: <1374468243.c941bc4c73a7c79baa776c8fbe5c2f45d466f18f.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: c941bc4c73a7c79baa776c8fbe5c2f45d466f18f X-VCS-Branch: master Date: Mon, 22 Jul 2013 04:44:34 +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: f6643a41-1189-4456-97a8-4b4e6e1533d2 X-Archives-Hash: 851a5dc38cfaf552fe57a0087bfcc936 commit: c941bc4c73a7c79baa776c8fbe5c2f45d466f18f Author: Arfrever Frehtes Taifersar Arahesis Apache Org> AuthorDate: Mon Jul 22 04:44:03 2013 +0000 Commit: Arfrever Frehtes Taifersar Arahesis gmail com> CommitDate: Mon Jul 22 04:44:03 2013 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=proj/portage.git;a=commit;h=c941bc4c Improve documentation of repos.conf. --- man/portage.5 | 72 ++++++++++++++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 62 insertions(+), 10 deletions(-) diff --git a/man/portage.5 b/man/portage.5 index 01be18b..81a026a 100644 --- a/man/portage.5 +++ b/man/portage.5 @@ -758,22 +758,74 @@ x11\-libs/qt \-mysql .fi .TP .BR repos.conf -Specifies \fIsite\-specific\fR repository configuration information. Note that -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. +Specifies \fIsite\-specific\fR repository configuration information. + +.I Format: +.nf +\- comments begin with # (no inline comments) +\- configuration of each repository is specified in a section starting with "[${repository_name}]" +\- attributes are specified in "${attribute} = ${value}" format +.fi + +.I Attributes supported in DEFAULT section: +.RS +.RS +.TP +.B main\-repo +Specifies main repository. +.TP +.B eclass\-overrides +Makes all repositories inherit eclasses from specified repositories. +.br +Setting this attribute is generally not recommended since resulting changes +in eclass inheritance may trigger performance issues due to invalidation +of metadata cache. +.br +Tools such as \fBrepoman\fR(1) and \fBegencache\fR(1) ignore this attribute, +since operations performed by these tools are inherently +\fBnot\fR \fIsite\-specific\fR. +.RE + +.I Attributes supported in sections of repositories: +.RS +.TP +.B aliases +Specifies aliases of given repository. +.TP +.B eclass\-overrides +Makes given repository inherit eclasses from specified repositories. .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 +Setting this attribute is generally not recommended since resulting changes +in eclass inheritance may trigger performance issues due to invalidation of metadata cache. +.br +Tools such as \fBrepoman\fR(1) and \fBegencache\fR(1) ignore this attribute, +since operations performed by these tools are inherently +\fBnot\fR \fIsite\-specific\fR. +.TP +.B location +Specifies location of given repository. +.TP +.B masters +Specifies master repositories of given repository. +.br +Setting this attribute is generally not recommended since resulting changes +in eclass inheritance may trigger performance issues due to invalidation +of metadata cache. +.br +Tools such as \fBrepoman\fR(1) and \fBegencache\fR(1) ignore this attribute, +since operations performed by these tools are inherently +\fBnot\fR \fIsite\-specific\fR. +.TP +.B priority +Specifies priority of given repository. +.RE .I Example: .nf [DEFAULT] -# make gentoo the main repo (aka PORTDIR), which makes it the default master -# repository for repostories that do not specify masters +# make gentoo the main repository, which makes it the default master +# repository for repositories that do not specify masters main\-repo = gentoo # make all repositories inherit eclasses from the java\-overlay and # java\-experimental repositories, with eclasses from java\-experimental