Update pkgtools/pkgtasks to version 1.13.

* Add a "icon_themes" task to cache GTK+ icon theme directories.
* Change the way that install-info(1) is invoked.
* Clarify the output from the "groups" and "users" tasks.
* Bug fixes.


(jlam)

Package Tasks
=============


Changes in version 1.13
-----------------------
**Released on 2017-08-08.**

* Make the output messages for the `groups` and `users` tasks easier
  to understand by making them slightly more verobse and changing
  the formatting.


Changes in version 1.12
-----------------------
**Released on 2017-08-06.**

* Use `${GTK_UPDATE_ICON_CACHE}` as the default command to update
  the GTK+ icon theme caches in the `icon_themes` task,
  defaulting to `true` if it is not set in the environment.  Also
  force an update of the icon caches from the `postremove`
  meta-task in case the icon theme is a composite of several
  packages.  This makes the behavior more compatible with **pkgsrc**.

* Bug fixes.


Changes in version 1.11
-----------------------
**Released on 2017-07-31.**

* Invoke `install-info` in a different way that matches how it is
  typically invoked in GNU projects.

* Add `icon_themes` task to update GTK+ icon theme caches.

* Bug fixes.


Changes in version 1.10
-----------------------
**Released on 2017-06-03.**

* Modify `Makefile.am` to always use the same pathname to refer to a
  built object.  This fixes the dependency graph in the case where
  `make` is invoked to run with multiple jobs.

* Change the output of the `directories` and `files` tasks to be
  less verbose in the most common case where a directory is
  created or a file is copied and permissions are immediately set
  on the directory or file.


Changes in version 1.9
----------------------
**Released on 2017-05-31.**

* Adapt `directories` and `files` tasks to unconditionally set
  permissions when new objects are created, and to not throw
  errors if the object is missing because it wasn't created in
  an earlier step.  This makes the behavior more compatible with
  **pkgsrc**.

* Depending on the values of certain environment variables, certain
  *add* or *remove* actions may not actually perform operations that
  change the system and still return successfully.  Always run the
  "check" actions for the corresponding main action so that any
  warning messages intended for the user are written to standard
  output.

* Make the `shlibs` task output more descriptive.


Changes in version 1.8
----------------------
**Released on 2017-05-29.**

* Change the output of the actions taken by each task, by being
  slightly more brief, and also accepting an environment variable
  `${TASK_MSG}` as the prefix string for each line of output.

* Bug fixes.


Changes in version 1.7
----------------------
**Released on 2017-05-29.**

* Back out two changes to make **pkgtasks** more compatible with
  what **pkgsrc** needs:

  - Don't use `OCAML_FINDLIB_REGISTER` environment variable since
    it is a package-settable variable in **pkgsrc**, not a user-
    settable one.

  - Don't use `PKG_CONFIG_PERMS` environment variable in the
    `permissions` task, which matches its usage in **pkgrsc**


Changes in version 1.6
----------------------
**Released on 2017-05-27.**

* Adjust `fonts` task to run `mkfontdir` on TTF and Type1 font
  directories automatically.

* Rename control variable `PKG_RCD_SCRIPTS` to `PKG_INIT_SCRIPTS`.
  This generalizes the variable name to allow for other init
  systems.

* Check `${PKG_CONFIG_PERMS}` in the `permissions` task.

* Make the `shlibs` task accept `LDCONFIG_ADD_CMD` and
  `LDCONFIG_REMOVE_CMD` as separate command lines to update the
  shared library cache depending on whether the task is called to
  *add* or *remove*.  The default action is still to invoke a bare
  `${LDCONFIG}` command.

* Adjust the `shlibs` task to accept standard input and to only
  update the cache if there are lines of the correct format.

* Fix `preinstall` meta-task to fail properly if groups and/or
  users don't exist.

* Add `platform` task to write the name of the platform or
  operating system to standard output.

* Automatically load the platform-specific module with the correct
  `platform_groupadd` and `platform_useradd` functions.

* Bug fixes and cleanup.


Changes in version 1.5
----------------------
**Released on 2017-05-17.**

