diff options
author | Mike Frysinger <vapier@gentoo.org> | 2004-10-12 15:51:16 +0000 |
---|---|---|
committer | Mike Frysinger <vapier@gentoo.org> | 2004-10-12 15:51:16 +0000 |
commit | 7ee0bb3118dc6a8638266fda90d625cea21ab629 (patch) | |
tree | d1edcdcadca6014b40f9e61b46ad5afbc43c7f19 /man | |
parent | ia64 config files (diff) | |
download | portage-cvs-7ee0bb3118dc6a8638266fda90d625cea21ab629.tar.gz portage-cvs-7ee0bb3118dc6a8638266fda90d625cea21ab629.tar.bz2 portage-cvs-7ee0bb3118dc6a8638266fda90d625cea21ab629.zip |
.br.br.br.br -> .nf.fi
Diffstat (limited to 'man')
-rw-r--r-- | man/ebuild.5 | 60 |
1 files changed, 18 insertions, 42 deletions
diff --git a/man/ebuild.5 b/man/ebuild.5 index 0236f45..7464715 100644 --- a/man/ebuild.5 +++ b/man/ebuild.5 @@ -165,22 +165,22 @@ been emerged, then the latest version available is matched. .B Atom Bases The base atom is just a full category/packagename. Hence, these are base atoms: +.nf .I sys-apps/sed -.br .I sys-libs/zlib -.br .I net-misc/dhcp +.fi .TP .B Atom Versions It is nice to be more specific and say that only certain versions of atoms are acceptable. Note that versions must be combined with a prefix (see below). Hence you may add a version number as a postfix to the base: +.nf sys-apps/sed\fI-4.0.5\fR -.br sys-libs/zlib\fI-1.1.4-r1\fR -.br net-misc/dhcp\fI-3.0_p2\fR +.fi Versions are normally made up of two or three numbers separated by periods, such as 1.2 or 4.5.2. This string may be followed by a character such as 1.2a or 4.5.2z. @@ -193,15 +193,13 @@ you would use something like 1.2_pre3. Sometimes you want to be able to depend on general versions rather than specifying exact versions all the time. Hence we provide standard boolean operators: +.nf \fI>\fRmedia-libs/libgd-1.6 -.br \fI>=\fRmedia-libs/libgd-1.6 -.br \fI=\fRmedia-libs/libgd-1.6 -.br \fI<=\fRmedia-libs/libgd-1.6 -.br \fI<\fRmedia-libs/libgd-1.6 +.fi .TP .B Extended Atom Prefixes [!~] and Postfixes [*] Now to get even fancier, we provide the ability to define blocking packages and @@ -209,13 +207,12 @@ version range matching. Also note that these extended prefixes/postfixes may be combined in any way with the atom classes defined above. Here are some common examples you may find in the portage tree: +.nf \fI!\fRapp-text/dos2unix -.br =dev-libs/glib-2\fI*\fR -.br \fI!\fR=net-fs/samba-2\fI*\fR -.br \fI~\fRnet-libs/libnet-1.0.2a +.fi \fI!\fR means block packages from being installed at the same time. .br @@ -263,36 +260,27 @@ That way the default is the superior GTK2 library. .B || ( Atom Atom ... ) When a package can work with a few different packages but a virtual is not appropriate, this syntax can easily be used. -.br +.nf .B || ( -.br .B app-games/unreal-tournament -.br .B app-games/unreal-tournament-goty -.br .B ) -.br +.fi Here we see that unreal-tournament has a normal version and it has a goty version. Since they provide the same base set of files, another package can use either. Adding a virtual is inappropriate due to the small scope of it. .br Another good example is when a package can be built with multiple video interfaces, but it can only ever have just one. -.br +.nf .B || ( -.br .B sdl? ( media-libs/libsdl ) -.br .B svga? ( media-libs/svgalib ) -.br .B opengl? ( virtual/opengl ) -.br .B ggi? ( media-libs/libggi ) -.br .B virtual/x11 -.br .B ) -.br +.fi Here only one of the packages will be chosen, and the order of preference is determined by the order in which they appear. So sdl has the best chance of being chosen, followed by svga, then opengl, then ggi, with a default of X if the user @@ -413,30 +401,22 @@ include \fIreason\fR. If \fIUSE item\fR is in the \fBUSE\fR variable, \fIUSE item\fR will be echoed and the function will return 0. If \fIUSE item\fR is not in the \fBUSE\fR variable, the function will return 1. \fBuseq\fR is a non-echoing -version of \fBuse\fR and should be used as often as possible instead of -interpreting or handling the output of \fBuse\fR. +version of \fBuse\fR. .RS .TP .I Example: +.nf if useq gnome ; then -.br guiconf="--enable-gui=gnome --with-x" -.br elif useq gtk ; then -.br guiconf="--enable-gui=gtk --with-x" -.br elif useq X ; then -.br guiconf="--enable-gui=athena --with-x" -.br else -.br # No gui version will be built -.br guiconf="" -.br fi +.fi .RE .TP \fBuse_with\fR \fI<USE item>\fR \fI[configure option]\fR @@ -450,23 +430,19 @@ used in its place. .RS .TP .I Example: +.nf USE="jpeg" -.br myconf="$(use_with jpeg libjpeg)" -.br (myconf now has the value "--with-libjpeg") USE="" -.br myconf="$(use_with jpeg libjpeg)" -.br (myconf now has the value "--without-libjpeg") USE="opengl" -.br myconf="$(use_with opengl") -.br (myconf now has the value "--with-opengl") +.fi .RE .TP \fBuse_enable\fR \fI<USE item>\fR \fI[configure option]\fR @@ -845,4 +821,4 @@ Nicholas Jones <carpaski@gentoo.org> Mike Frysinger <vapier@gentoo.org> .fi .SH "CVS HEADER" -$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/ebuild.5,v 1.71 2004/09/24 12:46:01 vapier Exp $ +$Header: /local/data/ulm/cvs/history/var/cvsroot/gentoo-src/portage/man/ebuild.5,v 1.72 2004/10/12 15:51:16 vapier Exp $ |