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 90CB7138200 for ; Tue, 30 Jul 2013 19:14:03 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 3E2C4E09F3; Tue, 30 Jul 2013 19:14:01 +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 8E7CEE09F3 for ; Tue, 30 Jul 2013 19:14:00 +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 4BF3433EAB2 for ; Tue, 30 Jul 2013 19:13:59 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by hornbill.gentoo.org (Postfix) with ESMTP id D8348E5459 for ; Tue, 30 Jul 2013 19:13:57 +0000 (UTC) From: "Zac Medico" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Zac Medico" Message-ID: <1375211427.cb078394988d60e5ff231712163255abebc2fc22.zmedico@gentoo> Subject: [gentoo-commits] proj/portage:master commit in: man/ X-VCS-Repository: proj/portage X-VCS-Files: man/dispatch-conf.1 man/ebuild.1 man/ebuild.5 man/emaint.1 man/emerge.1 man/env-update.1 man/etc-update.1 man/make.conf.5 man/portage.5 man/quickpkg.1 man/xpak.5 X-VCS-Directories: man/ X-VCS-Committer: zmedico X-VCS-Committer-Name: Zac Medico X-VCS-Revision: cb078394988d60e5ff231712163255abebc2fc22 X-VCS-Branch: master Date: Tue, 30 Jul 2013 19:13:57 +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: 50a51d96-a51f-4dd9-bfcd-9eb61a3f0f50 X-Archives-Hash: 79535a75ba04d9fc996dbedad635e6b8 commit: cb078394988d60e5ff231712163255abebc2fc22 Author: Alexander Berntsen plaimi net> AuthorDate: Tue Jul 30 18:53:51 2013 +0000 Commit: Zac Medico gentoo org> CommitDate: Tue Jul 30 19:10:27 2013 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=proj/portage.git;a=commit;h=cb078394 man: Remove trailing spaces --- man/dispatch-conf.1 | 2 +- man/ebuild.1 | 4 +- man/ebuild.5 | 8 +-- man/emaint.1 | 2 +- man/emerge.1 | 154 ++++++++++++++++++++++++++-------------------------- man/env-update.1 | 6 +- man/etc-update.1 | 2 +- man/make.conf.5 | 64 +++++++++++----------- man/portage.5 | 152 +++++++++++++++++++++++++-------------------------- man/quickpkg.1 | 14 ++--- man/xpak.5 | 2 +- 11 files changed, 205 insertions(+), 205 deletions(-) diff --git a/man/dispatch-conf.1 b/man/dispatch-conf.1 index e16d49c..3a5264a 100644 --- a/man/dispatch-conf.1 +++ b/man/dispatch-conf.1 @@ -24,7 +24,7 @@ None. \fIdispatch\-conf\fR must be run as root, since the config files to be replaced are generally owned by root. Before running \fIdispatch\-conf\fR for the first time the settings in \fB/etc/dispatch\-conf.conf\fR -should be edited and the archive directory specified in +should be edited and the archive directory specified in \fB/etc/dispatch\-conf.conf\fR will need to be created. All changes to config files will be saved in the archive directory either as patches or using rcs, making restoration to an earlier version rather simple. diff --git a/man/ebuild.1 b/man/ebuild.1 index bc9d31b..4bde66e 100644 --- a/man/ebuild.1 +++ b/man/ebuild.1 @@ -74,7 +74,7 @@ for all of the files listed in SRC_URI for each ebuild. For further information regarding the behavior of this command, see the documentation for the \fIassume\-digests\fR value of the \fBFEATURES\fR variable in \fBmake.conf\fR(5). See the \fB\-\-force\fR option if you would like to -prevent digests from being assumed. +prevent digests from being assumed. .TP .BR unpack Extracts the sources to a subdirectory in the \fIbuild directory\fR @@ -112,7 +112,7 @@ current working directory will be set to ${S}. When src_compile() completes, the sources should be fully compiled. .TP .BR test -Runs package-specific test cases to verify that everything was built +Runs package-specific test cases to verify that everything was built properly. .TP .BR preinst diff --git a/man/ebuild.5 b/man/ebuild.5 index 10ef4ee..a9f3498 100644 --- a/man/ebuild.5 +++ b/man/ebuild.5 @@ -28,7 +28,7 @@ Examples: .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). +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. Examples: @@ -41,9 +41,9 @@ Examples: 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. Note that this letter is \fInot\fR meant to indicate alpha, beta, -etc... status. For that, use the optional suffix; either _alpha, _beta, _pre -(pre\-release), _rc (release candidate), or _p (patch). This means for the -3rd pre\-release of a package, you would use something like 1.2_pre3. The +etc... status. For that, use the optional suffix; either _alpha, _beta, _pre +(pre\-release), _rc (release candidate), or _p (patch). This means for the +3rd pre\-release of a package, you would use something like 1.2_pre3. The suffixes here can be arbitrarily chained without limitation. .TP .B Atom Prefix Operators [> >= = <= <] diff --git a/man/emaint.1 b/man/emaint.1 index 3fae5c2..8356299 100644 --- a/man/emaint.1 +++ b/man/emaint.1 @@ -39,7 +39,7 @@ Perform package move updates for installed packages. .TP .BR world Fix problems in the \fIworld\fR file. -.SH DEFAULT OPTIONS +.SH DEFAULT OPTIONS .TP .B \-c, \-\-check Check for any problems that may exist. (all commands) diff --git a/man/emerge.1 b/man/emerge.1 index 66f4360..4511414 100644 --- a/man/emerge.1 +++ b/man/emerge.1 @@ -49,7 +49,7 @@ so this syntax shouldn't be used. .TP .BR tbz2file A \fItbz2file\fR must be a valid .tbz2 created with \fBebuild -\-.ebuild package\fR or \fBemerge \-\-buildpkg +\-.ebuild package\fR or \fBemerge \-\-buildpkg [category/]\fR or \fBquickpkg /var/db/pkg//\fR. .TP .BR file @@ -73,19 +73,19 @@ on the current configuration. The default set configuration is located in the \fB/usr/share/portage/config/sets\fR directory. User sets may be created by placing files in the \fB/etc/portage/sets/\fR directory (see \fBportage\fR(5)). Note that a \fIset\fR -is generally used in conjunction with \fB\-\-update\fR. When used as +is generally used in conjunction with \fB\-\-update\fR. When used as arguments to \fBemerge\fR sets have to be prefixed with \fB@\fR to be recognized. Use the \fB\-\-list\-sets\fR action to display a list of available package sets. .TP .BR atom -An \fIatom\fR describes bounds on a package that you wish to install. +An \fIatom\fR describes bounds on a package that you wish to install. \fISee ebuild(5) for the details on atom syntax.\fR For example, -\fB>=dev\-lang/python\-2.2.1\-r2\fR matches the latest available version of -Python greater than or equal to 2.2.1\-r2. Similarly, -\fB Arfrever Frehtes Taifersar Arahesis .fi .SH "FILES" -Here is a common list of files you will probably be interested in. For a +Here is a common list of files you will probably be interested in. For a complete listing, please refer to the \fBportage\fR(5) man page. .TP .B /usr/share/portage/config/sets/ @@ -1173,7 +1173,7 @@ Contains variables customizing colors. Contains user package set definitions (see \fBportage\fR(5)). .TP .B /etc/dispatch\-conf.conf -Contains settings to handle automatic updates/backups of configuration +Contains settings to handle automatic updates/backups of configuration files. .TP .B /etc/portage/make.profile/make.defaults @@ -1206,5 +1206,5 @@ this file\fR. .LP A number of helper applications reside in \fI/usr/lib/portage/bin\fR. .LP -The \fBapp\-portage/gentoolkit\fR package contains useful scripts such as +The \fBapp\-portage/gentoolkit\fR package contains useful scripts such as \fBequery\fR (a package query tool). diff --git a/man/env-update.1 b/man/env-update.1 index 5051524..9ceddab 100644 --- a/man/env-update.1 +++ b/man/env-update.1 @@ -10,9 +10,9 @@ reads the files in \fI/etc/env.d\fR and automatically generates is run to update \fI/etc/ld.so.cache\fR. \fBenv-update\fR is run by \fBemerge\fR(1) automatically after each package merge. Also, if you make changes to \fI/etc/env.d\fR, you should run \fBenv-update\fR -yourself for changes to take effect immediately. Note that this would -only affect new processes. In order for the changes to affect your -active shell, you will probably have to run \fIsource /etc/profile\fR +yourself for changes to take effect immediately. Note that this would +only affect new processes. In order for the changes to affect your +active shell, you will probably have to run \fIsource /etc/profile\fR first. .SH "OPTIONS" .TP diff --git a/man/etc-update.1 b/man/etc-update.1 index 2662de5..71900da 100644 --- a/man/etc-update.1 +++ b/man/etc-update.1 @@ -7,7 +7,7 @@ etc\-update \- handle configuration file updates .SH "DESCRIPTION" \fIetc\-update\fR is supposed to be run after merging a new package to see if there are updates to the configuration files. If a new -configuration file will override an old one, +configuration file will override an old one, \fIetc\-update\fR will prompt the user for a decision. .PP \fIetc\-update\fR will check all directories specified on the command diff --git a/man/make.conf.5 b/man/make.conf.5 index f75e277..236fdf0 100644 --- a/man/make.conf.5 +++ b/man/make.conf.5 @@ -37,7 +37,7 @@ Defaults to the value of $CHOST. \fBACCEPT_KEYWORDS\fR = \fI[space delimited list of KEYWORDS]\fR Enable testing of ebuilds that have not yet been deemed 'stable'. Users of the 'x86' architecture would set this to '~x86' while ppc users would -set this to '~ppc'. This is an incremental variable. Only define a +set this to '~ppc'. This is an incremental variable. Only define a ~arch. .br Defaults to the value of $ARCH. @@ -68,7 +68,7 @@ This variable is used to mask packages based on PROPERTIES restrictions. In addition to property names, the \fI*\fR and \fI-*\fR wildcard tokens are also supported. This variable can be temporarily overridden using the \fB\-\-accept\-properties\fR option of \fBemerge\fR(1). -See \fBebuild\fR(5) for more information about PROPERTIES. +See \fBebuild\fR(5) for more information about PROPERTIES. .br Defaults to the value of *. .br @@ -109,7 +109,7 @@ man page for more information. Defaults to /var/tmp/ccache .TP \fBCCACHE_SIZE\fR = \fI"size"\fR -This controls the space use limitations for ccache. The default is 2 gigabytes +This controls the space use limitations for ccache. The default is 2 gigabytes ('2G'). Sizes are specified with 'G', 'M', or 'K'. .TP .B CFLAGS CXXFLAGS @@ -229,7 +229,7 @@ should not be disabled by default. .RS .TP .B assume\-digests -When commiting work to cvs with \fBrepoman\fR(1), assume that all existing +When commiting work to cvs with \fBrepoman\fR(1), assume that all existing SRC_URI digests are correct. This feature also affects digest generation via \fBebuild\fR(1) and \fBemerge\fR(1) (emerge generates digests only when the \fIdigest\fR feature is enabled). Existing digests for files that do not exist @@ -256,8 +256,8 @@ Enable a special progress indicator when \fBemerge\fR(1) is calculating dependencies. .TP .B ccache -Enable portage support for the ccache package. If the ccache dir is not -present in the user's environment, then portage will default to +Enable portage support for the ccache package. If the ccache dir is not +present in the user's environment, then portage will default to ${PORTAGE_TMPDIR}/ccache. \fBWarning\fR: This feature is known to cause numerous compilation failures. @@ -344,7 +344,7 @@ Both the \fBebuild\fR(1) command and the \fInoclean\fR feature cause the \fIfail\-clean\fR feature to be automatically disabled. .TP .B getbinpkg -Force emerges to always try to fetch files from the \fIPORTAGE_BINHOST\fR. See +Force emerges to always try to fetch files from the \fIPORTAGE_BINHOST\fR. See \fBmake.conf\fR(5) for more information. .TP .B installsources @@ -475,10 +475,10 @@ selectively disable this feature. It is recommended to leave either since otherwise file collisions between packages may result in files being overwritten or uninstalled at inappropriate times. If \fIcollision\-protect\fR is enabled then it takes precedence over -\fIprotect\-owned\fR. +\fIprotect\-owned\fR. .TP .B python\-trace -Output a verbose trace of python execution to stderr when a command's +Output a verbose trace of python execution to stderr when a command's \-\-debug option is enabled. .TP .B sandbox @@ -488,14 +488,14 @@ Enable sandbox\-ing when running \fBemerge\fR(1) and \fBebuild\fR(1). Enable SELinux sandbox\-ing. Do not toggle this \fBFEATURE\fR yourself. .TP .B sfperms -Stands for Smart Filesystem Permissions. Before merging packages to the -live filesystem, automatically search for and set permissions on setuid -and setgid files. Files that are setuid have the group and other read -bits removed while files that are setgid have the other read bit removed. +Stands for Smart Filesystem Permissions. Before merging packages to the +live filesystem, automatically search for and set permissions on setuid +and setgid files. Files that are setuid have the group and other read +bits removed while files that are setgid have the other read bit removed. See also \fIsuidctl\fR below. .TP .B sign -When commiting work to cvs with \fBrepoman\fR(1), sign the Manifest with +When commiting work to cvs with \fBrepoman\fR(1), sign the Manifest with a GPG key. Read about the \fIPORTAGE_GPG_KEY\fR variable in \fBmake.conf\fR(5). .TP @@ -512,20 +512,20 @@ incompatibility. Store logs created by \fBPORTAGE_ELOG_SYSTEM="save"\fR in category subdirectories of \fBPORT_LOGDIR/elog\fR, instead of using \fBPORT_LOGDIR/elog\fR directly. -.TP +.TP .B split\-log Store build logs in category subdirectories of \fBPORT_LOGDIR/build\fR, instead of using \fBPORT_LOGDIR\fR directly. .TP .B splitdebug -Prior to stripping ELF etdyn and etexec files, the debugging info is +Prior to stripping ELF etdyn and etexec files, the debugging info is stored for later use by various debuggers. This feature is disabled by \fBnostrip\fR. You should also consider setting \fBcompressdebug\fR so the files don't suck up a lot of space. For installation of source code, see \fBinstallsources\fR. .TP .B strict -Have portage react strongly to conditions that have the potential to be +Have portage react strongly to conditions that have the potential to be dangerous (like missing or incorrect digests for ebuilds). .TP .B stricter @@ -534,12 +534,12 @@ security provisions (for example textrels, executable stack). Read about the \fIQA_STRICT_*\fR variables in \fBmake.conf\fR(5). .TP .B suidctl -Before merging packages to the live filesystem, automatically strip setuid +Before merging packages to the live filesystem, automatically strip setuid bits from any file that is not listed in \fI/etc/portage/suidctl.conf\fR. .TP .B test -Run package\-specific tests during each merge to help make sure -the package compiled properly. See \fItest\fR in \fBebuild\fR(1) +Run package\-specific tests during each merge to help make sure +the package compiled properly. See \fItest\fR in \fBebuild\fR(1) and \fIsrc_test()\fR in \fBebuild\fR(5). This feature implies the "test" \fBUSE\fR flag if it is a member of \fBIUSE\fR, either explicitly or implicitly (see \fBebuild\fR(5) for more information about \fBIUSE\fR). @@ -577,7 +577,7 @@ When portage is run as root, drop privileges to portage:portage during the fetching of package sources. .TP .B userpriv -Allow portage to drop root privileges and compile packages as +Allow portage to drop root privileges and compile packages as portage:portage without a sandbox (unless \fIusersandbox\fR is also used). .TP .B usersandbox @@ -653,7 +653,7 @@ enabled for these flags may be closed as INVALID. .TP .B MAKEOPTS Use this variable if you want to use parallel make. For example, if you -have a dual\-processor system, set this variable to "\-j2" or "\-j3" for +have a dual\-processor system, set this variable to "\-j2" or "\-j3" for enhanced build performance with many packages. Suggested settings are between \fICPUs+1\fR and \fI2*CPUs+1\fR. In order to avoid excess load, the \fB\-\-load\-average\fR option is recommended. @@ -698,7 +698,7 @@ This is a list of hosts from which portage will grab prebuilt\-binary packages. Each entry in the list must specify the full address of a directory serving tbz2's for your system (this directory must contain a 'Packages' index file). This is only used when running with -the get binary pkg options are given to \fBemerge\fR. Review \fBemerge\fR(1) +the get binary pkg options are given to \fBemerge\fR. Review \fBemerge\fR(1) for more information. .TP \fBPORTAGE_BINHOST_HEADER_URI\fR = \ @@ -850,7 +850,7 @@ Additional rsync options to be used by \fBemerge \-\-sync\fR. Defaults to no value. .TP \fBPORTAGE_RSYNC_OPTS\fR = \fI[rsync options string]\fR -Default rsync options to be used by \fBemerge \-\-sync\fR. +Default rsync options to be used by \fBemerge \-\-sync\fR. .br \fBDon't change this unless you know exactly what you're doing!\fR .br @@ -908,7 +908,7 @@ Defines the location of the Portage tree. This is the repository for all profile information as well as all ebuilds. If you change this, you must update your /etc/portage/make.profile symlink accordingly. .br -Defaults to /usr/portage. +Defaults to /usr/portage. .br \fB***Warning***\fR .br @@ -916,13 +916,13 @@ Data stored inside \fBPORTDIR\fR is in peril of being overwritten or deleted by the emerge \-\-sync command. The default value of \fBPORTAGE_RSYNC_OPTS\fR will protect the default locations of \fBDISTDIR\fR and \fBPKGDIR\fR, but users are warned that any other locations -inside \fBPORTDIR\fR are not necessarily safe for data storage. You should not -put other data (such as overlays) in your \fBPORTDIR\fB. Portage will walk +inside \fBPORTDIR\fR are not necessarily safe for data storage. You should not +put other data (such as overlays) in your \fBPORTDIR\fB. Portage will walk directory structures and may arbitrarily add invalid categories as packages. .TP \fBPORTDIR_OVERLAY\fR = \fI"[path] [different\-path] [etc...]"\fR -Defines the directories in which user made ebuilds may be stored and not -overwriten when `emerge \-\-sync` is run. This is a space delimited list of +Defines the directories in which user made ebuilds may be stored and not +overwriten when `emerge \-\-sync` is run. This is a space delimited list of directories. .br Defaults to no value. @@ -959,9 +959,9 @@ be necessary in order to continue a partially downloaded file located at \\${DISTDIR}/\\${FILE}. .TP \fBROOT\fR = \fI[path]\fR -Use \fBROOT\fR to specify the target root filesystem to be used for merging +Use \fBROOT\fR to specify the target root filesystem to be used for merging packages or ebuilds. -Typically, you should set this setting in the environment rather than in +Typically, you should set this setting in the environment rather than in \fImake.conf\fR itself. It's commonly used for creating new build images. Make sure you use an absolute path. Refer to the \fBCross-compilation\fR section of \fBebuild\fR(5) for information about @@ -1085,6 +1085,6 @@ Contains a list of all local USE variables. .BR ebuild (1), .BR ebuild (5) .TP -The \fI/usr/sbin/ebuild.sh\fR script. +The \fI/usr/sbin/ebuild.sh\fR script. .TP The helper apps in \fI/usr/lib/portage/bin\fR. diff --git a/man/portage.5 b/man/portage.5 index 827c504..38c6d8c 100644 --- a/man/portage.5 +++ b/man/portage.5 @@ -2,16 +2,16 @@ .SH NAME portage \- the heart of Gentoo .SH "DESCRIPTION" -The current portage code uses many different configuration files, most of which -are unknown to users and normal developers. Here we will try to collect all -the odds and ends so as to help users more effectively utilize portage. This +The current portage code uses many different configuration files, most of which +are unknown to users and normal developers. Here we will try to collect all +the odds and ends so as to help users more effectively utilize portage. This is a reference only for files which do not already have a man page. -All files in the make.profile directory may be tweaked via parent profiles -when using cascading profiles. For more info, please see +All files in the make.profile directory may be tweaked via parent profiles +when using cascading profiles. For more info, please see http://www.gentoo.org/proj/en/releng/docs/cascading-profiles.xml .IP Note: -If you are looking for information on how to emerge something, please see +If you are looking for information on how to emerge something, please see .BR emerge (1). .SH "SYNOPSIS" .TP @@ -122,8 +122,8 @@ world world_sets .fi .SH "GLOSSARY" -In the following sections, some terminology may be foreign to you or used -with meaning specific to Portage. Please see the referenced manpages for +In the following sections, some terminology may be foreign to you or used +with meaning specific to Portage. Please see the referenced manpages for more detailed explanations. .RS .TP @@ -132,7 +132,7 @@ 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 suffixed by a slot specification. .br -More reading: +More reading: .BR ebuild (5) .B Extended Atom Syntax @@ -188,26 +188,26 @@ net\-*/* .B KEYWORD Each architecture has a unique KEYWORD. .br -More reading: +More reading: .BR ebuild (5) .TP .B virtual -A DEPEND atom that is part of the "virtual" category. They are used -when different packages can satisfy a dependency and only one of them is +A DEPEND atom that is part of the "virtual" category. They are used +when different packages can satisfy a dependency and only one of them is needed. .br -More reading: +More reading: .BR ebuild (5) .RE .SH "SPECIFIC FILE DESCRIPTIONS" .TP \fB/etc/portage/make.profile/\fR or \fB/etc/make.profile/\fR -This is usually just a symlink to the correct profile in -\fB/usr/portage/profiles/\fR. Since it is part of the portage tree, it -may easily be updated/regenerated by running `emerge \-\-sync`. It defines -what a profile is (usually arch specific stuff). If you need a custom -profile, then you should make your own \fBmake.profile\fR -directory and populate it. However, if you just wish to override some +This is usually just a symlink to the correct profile in +\fB/usr/portage/profiles/\fR. Since it is part of the portage tree, it +may easily be updated/regenerated by running `emerge \-\-sync`. It defines +what a profile is (usually arch specific stuff). If you need a custom +profile, then you should make your own \fBmake.profile\fR +directory and populate it. However, if you just wish to override some settings, use \fB/etc/portage/profile/\fR (it supports all of the same file types that \fBmake.profile\fR does, except parent). Do NOT edit the settings in \fBmake.profile\fR because they WILL be lost with the next @@ -230,9 +230,9 @@ ${PORTDIR}/profiles/package.mask/testing .RS .TP .BR deprecated -The existence of this file marks a profile as deprecated, meaning it is -not supported by Gentoo anymore. The first line must be the profile to which -users are encouraged to upgrade, optionally followed by some instructions +The existence of this file marks a profile as deprecated, meaning it is +not supported by Gentoo anymore. The first line must be the profile to which +users are encouraged to upgrade, optionally followed by some instructions explaining how they can upgrade. .I Example: @@ -255,8 +255,8 @@ previously supported USE configuration files, except that they only influence packages that are merged due to a stable keyword. .TP .BR make.defaults -The profile default settings for Portage. The general format is described -in \fBmake.conf\fR(5). The \fImake.defaults\fR for your profile defines a +The profile default settings for Portage. The general format is described +in \fBmake.conf\fR(5). The \fImake.defaults\fR for your profile defines a few specific variables too: .PD 0 @@ -317,11 +317,11 @@ Defines USERLAND values used to generate implicit Support uClibc/BSD libc/etc... .TP .B PROFILE_ONLY_VARIABLES = \fI"ARCH"\fR -Prevent critical variables from being changed by the user in make.conf +Prevent critical variables from being changed by the user in make.conf or the env. .TP .BR PROFILE_ARCH -Distinguish machines classes that have the same \fBARCH\fR. All sparc +Distinguish machines classes that have the same \fBARCH\fR. All sparc machines have ARCH=sparc but set this to either 'sparc32' or 'sparc64'. .TP .BR BOOTSTRAP_USE @@ -340,8 +340,8 @@ Provides the list of packages that compose the special \fIsystem\fR set. \- atoms without * only appear for legacy reasons .fi .I Note: -In a cascading profile setup, you can remove packages in children -profiles which were added by parent profiles by prefixing the atom with +In a cascading profile setup, you can remove packages in children +profiles which were added by parent profiles by prefixing the atom with a '\-'. .I Example: @@ -356,16 +356,16 @@ a '\-'. .fi .TP .BR packages.build -A list of packages (one per line) that make up a stage1 tarball. Really only +A list of packages (one per line) that make up a stage1 tarball. Really only useful for stage builders. .TP .BR package.provided -A list of packages (one per line) that portage should assume have been +A list of packages (one per line) that portage should assume have been provided. Useful for porting to non-Linux systems. Basically, it's a list that replaces the \fBemerge \-\-inject\fR syntax. -For example, if you manage your own copy of a 2.6 kernel, then you can -tell portage that 'sys-kernel/development-sources-2.6.7' is already taken +For example, if you manage your own copy of a 2.6 kernel, then you can +tell portage that 'sys-kernel/development-sources-2.6.7' is already taken care of and it should get off your back about it. Portage will not attempt to update a package that is listed here unless @@ -406,8 +406,8 @@ x11-base/xorg-x11-6.8 Per\-package USE flag forcing. .I Note: -In a cascading profile setup, you can remove USE flags in children -profiles which were added by parent profiles by prefixing the flag with +In a cascading profile setup, you can remove USE flags in children +profiles which were added by parent profiles by prefixing the flag with a '\-'. .I Format: @@ -428,8 +428,8 @@ x11\-libs/qt \-mysql Per\-package USE flag masks. .I Note: -In a cascading profile setup, you can remove USE flags in children -profiles which were added by parent profiles by prefixing the flag with +In a cascading profile setup, you can remove USE flags in children +profiles which were added by parent profiles by prefixing the flag with a '\-'. .I Format: @@ -470,8 +470,8 @@ Some USE flags don't make sense to disable under certain conditions. Here we list forced flags. .I Note: -In a cascading profile setup, you can remove USE flags in children -profiles which were added by parent profiles by prefixing the flag with +In a cascading profile setup, you can remove USE flags in children +profiles which were added by parent profiles by prefixing the flag with a '\-'. .I Format: @@ -481,13 +481,13 @@ a '\-'. .fi .TP \fBuse.mask\fR and \fBuse.stable.mask\fR -Some USE flags don't make sense on some archs (for example altivec on -non\-ppc or mmx on non\-x86), or haven't yet been tested. Here we list +Some USE flags don't make sense on some archs (for example altivec on +non\-ppc or mmx on non\-x86), or haven't yet been tested. Here we list the masked ones. .I Note: -In a cascading profile setup, you can remove USE flags in children -profiles which were added by parent profiles by prefixing the flag with +In a cascading profile setup, you can remove USE flags in children +profiles which were added by parent profiles by prefixing the flag with a '\-'. .I Format: @@ -529,8 +529,8 @@ virtual/aspell\-dict app\-dicts/aspell\-en .RE .TP .BR /etc/portage/ -Any file in this directory that begins with "package." can be more than just a -flat file. If it is a directory, then all the files in that directory will be +Any file in this directory that begins with "package." can be more than just a +flat file. If it is a directory, then all the files in that directory will be sorted in ascending alphabetical order by file name and summed together as if it were a single file. @@ -550,8 +550,8 @@ any other bash script. Additional package-specific bashrc files can be created in /etc/portage/env. .TP .BR categories -A simple list of valid categories that may be used in /usr/portage, -PORTDIR_OVERLAY, and PKGDIR (see \fBmake.conf\fR(5)). This allows for custom +A simple list of valid categories that may be used in /usr/portage, +PORTDIR_OVERLAY, and PKGDIR (see \fBmake.conf\fR(5)). This allows for custom categories to be created. .I Format: @@ -572,11 +572,11 @@ Contains variables customizing colors. See \fBcolor.map\fR(5). The global custom settings for Portage. See \fBmake.conf\fR(5). .TP .BR mirrors -Whenever portage encounters a mirror:// style URI it will look up the actual -hosts here. If the mirror set is not found here, it will check the global -mirrors file at /usr/portage/profiles/thirdpartymirrors. You may also set a -special mirror type called "local". This list of mirrors will be checked -before GENTOO_MIRRORS and will be used even if the package has +Whenever portage encounters a mirror:// style URI it will look up the actual +hosts here. If the mirror set is not found here, it will check the global +mirrors file at /usr/portage/profiles/thirdpartymirrors. You may also set a +special mirror type called "local". This list of mirrors will be checked +before GENTOO_MIRRORS and will be used even if the package has RESTRICT="mirror" or RESTRICT="fetch". .I Format: @@ -654,8 +654,8 @@ three special tokens: .fi .I Additional Note: -If you encounter the \fB-*\fR KEYWORD, this indicates that the package is known -to be broken on all systems which are not otherwise listed in KEYWORDS. For +If you encounter the \fB-*\fR KEYWORD, this indicates that the package is known +to be broken on all systems which are not otherwise listed in KEYWORDS. For example, a binary only package which is built for x86 will look like: games-fps/quake3-demo-1.11.ebuild:KEYWORDS="-* x86" @@ -735,15 +735,15 @@ a single package. .fi .TP .BR package.unmask -Just like package.mask above, except here you list packages you want to -unmask. Useful for overriding the global package.mask file (see -above). Note that this does not override packages that are masked via +Just like package.mask above, except here you list packages you want to +unmask. Useful for overriding the global package.mask file (see +above). Note that this does not override packages that are masked via KEYWORDS. .TP .BR package.use -Per\-package USE flags. Useful for tracking local USE flags or for -enabling USE flags for certain packages only. Perhaps you develop GTK -and thus you want documentation for it, but you don't want +Per\-package USE flags. Useful for tracking local USE flags or for +enabling USE flags for certain packages only. Perhaps you develop GTK +and thus you want documentation for it, but you don't want documentation for QT. Easy as pie my friend! .I Format: @@ -1040,7 +1040,7 @@ profile\-formats = portage-2 .RE .TP .BR /usr/portage/profiles/ -Global Gentoo settings that are controlled by the developers. To override +Global Gentoo settings that are controlled by the developers. To override these settings, you can use the files in \fB/etc/portage/\fR. .RS .TP @@ -1060,7 +1060,7 @@ sparc .fi .TP .BR categories -A simple list of valid categories that may be used in /usr/portage, +A simple list of valid categories that may be used in /usr/portage, PORTDIR_OVERLAY, and PKGDIR (see \fBmake.conf\fR(5)). .I Format: @@ -1130,10 +1130,10 @@ net-analyzer/netcat -* .fi .TP .BR package.mask -This contains a list of DEPEND atoms for packages that should not be installed -in any profile. Useful for adding the latest KDE betas and making sure no -one accidentally upgrades to them. Also useful for quickly masking specific -versions due to security issues. ALWAYS include a comment explaining WHY the +This contains a list of DEPEND atoms for packages that should not be installed +in any profile. Useful for adding the latest KDE betas and making sure no +one accidentally upgrades to them. Also useful for quickly masking specific +versions due to security issues. ALWAYS include a comment explaining WHY the package has been masked and WHO is doing the masking. .I Format: @@ -1153,7 +1153,7 @@ package has been masked and WHO is doing the masking. .fi .TP .BR profiles.desc -List all the current stable and development profiles. If a profile is listed +List all the current stable and development profiles. If a profile is listed here, then it will be checked by repoman. .I Format: .nf @@ -1179,7 +1179,7 @@ hyphen. If the repo\-name attribute is specified in layout.conf, then that setting will take precedence. .TP .BR thirdpartymirrors -Controls the mapping of mirror:// style URIs to actual lists of +Controls the mapping of mirror:// style URIs to actual lists of mirrors. Keeps us from overloading a single server. .I Format: @@ -1200,7 +1200,7 @@ kernel http://www.kernel.org/pub http://www.us.kernel.org/pub .fi .TP .BR use.desc -All global USE flags must be listed here with a description of what they do. +All global USE flags must be listed here with a description of what they do. .I Format: .nf @@ -1216,7 +1216,7 @@ doc \- Adds extra documentation .fi .TP .BR use.local.desc -All local USE flags are listed here along with the package and a +All local USE flags are listed here along with the package and a description. This file is automatically generated from the metadata.xml files that are included with each individual package. Refer to GLEP 56 for further information: @@ -1238,7 +1238,7 @@ games\-emulation/xmess:net \- Adds network support .RS .TP .BR make.globals -The global default settings for Portage. This comes from the portage package +The global default settings for Portage. This comes from the portage package itself. Settings in \fBmake.conf\fR or \fBpackage.env\fR override values set here. The format is described extensively in \fBmake.conf\fR(5). .TP @@ -1290,12 +1290,12 @@ directories have been modified since being installed. Files which have not been modified will automatically be unmerged. .TP .BR world -Every time you emerge a package, the package that you requested is -recorded here. Then when you run `emerge world \-up`, the list of -packages is read from this file. Note that this does not mean that the -packages that were installed as dependencies are listed here. For -example, if you run `emerge mod_wsgi` and you do not have apache -already, then "www\-apache/mod_wsgi" is recorded in the world file but +Every time you emerge a package, the package that you requested is +recorded here. Then when you run `emerge world \-up`, the list of +packages is read from this file. Note that this does not mean that the +packages that were installed as dependencies are listed here. For +example, if you run `emerge mod_wsgi` and you do not have apache +already, then "www\-apache/mod_wsgi" is recorded in the world file but "www\-servers/apache" is not. For more information, review \fBemerge\fR(1). .I Format: diff --git a/man/quickpkg.1 b/man/quickpkg.1 index 0d30163..a3f6165 100644 --- a/man/quickpkg.1 +++ b/man/quickpkg.1 @@ -7,16 +7,16 @@ quickpkg \- creates portage packages .I quickpkg can be utilized to quickly create a package for portage by utilizing the files already on your filesystem. This package -then can be emerged on any system. To review syntax for +then can be emerged on any system. To review syntax for emerging binary packages, review \fBemerge\fR(1). The upside -of this process is that you don't have to wait for the package -to unpack, configure, compile, and install before you can have -the package ready to go. The downside is that the package will -contain the files that exist on your filesystem even if they have +of this process is that you don't have to wait for the package +to unpack, configure, compile, and install before you can have +the package ready to go. The downside is that the package will +contain the files that exist on your filesystem even if they have modified since they were first installed. .br -The packages, after being created, will be placed in \fBPKGDIR\fR. -This variable is defined in \fBmake.conf\fR(5) and defaults to +The packages, after being created, will be placed in \fBPKGDIR\fR. +This variable is defined in \fBmake.conf\fR(5) and defaults to /usr/portage/packages. .SH OPTIONS .TP diff --git a/man/xpak.5 b/man/xpak.5 index 6e3d03d..536810d 100644 --- a/man/xpak.5 +++ b/man/xpak.5 @@ -47,7 +47,7 @@ String \fI"STOP"\fR. || |<---xpak---->|"STOP" -Here you see the \fItar\fR archive, the attached \fIxpak\fR blob, the +Here you see the \fItar\fR archive, the attached \fIxpak\fR blob, the \fIxpak_offset\fR and the string \fI"STOP"\fR at the end. This metadata is not considered "part" of the \fIxpak\fR, but rather part of the binpkg.