diff options
author | Zac Medico <zmedico@gentoo.org> | 2011-06-09 15:08:29 -0700 |
---|---|---|
committer | Zac Medico <zmedico@gentoo.org> | 2011-06-09 15:08:29 -0700 |
commit | ffbaba42bebda213154dbba32e32c245c19e16b2 (patch) | |
tree | b8a82adb83506d399bd1f98cc4818bda1f1f0f80 | |
parent | d85506e8a37778e0935f43f9e7cc62bb8b933063 (diff) | |
download | portage-ffbaba42bebda213154dbba32e32c245c19e16b2.tar.gz portage-ffbaba42bebda213154dbba32e32c245c19e16b2.tar.bz2 portage-ffbaba42bebda213154dbba32e32c245c19e16b2.zip |
portage.5: doc repo and wildcard atom extensions
-rw-r--r-- | man/portage.5 | 51 |
1 files changed, 46 insertions, 5 deletions
diff --git a/man/portage.5 b/man/portage.5 index ece47e5a4..35dcc2b38 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. .br More reading: .BR ebuild (5) + +.B Extended Atom Syntax +.br +The following atom syntax extensions that are only supported in user +configuration files and command line arguments for programs such as +\fBemerge(1)\fR: +.RS +.TP +.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: +.nf +# match sed from the 'gentoo' repository +sys\-apps/sed::gentoo +# match kdelibs from the 'kde\-testing' repository +kde\-base/kdelibs::kde\-testing +# match empathy from the 'gnome' repository +net\-im/empathy::gnome +.fi +.TP +.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: +.nf +# match anything from the 'sys\-apps' category +sys\-apps/* +# match packages named 'zlib' from any category +*/zlib +# match any package from a category that begins with 'net\-' +net\-*/* +# match any package name from any category +*/* +# match any package from the 'gentoo' repository +*/*::gentoo +.fi +.RE .TP .B KEYWORD Each architecture has a unique KEYWORD. |