From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 0A4E5158094 for ; Wed, 20 Jul 2022 03:38:25 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id B9ABDE0895; Wed, 20 Jul 2022 03:38:23 +0000 (UTC) Received: from smtp.gentoo.org (woodpecker.gentoo.org [140.211.166.183]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 9B7D0E0895 for ; Wed, 20 Jul 2022 03:38:23 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 7841D340E98 for ; Wed, 20 Jul 2022 03:38:22 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id A3431542 for ; Wed, 20 Jul 2022 03:38:20 +0000 (UTC) From: "Sam James" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Sam James" Message-ID: <1658288297.135a1640916719ba8de5ad5f4fc00435ee96dea8.sam@gentoo> Subject: [gentoo-commits] proj/portage:master commit in: man/ X-VCS-Repository: proj/portage X-VCS-Files: man/ebuild.1 X-VCS-Directories: man/ X-VCS-Committer: sam X-VCS-Committer-Name: Sam James X-VCS-Revision: 135a1640916719ba8de5ad5f4fc00435ee96dea8 X-VCS-Branch: master Date: Wed, 20 Jul 2022 03:38:20 +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-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: dd3a0df2-12a4-433c-9a83-e51c581a9e29 X-Archives-Hash: f4db4fe42ba235f19b9a06caf3469741 commit: 135a1640916719ba8de5ad5f4fc00435ee96dea8 Author: Sam James gentoo org> AuthorDate: Wed Jul 20 03:34:43 2022 +0000 Commit: Sam James gentoo org> CommitDate: Wed Jul 20 03:38:17 2022 +0000 URL: https://gitweb.gentoo.org/proj/portage.git/commit/?id=135a1640 ebuild.1: sort phase order references; mention explicit phase names Signed-off-by: Sam James gentoo.org> man/ebuild.1 | 35 +++++++++++++++++++++-------------- 1 file changed, 21 insertions(+), 14 deletions(-) diff --git a/man/ebuild.1 b/man/ebuild.1 index 5893c3df6..113d04092 100644 --- a/man/ebuild.1 +++ b/man/ebuild.1 @@ -35,7 +35,8 @@ Shows a condensed form of this man page along with a lot of package specific information. .TP .BR setup -Runs all package-specific setup actions and exotic system checks. +Runs all package-specific setup actions (by running the \fIpkg_setup()\fR +function specified in the ebuild file) and exotic system checks. .TP .BR clean Cleans the temporary build directory that Portage has created for @@ -116,13 +117,10 @@ 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 by running the \fIsrc_test()\fR function +specified in the ebuild file to verify that everything was built properly. .TP -.BR preinst -Runs package-specific actions that need to be done before the package -is installed into the live filesystem. -.TP .BR install Installs the package to the temporary \fIinstall directory\fR by running the \fIsrc_install()\fR function. When completed, the @@ -130,13 +128,19 @@ the \fIsrc_install()\fR function. When completed, the will contain all the files that should either be merged to the local filesystem or included in a binary package. .TP +.BR preinst +Runs package-specific actions (by running the \fIpkg_preinst()\fR +function specified in the ebuild file) that need to be done before the package +is installed into the live filesystem. +.TP .BR instprep Performs the additional post-install/pre-merge preparations inside the temporary \fIinstall directory\fR. This is intended to be called \fBafter\fR building binary package but before executing \fBpreinst\fR. .TP .BR postinst -Runs package-specific actions that need to be done after the package +Runs package-specific actions (by running the \fIpkg_postinst()\fR +function specified in the ebuild file) that need to be done after the package is installed into the live filesystem. Usually helpful messages are shown here. .TP @@ -167,22 +171,25 @@ then unmerge the old one. In fact, this is the recommended package upgrade method. .TP .BR prerm -Runs package-specific actions that need to be executed before the package is -removed from the filesystem. See also \fIunmerge\fR. +Runs package-specific actions (by running the \fIpkg_prerm()\fR +function specified in the ebuild file) that need to be executed before the +package is removed from the filesystem. See also \fIunmerge\fR. .TP .BR postrm -Runs package-specific actions that need to be executed after the package is -removed from the filesystem. See also \fIunmerge\fR. +Runs package-specific actions (by running the \fIpkg_postrm()\fR +function specified in the ebuild file) that need to be executed after the +package is removed from the filesystem. See also \fIunmerge\fR. .TP .BR config -Runs package-specific actions that need to be executed after the emerge +Runs package-specific actions (by running the \fIpkg_config()\fR +function specified in the ebuild file) that need to be executed after the emerge process has completed. This usually entails setup of configuration files or other similar setups that the user may wish to run. .TP .BR package This command is a lot like the \fImerge\fR command, except that after -fetching, unpacking, compiling and installing, a .tbz2 binary package -tarball is created and stored in \fBPKGDIR\fR (see \fBmake.conf\fR(5)). +fetching, unpacking, compiling and installing, a .gpkg.tar or .tbz2 binary +package tarball is created and stored in \fBPKGDIR\fR (see \fBmake.conf\fR(5)). .TP .BR rpm Builds a RedHat RPM package from the files in the temporary