summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichał Górny <mgorny@gentoo.org>2020-12-28 10:12:24 +0100
committerMichał Górny <mgorny@gentoo.org>2020-12-28 10:31:30 +0100
commit2f653f03c381cd6c4b1c7fc3aa7b25901fc8b47f (patch)
treebf4a87d73bd7f963bb8cfbea36d492599cbc4147 /eclass/alternatives.eclass
parentdev-ruby/racc: avoid dep on bundler (diff)
downloadgentoo-2f653f03c381cd6c4b1c7fc3aa7b25901fc8b47f.tar.gz
gentoo-2f653f03c381cd6c4b1c7fc3aa7b25901fc8b47f.tar.bz2
gentoo-2f653f03c381cd6c4b1c7fc3aa7b25901fc8b47f.zip
eclass: [QA] Revert multiple meaningless doc changes
Revert multiple meaningless eclass documentation changes, notably adding a lot of placeholders and documenting implementation details. These changes were aimed at silencing (valid) documentation warnings without actually providing valuable documentation to the end users. While some of these changes were beneficial, it would take a lot of effort to review them all and the author is unwilling to fix his mistakes. Signed-off-by: Michał Górny <mgorny@gentoo.org>
Diffstat (limited to 'eclass/alternatives.eclass')
-rw-r--r--eclass/alternatives.eclass11
1 files changed, 2 insertions, 9 deletions
diff --git a/eclass/alternatives.eclass b/eclass/alternatives.eclass
index 108a55af8112..79f14d81b134 100644
--- a/eclass/alternatives.eclass
+++ b/eclass/alternatives.eclass
@@ -2,8 +2,6 @@
# Distributed under the terms of the GNU General Public License v2
# @ECLASS: alternatives.eclass
-# @MAINTAINER:
-# maintainer-needed@gentoo.org
# @AUTHOR:
# Original author: Alastair Tse <liquidx@gentoo.org> (03 Oct 2003)
# @BLURB: Creates symlink to the latest version of multiple slotted packages.
@@ -74,17 +72,14 @@ alternatives_auto_makesym() {
alternatives_makesym ${SYMLINK} ${ALT}
}
-# @FUNCTION: alternatives_makesym
-# @USAGE: alternatives_makesym <resulting symlink> [alternative targets..]
-# @DESCRIPTION:
-# make sure it is in the prefix, allow it already to be in the prefix
-
alternatives_makesym() {
has "${EAPI:-0}" 0 1 2 && ! use prefix && EPREFIX=
local ALTERNATIVES=""
local SYMLINK=""
local alt pref
+ # usage: alternatives_makesym <resulting symlink> [alternative targets..]
+ # make sure it is in the prefix, allow it already to be in the prefix
SYMLINK=${EPREFIX}/${1#${EPREFIX}}
# this trick removes the trailing / from ${ROOT}
pref=${ROOT%/}
@@ -129,7 +124,6 @@ alternatives_makesym() {
# @FUNCTION: alernatives-pkg_postinst
# @DESCRIPTION:
# The alternatives pkg_postinst, this function will be exported
-
alternatives_pkg_postinst() {
if [ -n "${ALTERNATIVES}" -a -n "${SOURCE}" ]; then
alternatives_makesym ${SOURCE} ${ALTERNATIVES}
@@ -139,7 +133,6 @@ alternatives_pkg_postinst() {
# @FUNCTION: alternatives_pkg_postrm
# @DESCRIPTION:
# The alternatives pkg_postrm, this function will be exported
-
alternatives_pkg_postrm() {
if [ -n "${ALTERNATIVES}" -a -n "${SOURCE}" ]; then
alternatives_makesym ${SOURCE} ${ALTERNATIVES}