[gentoo-commits] gentoo-x86 commit in eclass: ChangeLog portability.eclass

[gentoo-commits] gentoo-x86 commit in eclass: ChangeLog portability.eclass

[Justin Lecher (jlec)]

jlec        14/05/28 09:48:01

  Modified:             ChangeLog portability.eclass
  Log:
  Add documentation for man page; add missing die

Revision  Changes    Path
1.1276               eclass/ChangeLog

file : http://sources.gentoo.org/viewvc.cgi/gentoo-x86/eclass/ChangeLog?rev=1.1276&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo-x86/eclass/ChangeLog?rev=1.1276&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo-x86/eclass/ChangeLog?r1=1.1275&r2=1.1276

Index: ChangeLog
===================================================================
RCS file: /var/cvsroot/gentoo-x86/eclass/ChangeLog,v
retrieving revision 1.1275
retrieving revision 1.1276
diff -u -r1.1275 -r1.1276
--- ChangeLog	26 May 2014 17:20:14 -0000	1.1275
+++ ChangeLog	28 May 2014 09:48:01 -0000	1.1276
@@ -1,6 +1,9 @@
 # ChangeLog for eclass directory
 # Copyright 1999-2014 Gentoo Foundation; Distributed under the GPL v2
-# $Header: /var/cvsroot/gentoo-x86/eclass/ChangeLog,v 1.1275 2014/05/26 17:20:14 mgorny Exp $
+# $Header: /var/cvsroot/gentoo-x86/eclass/ChangeLog,v 1.1276 2014/05/28 09:48:01 jlec Exp $
+
+  28 May 2014; Justin Lecher <jlec@gentoo.org> portability.eclass:
+  Add documentation for man page; add missing die
 
   26 May 2014; Michał Górny <mgorny@gentoo.org>
   +gnome-python-common-r1.eclass:



1.25                 eclass/portability.eclass

file : http://sources.gentoo.org/viewvc.cgi/gentoo-x86/eclass/portability.eclass?rev=1.25&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo-x86/eclass/portability.eclass?rev=1.25&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo-x86/eclass/portability.eclass?r1=1.24&r2=1.25

Index: portability.eclass
===================================================================
RCS file: /var/cvsroot/gentoo-x86/eclass/portability.eclass,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- portability.eclass	4 Jan 2012 05:57:19 -0000	1.24
+++ portability.eclass	28 May 2014 09:48:01 -0000	1.25
@@ -1,18 +1,21 @@
-# Copyright 1999-2011 Gentoo Foundation
+# Copyright 1999-2014 Gentoo Foundation
 # Distributed under the terms of the GNU General Public License v2
-# $Header: /var/cvsroot/gentoo-x86/eclass/portability.eclass,v 1.24 2012/01/04 05:57:19 vapier Exp $
-#
-# Author: Diego Pettenò <flameeyes@gentoo.org>
-#
-# This eclass is created to avoid using non-portable GNUisms inside ebuilds
-#
-# NB:  If you add anything, please comment it!
+# $Header: /var/cvsroot/gentoo-x86/eclass/portability.eclass,v 1.25 2014/05/28 09:48:01 jlec Exp $
+
+# @ECLASS: portability.eclass
+# @MAINTAINER:
+# base-system@gentoo.org
+# @AUTHOR:
+# Diego Pettenò <flameeyes@gentoo.org>
+# @BLURB: This eclass is created to avoid using non-portable GNUisms inside ebuilds
 
 if [[ ${___ECLASS_ONCE_PORTABILITY} != "recur -_+^+_- spank" ]] ; then
 ___ECLASS_ONCE_PORTABILITY="recur -_+^+_- spank"
 
-# treecopy orig1 orig2 orig3 .... dest
-#
+# @FUNCTION: treecopy
+# @USAGE: <orig1> [orig2 orig3 ....] <dest>
+# @RETURN:
+# @DESCRIPTION:
 # mimic cp --parents copy, but working on BSD userland as well
 treecopy() {
 	local dest=${!#}
@@ -20,21 +23,23 @@
 
 	while (( $# > 1 )); do
 		local dirstruct=$(dirname "$1")
-		mkdir -p "${dest}/${dirstruct}"
-		cp -pPR "$1" "${dest}/${dirstruct}"
+		mkdir -p "${dest}/${dirstruct}" || die
+		cp -pPR "$1" "${dest}/${dirstruct}" || die
 
 		shift
 	done
 }
 
-# seq min max
-#
+# @FUNCTION: seq
+# @USAGE: [min] <max> [step]
+# @RETURN: sequence from min to max regardless of seq command being present on system
+# @DESCRIPTION:
 # compatibility function that mimes seq command if not available
 seq() {
 	# First try `seq`
 	local p=$(type -P seq)
 	if [[ -n ${p} ]] ; then
-		"${p}" "$@"
+		"${p}" "$@" || die
 		return $?
 	fi
 
@@ -57,7 +62,7 @@
 			reps=0
 		fi
 
-		jot $reps $min $max $step
+		jot $reps $min $max $step || die
 		return $?
 	fi
 
@@ -71,6 +76,10 @@
 	return 0
 }
 
+# @FUNCTION: dlopen_lib
+# @USAGE:
+# @RETURN: linker flag if needed
+# @DESCRIPTION:
 # Gets the linker flag to link to dlopen() function
 dlopen_lib() {
 	# - Solaris needs nothing
@@ -85,6 +94,10 @@
 	esac
 }
 
+# @FUNCTION: get_bmake
+# @USAGE:
+# @RETURN: system version of make
+# @DESCRIPTION:
 # Gets the name of the BSD-ish make command (pmake from NetBSD)
 #
 # This will return make (provided by system packages) for BSD userlands,
@@ -103,6 +116,11 @@
 	fi
 }
 
+# @FUNCTION: get_mounts
+# @USAGE:
+# @RETURN: table of mounts in form "point node fs opts"
+# @MAINTAINER:
+# @DESCRIPTION:
 # Portable method of getting mount names and points.
 # Returns as "point node fs options"
 # Remember to convert 040 back to a space.