diff options
authorZac Medico <zmedico@gentoo.org>2011-06-09 22:08:29 (GMT)
committerZac Medico <zmedico@gentoo.org>2011-06-09 22:08:29 (GMT)
commitffbaba42bebda213154dbba32e32c245c19e16b2 (patch)
parentuseflag/dep_re: less strict if eapi None (diff)
portage.5: doc repo and wildcard atom extensions
1 files changed, 46 insertions, 5 deletions
diff --git a/man/portage.5 b/man/portage.5
index ece47e5..35dcc2b 100644
--- a/man/portage.5
+++ b/man/portage.5
@@ -115,14 +115,55 @@ more detailed explanations.
.B DEPEND atom
An atom is either of the form category/package or consists of an operator
followed by category/package followed by a hyphen and a version specification.
-An atom might be prefixed by a slot specification.
-The extended atom syntax allows atoms of the form category/package, where an
-arbitrary number of characters has been replaced by a '*'. An extended atom may contain
-more than one '*', but not two next to each other. The extend atom syntax is only
-available in user configuration files and for some command line options.
+An atom might be suffixed by a slot specification.
More reading:
.BR ebuild (5)
+.B Extended Atom Syntax
+The following atom syntax extensions that are only supported in user
+configuration files and command line arguments for programs such as
+.B Repository Constraints
+Atoms with repository constraints have a '::' separator appended to the
+right side, followed by a repository name. Each repository name should
+correspond to the value of a \fBrepo_name\fR entry from one of the
+repositories that is configured via the \fBPORTDIR\fR or
+\fBPORTDIR_OVERLAY\fR variables (see \fBmake.conf\fR(5)).
+.I Examples:
+# match sed from the 'gentoo' repository
+# match kdelibs from the 'kde\-testing' repository
+# match empathy from the 'gnome' repository
+.B Wildcard Patterns
+Atoms containing wildcard patterns are of the form category/package, where
+the special '*' wildcard character substitutes for an arbitrary number
+of normal characters. More than one '*' character is allowed, but not two
+next to each other.
+.I Examples:
+# match anything from the 'sys\-apps' category
+# match packages named 'zlib' from any category
+# match any package from a category that begins with 'net\-'
+# match any package name from any category
+# match any package from the 'gentoo' repository
Each architecture has a unique KEYWORD.