commit: 8c1f63c638ff670a5784e5a7d63d35048f767c78 Author: Aaron Bauman <bman <AT> gentoo <DOT> org> AuthorDate: Mon Dec 7 01:05:47 2020 +0000 Commit: Aaron Bauman <bman <AT> gentoo <DOT> org> CommitDate: Mon Dec 7 01:09:01 2020 +0000 URL: https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=8c1f63c6
eclass/db-use: Fix EclassDocError * Multiple tags and comments added * Some functions could use better @USAGE * CVS shows pauldv <AT> gentoo.org as the original committer to the tree. As such, he is now listed as the author of the eclass [1] * Assign to maintainer-needed as the eclass is still in use by several packages [1]: https://sources.gentoo.org/cgi-bin/viewvc.cgi/gentoo-x86/eclass/db-use.eclass?view=log Signed-off-by: Aaron Bauman <bman <AT> gentoo.org> eclass/db-use.eclass | 36 +++++++++++++++++++++++++++--------- 1 file changed, 27 insertions(+), 9 deletions(-) diff --git a/eclass/db-use.eclass b/eclass/db-use.eclass index 83ae94799ca..3f58b7a381b 100644 --- a/eclass/db-use.eclass +++ b/eclass/db-use.eclass @@ -1,8 +1,15 @@ -# Copyright 1999-2018 Gentoo Foundation +# Copyright 1999-2020 Gentoo Authors # Distributed under the terms of the GNU General Public License v2 -# This is a common location for functions that aid the use of sys-libs/db -# -# Bugs: maintainer-nee...@gentoo.org + +# @ECLASS: db-use.eclass +# @MAINTAINER: +# maintainer-nee...@gentoo.org +# @AUTHOR: +# Paul de Vrieze <pau...@gentoo.org> +# @SUPPORTED_EAPIS: 0 1 2 3 4 5 6 +# @BLURB: functions that aid the use of sys-libs/db +# @DESCRIPTION: +# functions that aid in the use of sys-libs/db # multilib is used for get_libname in all EAPI case "${EAPI:-0}" in @@ -10,7 +17,10 @@ case "${EAPI:-0}" in *) inherit multilib ;; esac -#Convert a version to a db slot +# @FUNCTION: db_ver_to_slot +# @USAGE: <version> +# @DESCRIPTION: +# Convert a version to a db slot db_ver_to_slot() { if [ $# -ne 1 ]; then eerror "Function db_ver_to_slot needs one argument" >&2 @@ -28,7 +38,10 @@ db_ver_to_slot() { echo -n "$1" } -#Find the version that correspond to the given atom +# @FUNCTION: db_findver +# @USAGE: <atom> +# @DESCRIPTION: +# Find the version that corresponds to the given atom db_findver() { has "${EAPI:-0}" 0 1 2 && ! use prefix && EPREFIX= if [ $# -ne 1 ]; then @@ -52,6 +65,9 @@ db_findver() { fi } +# @FUNCTION: db_includedir +# @USAGE: <version> +# @DESCRIPTION: # Get the include dir for berkeley db. # This function has two modes. Without any arguments it will give the best # version available. With arguments that form the versions of db packages @@ -71,7 +87,7 @@ db_includedir() { return 1 fi else - #arguments given + # arguments given for x in $@ do if VER=$(db_findver "=sys-libs/db-${x}*") && @@ -85,7 +101,9 @@ db_includedir() { fi } - +# @FUNCTION: db_libname +# @USAGE: <version> +# @DESCRIPTION: # Get the library name for berkeley db. Something like "db-4.2" will be the # outcome. This function has two modes. Without any arguments it will give # the best version available. With arguments that form the versions of db @@ -103,7 +121,7 @@ db_libname() { return 1 fi else - #arguments given + # arguments given for x in $@ do if VER=$(db_findver "=sys-libs/db-${x}*"); then