* Support `~[string]` (tilde string) in a version string to sort
  before a release version, e.g., 1.2~rc1 sorts before 1.2.

* When invoking a meta-task, only be verbose when invoking tasks
  that typically affect system files and directories.  This
  makes the output a bit more friendly for the typicaly user,
  who is no longer bombarded with every trivial GNU info file
  registration.

* Bug fixes.


Changes in version 1.4
----------------------
**Released on 2017-05-14.**

* Allow duplicate logging of task output to a file through the
  `echo` task.

* Added `tee` task to duplicate standard input to standard output
  and into additional files.


Changes in version 1.3
----------------------
**Released on 2017-05-13.**

* Generalized refcount API so the refcount-file implementation
  may be deprecated in the future.

* Added option to suppress duplicate lines to the `sort` task.

* Added `valid_options` task to simplify checking for valid flags.

* Added `function` task as a generic hook for user-written tasks
  into the `preinstall`, `postinstall`, `preremove`, and
  `postremove` meta-tasks.

* Bug fixes.


Changes in version 1.2
----------------------
**Released on 2017-05-07.**

* Be more consistent with using `maketemp` to generate internal
  temporary files and directories.

* Added the `sort` task to sort lines from standard input.

* Sort input when performing `add` action of `directories` task,
  and reverse sort when performing `remove` action.  This causes
  path components to be created and removed in the correct order.


Changes in version 1.1
----------------------

**Released on 2017-05-05**

* Added the `which` task to locate a program in the search path.

* Changed the `fonts` task to search for indexing commands in the
  search path before falling back to defaults.  This makes the
  task more resilient to differences in how the X11 directories
  are laid out across different systems.

* Be more consistent with preserving standard error from commands
  used to perform tasks so that errors are visible for logging and
  debugging purposes.


Changes in version 1.0
----------------------

**Released on 2017-05-03**

* Initial release of pkgtasks-1-1.0.

# Copyright (c) 2017 The NetBSD Foundation, Inc.
# All rights reserved.
#
# This code is derived from software contributed to The NetBSD Foundation
# by Johnny C. Lam.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions
# are met:
# 1. Redistributions of source code must retain the above copyright
#    notice, this list of conditions and the following disclaimer.
# 2. Redistributions in binary form must reproduce the above copyright
#    notice, this list of conditions and the following disclaimer in the
#    documentation and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
# PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
#
# NAME
#	icon_themes.subr -- icon theme cache management for packages
#
# SYNOPSIS
#	task_icon_themes [-s] add | remove <stage>
#
# DESCRIPTION
#	The task_icon_themes function supports two actions, "add" and
#	"remove", that will add or remove the GTK+ icon caches from the
#	theme directories.
#
#	The available options are as follows:
#
#	-s	Silent; don't write to standard output.
#
#	The task_icon_themes function reads standard input line by line
#	and looks for lines of the form:
#
#	    # ICON_THEME: <themedir>
#
#	If the path to the theme directory is relative, then it is assumed
#	to be relative to ${PKG_PREFIX}/share/icons.
#
# RETURN VALUES
#	Returns 0 if the action is successful for all icon themes, and >0
#	if an error occurs.
#
# ENVIRONMENT
#	The following variables are used if they are set:
#
#	GTK_UPDATE_ICON_CACHE
#		The name or path to the GTK+ command to update the icon
#		caches.  This is the fall-through default command if
#		neither of the other two gtk-update-icon-cache(1)
#		commands exist on the system.
#
#	GTK2_UPDATE_ICON_CACHE
#		The name or path to the GTK+-2.x command to update the
#		icon caches.
#
#	GTK3_UPDATE_ICON_CACHE
#		The name or path to the GTK+-3.x command to update the
#		icon caches.
#
#	PKGNAME
#		The name of the package.
#
#	PKG_DESTDIR
#		A "destdir" prefix that is prepended to all filesystem
#		paths.  The default value is the empty string.
#
#	PKG_PREFIX
#		The installation prefix of the package.  The default is
#		"/usr/pkg".
#
#	RM	The name or path to the rm(1) utility.
#
#	TASK_MSG
#		String prepended to all normal message written to
#		standard output.
#

__task_icon_themes__="yes"

