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.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id C09461396D9 for ; Tue, 24 Oct 2017 10:35:07 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 0D1682BC05F; Tue, 24 Oct 2017 10:35:07 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id D08ED2BC05F for ; Tue, 24 Oct 2017 10:35:06 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 85B3333BE68 for ; Tue, 24 Oct 2017 10:35:05 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id D481782E for ; Tue, 24 Oct 2017 10:35:03 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1508841230.606491574fd91b65447b4376b2b21bf092749a64.ulm@gentoo> Subject: [gentoo-commits] proj/portage:master commit in: man/ X-VCS-Repository: proj/portage X-VCS-Files: man/ebuild.5 X-VCS-Directories: man/ X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 606491574fd91b65447b4376b2b21bf092749a64 X-VCS-Branch: master Date: Tue, 24 Oct 2017 10:35:03 +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: 2804d36c-828f-4b0f-8769-7d625695c542 X-Archives-Hash: b276526d912d41419d59d5c4d6813dc2 commit: 606491574fd91b65447b4376b2b21bf092749a64 Author: Ulrich Müller gentoo org> AuthorDate: Tue Oct 24 08:48:09 2017 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Tue Oct 24 10:33:50 2017 +0000 URL: https://gitweb.gentoo.org/proj/portage.git/commit/?id=60649157 man/ebuild.5: Do not document internal functions. Functions containing "hook" or "prep" in their name may not be used or relied upon by ebuilds. Therefore they should not be documented in ebuild(5) which describes the funtions available for ebuilds. PMS reference: https://projects.gentoo.org/pms/6/pms.html#x1-14700011.3.3.16 Acked-by: Zac Medico gentoo.org> man/ebuild.5 | 76 +----------------------------------------------------------- 1 file changed, 1 insertion(+), 75 deletions(-) diff --git a/man/ebuild.5 b/man/ebuild.5 index 43d12765d..42a0599fe 100644 --- a/man/ebuild.5 +++ b/man/ebuild.5 @@ -1,4 +1,4 @@ -.TH "EBUILD" "5" "Nov 2014" "Portage VERSION" "Portage" +.TH "EBUILD" "5" "Oct 2017" "Portage VERSION" "Portage" .SH "NAME" ebuild \- the internal format, variables, and functions in an ebuild script @@ -1104,16 +1104,6 @@ Example: installed) .fi -.SS "Hooks:" -.TP -.B register_die_hook\fR \fI[list of function names] -Register one or more functions to call when the ebuild fails for any reason, -including file collisions with other packages. -.TP -.B register_success_hook\fR \fI[list of function names] -Register one or more functions to call when the ebuild builds and/or installs -successfully. - .SS "Output:" .TP .B einfo\fR \fI"disposable message" @@ -1225,70 +1215,6 @@ Please do \fBnot\fR use this in place of 'emake install DESTDIR=${D}'. That is the preferred way of installing make\-based packages. Also, do not utilize the \fIEXTRA_EINSTALL\fR variable since it is for users. -.PD 0 -.TP -.B prepall -.TP -.B prepalldocs -.TP -.B prepallinfo -.TP -.B prepallman -.TP -.B prepallstrip -.PD 1 -Useful for when a package installs into \fB${D}\fR via scripts -(i.e. makefiles). If you want to be sure that libraries are executable, -aclocal files are installed into the right place, doc/info/man files are -all compressed, and that executables are all stripped of debugging symbols, -then use these suite of functions. -.RS -.PD 0 -.TP -.B prepall: -Runs \fBprepallman\fR, \fBprepallinfo\fR, \fBprepallstrip\fR, sets -libraries +x, and then checks aclocal directories. Please note this -does \fI*not*\fR run \fBprepalldocs\fR. -.TP -.B prepalldocs: -Compresses all doc files in ${ED}/usr/share/doc. -.TP -.B prepallinfo: -Compresses all info files in ${ED}/usr/share/info. -.TP -.B prepallman: -Compresses all man files in ${ED}/usr/share/man. -.TP -.B prepallstrip: -Strips all executable files of debugging symboles. This includes libraries. -.RE - -.TP -.B prepinfo\fR \fI[dir] -.TP -.B prepman\fR \fI[dir] -.TP -.B prepstrip\fR \fI[dir] -.PD 1 -Similar to the \fBprepall\fR functions, these are subtle in their differences. -.RS -.PD 0 -.TP -.B prepinfo: -If a \fIdir\fR is not specified, then \fBprepinfo\fR will assume the dir -\fIusr\fR. \fBprepinfo\fR will then compress all the files in -${ED}/\fIdir\fR/info. -.TP -.B prepman: -If a \fIdir\fR is not specified, then \fBprepman\fR will assume the dir -\fIusr\fR. \fBprepman\fR will then compress all the files in -${ED}/\fIdir\fR/man/*/. -.TP -.B prepstrip: -All the files found in ${ED}/\fIdir\fR will be stripped. You may specify -multiple directories. -.RE -.PD 1 .TP .B docompress\fR \fI[\-x] [list of more paths] .RS