task_load echo
task_load which

task_icon_themes()
{
	: ${RM:=rm}

	: ${PKG_PREFIX:=/usr/pkg}
	: ${PKGNAME:=${0##*/}}
	: ${TASK_MSG:=""}

	local arg
	local echo="task_echo"
	local OPTIND=1
	while getopts ":s" arg "$@"; do
		case $arg in
		s)	echo=":" ;;
		*)	return 127 ;;
		esac
	done
	shift $(( ${OPTIND} - 1 ))
	[ $# -gt 0 ] || return 127

	local action="$1"; shift
	local stage="$1"

	case $action in
	add|remove)
		: "valid action" ;;
	*)	return 0 ;;
	esac

	# Guard against ${PKG_PREFIX} == "/".
	local prefix
	case ${PKG_PREFIX}/ in
	//)	prefix= ;;
	*)	prefix=${PKG_PREFIX} ;;
	esac

	local result=0
	local hash tag themedir
	local theme cache update_cmd
	while read hash tag themedir; do
		# Filter for "# ICON_THEME:"
		case $hash/$tag in
		"#/ICON_THEME:")
			: "use this line" ;;
		*)	continue ;;
		esac

		# Canonicalize paths.
		case $themedir in
		"")	# skip lines without required args
			continue ;;
		[!/]*)	themedir="$prefix/share/icons/$themedir" ;;
		esac
		themedir="${PKG_DESTDIR}$themedir"
		theme="$themedir/index.theme"
		cache="$themedir/icon-theme.cache"

		case "$action,$stage" in
		remove,postremove)
			: "avoid double removal of icon caches" ;;
		remove,*)
			if [ ! -f "$cache" ]; then
				$echo "${TASK_MSG}> icon cache already removed: $themedir"
			elif ${RM} -f "$cache"; then
				$echo "${TASK_MSG}> icon cache removed: $themedir"
			else
				$echo "${TASK_MSG}! icon cache not removed: $themedir"
				result=1
			fi ;;
		esac

		# Update the icon caches during "add" action, but also during
		# "remove" action at "postremove" stage if the theme directories
		# still exist.
		#
		case "$action,$stage" in
		add,*|remove,postremove)
			# Set the command used to update the icon caches.
			_task_icon_themes_cache_update_cmd
			if [ "$__task_icon_themes_update_cmd__" != "missing" ]; then
				update_cmd="$__task_icon_themes_update_cmd__"
			fi
			: ${update_cmd:=${GTK_UPDATE_ICON_CACHE:-true}}

			if [ ! -f "$theme" ]; then
				case $action in
				add)	$echo "${TASK_MSG}! icon theme missing: $themedir"
					result=1 ;;
				remove)	: "silently skip updating" ;;
				esac
			elif [ -z "$update_cmd" ]; then
				$echo "${TASK_MSG}! icon theme not cached - missing command: $themedir"
				result=1
			elif $update_cmd -f -q "$themedir"; then
				$echo "${TASK_MSG}> icon theme cached: $themedir"
			else
				$echo "${TASK_MSG}! icon theme not cached: $themedir"
				result=1
			fi ;;
		esac
	done
	return $result
}

_task_icon_themes_cache_update_cmd()
{
	: ${GTK2_UPDATE_ICON_CACHE:=gtk2-update-icon-cache}
	: ${GTK3_UPDATE_ICON_CACHE:=gtk-update-icon-cache}

	# Cache gtk-update-icon-cache(1) location.
	if [ -z "$__task_icon_themes_update_cmd__" ]; then
		local cmd
		for cmd in \
			"${GTK3_UPDATE_ICON_CACHE}" \
			"${GTK2_UPDATE_ICON_CACHE}"
		do
			[ -n "$cmd" ] || continue
			__task_icon_themes_update_cmd__=$( task_which "$cmd" )
			[ -z "$__task_icon_themes_update_cmd__" ] || break
		done
		[ -n "$__task_icon_themes_update_cmd__" ] ||
			__task_icon_themes_update_cmd__="missing"
	fi
}

# Static variable for the path to the command that updates the icon cache.
__task_icon_themes_update_cmd__=