path: root/subr.rtl/rtl_install_v2.subr

#
# Copyright (c) 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023 Lucía Andrea Illanes Albornoz <lucia@luciaillanes.de>
# set +o errexit -o noglob -o nounset is assumed.
#

RTL_NL="
";

# XXX optimise
# implement %<...{...,...}...>
# support multiple %<...*...> in same spec
# split_ = unfold_
# impl 3/ 1## 1# 1%% 1%

#
# DSL functor implementation
#
# {{{ rtlp_install_v2_fmap($_rstatus, $_rparams, $_prefix, $_spec, $_fn, [$_param[...], --, [$_spec[...]]])
rtlp_install_v2_fmap() {
	local	_ri2f_rstatus="${1#\$}" _ri2f_rparams="${2#\$}" _ri2f_prefix="${3}" _ri2f_spec="${4}" _ri2f_fn="${5}"	\
		_ri2f_IFS0="${IFS:- 	}" _ri2f_paramsc=0 _ri2f_spec_cur="" _ri2f_spec_list="" _ri2f_spec0=""		\
		_ri2f_specsc=0 _ri2f_nspec=0 _ri2f_rc=0 IFS;
	shift 5;

	while [ "${#}" -gt 0 ] && [ "x${1}" != "x--" ]; do
		: $((_ri2f_paramsc+=1)); local "${_ri2f_rparams}${_ri2f_paramsc}=${1}"; shift;
	done; shift;
	while [ "${#}" -gt 0 ] && [ "x${1}" != "x--" ]; do
		: $((_ri2f_specsc+=1)); local "_ri2f_specs${_ri2f_specsc}=${1}"; shift;
	done;

	if rtlp_install_v2_fmap_params "${_ri2f_rstatus}" "${_ri2f_rparams}" \$_ri2f_spec ""\
	&& rtlp_install_v2_fmap_patterns "${_ri2f_rstatus}" "${_ri2f_rparams}" "${_ri2f_prefix}" "${_ri2f_spec}" \$_ri2f_spec_list; then
		IFS="${RTL_NL}"; for _ri2f_spec_cur in ${_ri2f_spec_list}; do
			IFS="${_ri2f_IFS0}"; set --;
			_ri2f_nspec=1; while [ "${_ri2f_nspec}" -le "${_ri2f_specsc}" ]; do
				eval _ri2f_spec0=\"\${_ri2f_specs${_ri2f_nspec}}\";
				rtlp_install_v2_fmap_params	\
					"${_ri2f_rstatus}"	\
					"${_ri2f_rparams}"	\
					\$_ri2f_spec0 "${_ri2f_spec_cur}";
				eval set -- '"${@}"' '"${_ri2f_spec0}"'; : $((_ri2f_nspec+=1));
			done;
			eval "${_ri2f_fn}" \"\$\{@\}\"; _ri2f_rc=$((${?} ? ${?} : ${_ri2f_rc}));
			[ "${_ri2f_rc}" -ne 0 ] && break;
		done; IFS="${_ri2f_IFS0}";
	else
		_ri2f_rc=1;
	fi;
	return "${_ri2f_rc}";
};
# }}}
# {{{ rtlp_install_v2_fmap_params($_rstatus, $_rparams, $_rspec, $_item)
RTLP_INSTALL_FMAP_PARAMS_LEVEL=0;
rtlp_install_v2_fmap_params() {
	local	_ri2fp_rstatus="${1#\$}" _ri2fp_rparams="${2#\$}" _ri2fp_rspec="${3#\$}" _ri2fp_item="${4}"	\
		_ri2fp_expr="" _ri2fp_expr_="" _ri2fp_expr_sub="" _ri2fp_expr_op="" _ri2fp_lhs="" _ri2fp_rc=0	\
		_ri2fp_rhs="" _ri2fp_subexpr="";
	eval _ri2fp_lhs='${'"${_ri2fp_rspec}"'}'\; ${_ri2fp_rspec}=;

	while true; do
		if ! rtlp_install_v2_splitl_ref \$_ri2fp_expr \$_ri2fp_lhs \$_ri2fp_rhs '%[' ']'; then
			eval ${_ri2fp_rspec}='${'"${_ri2fp_rspec}"'}${_ri2fp_lhs}'; break;
		else
		case "${_ri2fp_expr}" in

		[0-9]*)
			eval _ri2fp_expr='${'"${_ri2fp_rparams}${_ri2fp_expr}"'}'; ;;

		@[0-9]*)
			: $((RTLP_INSTALL_FMAP_PARAMS_LEVEL+=1));
			eval _ri2fp_expr${RTLP_INSTALL_FMAP_PARAMS_LEVEL}='${'"${_ri2fp_rparams}${_ri2fp_expr#@}"'}';
			rtlp_install_v2_fmap_params "${_ri2fp_rstatus}" "${_ri2fp_rparams}"	\
					\$_ri2fp_expr${RTLP_INSTALL_FMAP_PARAMS_LEVEL}		\
					"${_ri2fp_item}"; _ri2fp_rc="${?}";
			eval _ri2fp_expr='${_ri2fp_expr'"${RTLP_INSTALL_FMAP_PARAMS_LEVEL}"'}';
			unset '_ri2fp_expr'"${RTLP_INSTALL_FMAP_PARAMS_LEVEL}";
			: $((RTLP_INSTALL_FMAP_PARAMS_LEVEL-=1));
			[ "${_ri2fp_rc}" -eq 1 ] && break; ;;

		[_0-9a-zA-Z]*)
			case "${_ri2fp_expr}" in

			DNAME*)	_ri2fp_subexpr="${_ri2fp_expr#DNAME}"; _ri2fp_expr="${_ri2fp_item%/*}"; ;;
			FNAME*)	_ri2fp_subexpr="${_ri2fp_expr#FNAME}"; _ri2fp_expr="${_ri2fp_item##*/}"; ;;
			ITEM*)	_ri2fp_subexpr="${_ri2fp_expr#ITEM}"; _ri2fp_expr="${_ri2fp_item}"; ;;

			"")	_ri2fp_rc=1;
				rtl_setrstatus "${_ri2fp_rstatus}" 'zero-length parameter name in expression';
				;;

			*)
				_ri2fp_expr_="${_ri2fp_expr%%[!_0-9a-zA-Z]*}";
				_ri2fp_subexpr="${_ri2fp_expr#${_ri2fp_expr_}}";
				_ri2fp_expr="${_ri2fp_expr_}";
				if eval [ '"${'"${_ri2fp_rparams}${_ri2fp_expr}"':+1}"' = 1 ]; then
					eval _ri2fp_expr='${'"${_ri2fp_rparams}${_ri2fp_expr}"'}';
				else	_ri2fp_rc=1;
					rtl_setrstatus "${_ri2fp_rstatus}" 'unknown parameter name \`'"${_ri2fp_expr}"''\'' in expression';
				fi;
				;;

			esac;

			if [ "${_ri2fp_rc}" -eq 0 ]; then
				while true; do
					if ! rtlp_install_v2_splitl_subexpr	\
							\$_ri2fp_subexpr_	\
							\$_ri2fp_subexpr	\
							'## # %% %'; then
						break;
					else case "${_ri2fp_subexpr_}" in

					/*)	;;
					\#\#*)	_ri2fp_expr="${_ri2fp_expr##${_ri2fp_subexpr_#\#\#}}"; ;;
					\#*)	_ri2fp_expr="${_ri2fp_expr#${_ri2fp_subexpr_#\#}}"; ;;
					%%*)	_ri2fp_expr="${_ri2fp_expr%%${_ri2fp_subexpr_#%%}}"; ;;
					%*)	_ri2fp_expr="${_ri2fp_expr%${_ri2fp_subexpr_#%}}"; ;;

					"")	_ri2fp_rc=1;
						rtl_setrstatus "${_ri2fp_rstatus}" 'zero-length subexpression in expression';
						;;

					*)	_ri2fp_rc=1;
						rtl_setrstatus "${_ri2fp_rstatus}" 'invalid subexpression \`'"${_ri2fp_subexpr_}"''\'' in expression';
						;;

					esac; fi;
				done;
			fi; ;;

		"")	_ri2fp_rc=1;
			rtl_setrstatus "${_ri2fp_rstatus}" 'zero-length expression';
			break; ;;

		*)	_ri2fp_rc=1;
			rtl_setrstatus "${_ri2fp_rstatus}" 'invalid expression \`'"${_ri2fp_expr}"''\';
			break; ;;

		esac; fi;

		eval ${_ri2fp_rspec}='${'"${_ri2fp_rspec}"'}${_ri2fp_lhs}${_ri2fp_expr}'; _ri2fp_lhs="${_ri2fp_rhs}";
	done;

	return "${_ri2fp_rc}";
};
# }}}
# {{{ rtlp_install_v2_fmap_patterns($_rstatus, $_rparams, $_prefix, $_spec, $_rspec_list)
rtlp_install_v2_fmap_patterns() {
	local	_ri2fp2_rstatus="${1#\$}" _ri2fp2_rparams="${2#\$}" _ri2fp2_prefix="${3}"	\
		_ri2fp2_spec="${4}" _ri2fp2_rspec_list="${5#\$}"				\
		_ri2fp2_expr="" _ri2fp2_lhs="" _ri2fp2_rc=0 _ri2fp2_rhs=""			\
		IFS="${RTL_NL}";
	_ri2fp2_lhs="${_ri2fp2_spec}";

	while true; do
		if rtlp_install_v2_splitl_ref \$_ri2fp2_expr \$_ri2fp2_lhs \$_ri2fp2_rhs '%<' '>'; then
			case "${_ri2fp2_expr}" in

			*\**)
				if [ "${_ri2fp2_lhs#/}" = "${_ri2fp2_lhs}" ]; then
					_ri2fp2_lhs_full="${_ri2fp2_prefix:+${_ri2fp2_prefix%}/}${_ri2fp2_lhs:+${_ri2fp2_lhs%/}/}";
				else
					_ri2fp2_lhs_full="${_ri2fp2_lhs:+${_ri2fp2_lhs%/}/}";
				fi;
				set +o noglob; for _ri2fp2_pname in ${_ri2fp2_lhs_full}${_ri2fp2_expr}; do
					set -o noglob; _ri2fp2_pname="${_ri2fp2_pname%/}${_ri2fp2_rhs:+/${_ri2fp2_rhs}}";
					if [ -e "${_ri2fp2_pname}" ]; then
						eval ${_ri2fp2_rspec_list}='${'"${_ri2fp2_rspec_list}"':+${'"${_ri2fp2_rspec_list}"'}${RTL_NL}}${_ri2fp2_pname}';
					fi;
				done; set -o noglob; ;;

			"")	_ri2fp2_rc=1;
				rtl_setrstatus "${_ri2fp2_rstatus}" 'zero-length pattern';
				break; ;;

			*)	_ri2fp2_rc=1;
				rtl_setrstatus "${_ri2fp2_rstatus}" 'invalid pattern \`'"${_ri2fp2_expr}"''\';
				break; ;;

			esac; _ri2fp2_lhs="${_ri2fp2_rhs}";
		else
			eval ${_ri2fp2_rspec_list}='${'"${_ri2fp2_rspec_list}"':+${'"${_ri2fp2_rspec_list}"'}${RTL_NL}}${_ri2fp2_lhs}';
			break;
		fi;
	done;

	return "${_ri2fp2_rc}";
};
# }}}

#
# Install OPeration functions
#
# {{{ rtlp_install_v2_op_chmod($_nflag, $_prefix, $_vflag, $_fname, $_mode)
rtlp_install_v2_op_chmod() {
	local _ri2oc_nflag="${1}" _ri2oc_prefix="${2}" _ri2oc_vflag="${3}" _ri2oc_fname="${4}" _ri2oc_mode="${5}";

	rtlp_install_v2_fixup_fname \$_ri2oc_fname "${_ri2oc_prefix}";
	rtlp_install_v2_rc "${_ri2oc_nflag}" "${_ri2oc_vflag}" rtl_fileop chmod "${_ri2oc_mode}" "${_ri2oc_fname}";
};
# }}}
# {{{ rtlp_install_v2_op_chgrp($_nflag, $_prefix, $_vflag, $_fname, $_group)
rtlp_install_v2_op_chgrp() {
	local _ri2oc2_nflag="${1}" _ri2oc2_prefix="${2}" _ri2oc2_vflag="${3}" _ri2oc2_fname="${4}" _ri2oc2_group="${5}";

	rtlp_install_v2_fixup_fname \$_ri2oc2_fname "${_ri2oc2_prefix}";
	rtlp_install_v2_rc "${_ri2oc2_nflag}" "${_ri2oc2_vflag}" rtl_fileop chgrp "${_ri2oc2_group}" "${_ri2oc2_fname}";
};
# }}}
# {{{ rtlp_install_v2_op_chown($_nflag, $_prefix, $_vflag, $_fname, $_owner)
rtlp_install_v2_op_chown() {
	local _ri2oc3_nflag="${1}" _ri2oc3_prefix="${2}" _ri2oc3_vflag="${3}" _ri2oc3_fname="${4}" _ri2oc3_owner="${5}";

	rtlp_install_v2_fixup_fname \$_ri2oc3_fname "${_ri2oc3_prefix}";
	rtlp_install_v2_rc "${_ri2oc3_nflag}" "${_ri2oc3_vflag}" rtl_fileop chown "${_ri2oc3_owner}" "${_ri2oc3_fname}";
};
# }}}
# {{{ rtlp_install_v2_op_cp($_nflag, $_prefix, $_vflag, $_file_fname_dst, $_file_fname_src)
rtlp_install_v2_op_cp() {
	local _ri2oc4_nflag="${1}" _ri2oc4_prefix="${2}" _ri2oc4_vflag="${3}" _ri2oc4_fname_dst="${4}" _ri2oc4_fname_src="${5}";

	rtlp_install_v2_fixup_fname \$_ri2oc4_fname_dst "${_ri2oc4_prefix}";
	rtlp_install_v2_fixup_fname \$_ri2oc4_fname_src "${_ri2oc4_prefix}";
	rtlp_install_v2_rc "${_ri2oc4_nflag}" "${_ri2oc4_vflag}" rtl_fileop cp "${_ri2oc4_fname_src}" "${_ri2oc4_fname_dst}";
};
# }}}
# {{{ rtlp_install_v2_op_cp_follow_if_newer($_nflag, $_prefix, $_vflag, $_file_fname_dst, $_file_fname_src)
rtlp_install_v2_op_cp_follow_if_newer() {
	local _ri2ocfin_nflag="${1}" _ri2ocfin_prefix="${2}" _ri2ocfin_vflag="${3}" _ri2ocfin_fname_dst="${4}" _ri2ocfin_fname_src="${5}";

	rtlp_install_v2_fixup_fname \$_ri2ocfin_fname_dst "${_ri2ocfin_prefix}";
	rtlp_install_v2_fixup_fname \$_ri2ocfin_fname_src "${_ri2ocfin_prefix}";
	if [ -e "${_ri2ocfin_fname_dst}" ]\
	&& rtl_is_newer "${_ri2ocfin_fname_src}" "${_ri2ocfin_fname_dst}"; then
		return 0;
	else
		rtlp_install_v2_rc "${_ri2ocfin_nflag}" "${_ri2ocfin_vflag}" rtl_fileop cp_follow "${_ri2ocfin_fname_src}" "${_ri2ocfin_fname_dst}";
	fi;
};
# }}}
# {{{ rtlp_install_v2_op_ln_symbolic($_nflag, $_prefix, $_vflag, $_ln_fname, $_ln_target)
rtlp_install_v2_op_ln_symbolic() {
	local _ri2ols_nflag="${1}" _ri2ols_prefix="${2}" _ri2ols_vflag="${3}" _ri2ols_ln_fname="${4}" _ri2ols_ln_target="${5}";

	rtlp_install_v2_fixup_fname \$_ri2ols_ln_fname "${_ri2ols_prefix}";
	if [ -e "${_ri2ols_ln_fname}" ]; then
		rtlp_install_v2_rc "${_ri2ols_nflag}" "${_ri2ols_vflag}" rtl_fileop rm "${_ri2ols_ln_fname}";
	fi;
	rtlp_install_v2_rc "${_ri2ols_nflag}" "${_ri2ols_vflag}" rtl_fileop ln_symbolic "${_ri2ols_ln_target}" "${_ri2ols_ln_fname}";
};
# }}}
# {{{ rtlp_install_v2_op_mkdir($_nflag, $_prefix, $_vflag, $_dname)
rtlp_install_v2_op_mkdir() {
	local _ri2om_nflag="${1}" _ri2om_prefix="${2}" _ri2om_vflag="${3}" _ri2om_dname="${4}";

	rtlp_install_v2_fixup_fname \$_ri2om_dname "${_ri2om_prefix}";
	rtlp_install_v2_rc "${_ri2om_nflag}" "${_ri2om_vflag}" rtl_fileop mkdir "${_ri2om_dname}";
};
# }}}
# {{{ rtlp_install_v2_op_mv($_nflag, $_prefix, $_vflag, $_file_fname_dst, $_file_fname_src)
rtlp_install_v2_op_mv() {
	local _ri2om2_nflag="${1}" _ri2om2_prefix="${2}" _ri2om2_vflag="${3}" _ri2om2_fname_dst="${4}" _ri2om2_fname_src="${5}";

	rtlp_install_v2_fixup_fname \$_ri2om2_fname_dst "${_ri2om2_prefix}";
	rtlp_install_v2_fixup_fname \$_ri2om2_fname_src "${_ri2om2_prefix}";
	rtlp_install_v2_rc "${_ri2om2_nflag}" "${_ri2om2_vflag}" rtl_fileop mv "${_ri2om2_fname_src}" "${_ri2om2_fname_dst}";
};
# }}}
# {{{ rtlp_install_v2_op_rm($_nflag, $_prefix, $_vflag, $_pname)
rtlp_install_v2_op_rm() {
	local _ri2or_nflag="${1}" _ri2or_prefix="${2}" _ri2or_vflag="${3}" _ri2or_pname="${4}";

	rtlp_install_v2_fixup_fname \$_ri2or_pname "${_ri2or_prefix}";
	rtlp_install_v2_rc "${_ri2or_nflag}" "${_ri2or_vflag}" rtl_fileop rm "${_ri2or_pname}";
};
# }}}
# {{{ rtlp_install_v2_op_touch($_nflag, $_prefix, $_vflag, $_fname, $_ts)
rtlp_install_v2_op_touch() {
	local _ri2ot_nflag="${1}" _ri2ot_prefix="${2}" _ri2ot_vflag="${3}" _ri2ot_fname="${4}" _ri2ot_ts="${5:-}";

	rtlp_install_v2_fixup_fname \$_ri2ot_fname "${_ri2ot_prefix}";
	rtlp_install_v2_rc "${_ri2ot_nflag}" "${_ri2ot_vflag}" rtl_fileop touch "${_ri2ot_fname}" "${_ri2ot_ts}";
};
# }}}

#
# Ancillary functions
#
# {{{ rtlp_install_v2_fixup_fname($_rfname, $_prefix)
rtlp_install_v2_fixup_fname() {
	local _ri2ff_rfname="${1#\$}" _ri2ff_prefix="${2}" _ri2ff_fname="";
	eval _ri2ff_fname='${'"${_ri2ff_rfname}"'}';

	if [ "${_ri2ff_fname#/}" = "${_ri2ff_fname}" ]; then
		eval ${_ri2ff_rfname}='${_ri2ff_prefix:+${_ri2ff_prefix}/}${_ri2ff_fname}';
	fi;
};
# }}}
# {{{ rtlp_install_v2_rc($_nflag, $_vflag, $_fn, [...])
rtlp_install_v2_rc() {
	local _ri2r_nflag="${1}" _ri2r_vflag="${2}" _ri2r_fn="${3}" _ri2r_rc=0; shift 3;

	if [ "${_ri2r_nflag}" -eq 1 ]\
	|| [ "${_ri2r_vflag}" -gt 0 ]; then
		rtl_log_msgV "install" "${MSG_rtl_install_v2_rc}" "${_ri2r_fn}${_ri2r_fn:+ ${*}}";
	fi;
	if [ "${_ri2r_nflag}" -eq 0 ]; then
		"${_ri2r_fn}" "${@}"; _ri2r_rc="${?}";
	fi;
	return "${_ri2r_rc}";
};
# }}}
# {{{ rtlp_install_v2_splitl($_rlhs, $_rrhs, $_sep)
#
# rtlp_install_v2_splitl()
# Split @_rlhs from left-hand side into left-hand and right-hand side
# according to @_sep w/ backslash escaping
#
# @_rlhs:		inout reference to string and left-hand side result
# @_rrhs:		out reference to right-hand side result
# @_sep:		single non-zero, possibly multi-character, separator
#
# Calling convention:	inout ref. @_rlhs, out ref. @_rrhs
# Notate bene:		@_sep is a shell pattern
# Returns:		zero (0) on success, non-zero (>0) on absence of unescaped @_sep in @_rlhs
#
rtlp_install_v2_splitl() {
	local	_ri2s_rlhs="${1#\$}" _ri2s_rrhs="${2#\$}" _ri2s_sep="${3}" _ri2s_lhs=""	\
		_ri2s_lhs_new="" _ri2s_rc=1 _ri2s_rhs="" _ri2s_rhs_new="";

	eval _ri2s_rhs='${'"${_ri2s_rlhs}"'}';
	while [ "${_ri2s_rhs:+1}" = 1 ]; do
		_ri2s_lhs_new="${_ri2s_rhs%%${_ri2s_sep}*}";
		if [ "${_ri2s_lhs_new}" != "${_ri2s_rhs}" ]; then
			_ri2s_rhs_new="${_ri2s_rhs#*${_ri2s_sep}}";
			if [ "${_ri2s_lhs_new%\\}" = "${_ri2s_lhs_new}" ]; then
				eval	${_ri2s_rlhs}='${_ri2s_lhs}${_ri2s_lhs_new}'	\
					${_ri2s_rrhs}='${_ri2s_rhs_new}'; _ri2s_rc=0; break;
			else
				_ri2s_lhs="${_ri2s_lhs}${_ri2s_lhs_new%\\}${_ri2s_sep}";
				_ri2s_rhs="${_ri2s_rhs_new}";
			fi;
		else break; fi;
	done;
	return "${_ri2s_rc}";
};
# }}}
# {{{ rtlp_install_v2_splitl_ref($_ritem, $_rlhs, $_rrhs, $_sepl, $_sepr)
#
# rtlp_install_v2_splitl_ref()
# Split @_rlhs from left-hand side into left-hand, reference, and
# right-hand side according to left-hand (beginning) and right-hand
# (ending) side separators w/ backslash escaping
#
# @_rref:		out reference to reference
# @_rlhs:		inout reference to string and left-hand side result
# @_rrhs:		out reference to right-hand side result
# @_sepl:		single non-zero, possibly multi-character, left-hand side separator
# @_sepr:		single non-zero, possibly multi-character, right-hand side separator
#
# Calling convention:	out ref. @_rref, inout ref. @_rlhs, out ref. @_rrhs
# Notate bene:		@_sepl and @_sepr are shell patterns
# Returns:		zero (0) on success, non-zero (>0) on absence of unescaped references in @_rlhs
#
rtlp_install_v2_splitl_ref() {
	local	_ri2sr_rref="${1#\$}" _ri2sr_rlhs="${2#\$}" _ri2sr_rrhs="${3#\$}" _ri2sr_sepl="${4}"	\
		_ri2sr_sepr="${5}" _ri2sr_item="" _ri2sr_item_lhs="" _ri2sr_item_lhs_new=""		\
		_ri2sr_item_rhs="" _ri2sr_item_rhs_new="" _ri2sr_lhs="" _ri2sr_lhs_new="" _ri2sr_rc=1	\
		_ri2sr_rhs="" _ri2sr_rhs_new="";

	eval _ri2sr_rhs='${'"${_ri2sr_rlhs}"'}';
	while [ "${_ri2sr_rhs:+1}" = 1 ]; do
		_ri2sr_lhs_new="${_ri2sr_rhs%%${_ri2sr_sepl}*}";
		if [ "${_ri2sr_lhs_new}" != "${_ri2sr_rhs}" ]; then
			_ri2sr_rhs_new="${_ri2sr_rhs#*${_ri2sr_sepl}}";
			if [ "${_ri2sr_lhs_new%\\}" = "${_ri2sr_lhs_new}" ]; then
				_ri2sr_item=""; _ri2sr_item_lhs=""; _ri2sr_item_rhs="${_ri2sr_rhs_new}";
				while [ "${_ri2sr_item_rhs:+1}" = 1 ]; do
					_ri2sr_item_lhs_new="${_ri2sr_item_rhs%%${_ri2sr_sepr}*}";
					if [ "${_ri2sr_item_lhs_new}" != "${_ri2sr_item_rhs}" ]; then
						_ri2sr_item_rhs_new="${_ri2sr_item_rhs#*${_ri2sr_sepr}}";
						if [ "${_ri2sr_item_lhs_new%\\}" = "${_ri2sr_item_lhs_new}" ]; then
							_ri2sr_item="${_ri2sr_item_lhs}${_ri2sr_item_lhs_new}";
							_ri2sr_item_rhs="${_ri2sr_item_rhs_new}";
							_ri2sr_rc=0; break;
						else
							_ri2sr_item_lhs="${_ri2sr_item_lhs}${_ri2sr_item_lhs_new%\\}${_ri2sr_sepr}";
							_ri2sr_item_rhs="${_ri2sr_item_rhs_new}";
						fi;
					else break; fi;
				done; break;
			else
				_ri2sr_lhs="${_ri2sr_lhs}${_ri2sr_lhs_new%\\}${_ri2sr_sepl}"; _ri2sr_rhs="${_ri2sr_rhs_new}";
			fi;
		else break; fi;
	done;

	eval	${_ri2sr_rref}='${_ri2sr_item}'			\
		${_ri2sr_rlhs}='${_ri2sr_lhs}${_ri2sr_lhs_new}'	\
		${_ri2sr_rrhs}='${_ri2sr_item_rhs}';
	return "${_ri2sr_rc}";
};
# }}}
# {{{ rtlp_install_v2_splitl_subexpr($_rexpr, $_rlhs, $_lsep)
#
# rtlp_install_v2_splitl_subexpr()
# Split @_rlhs from left-hand side into left-hand (subexpression) and right-hand
# side according to list of expression operator prefixes w/ backslash escaping
#
# @_rexpr:		out reference to right-hand (expression) side result
# @_rlhs:		inout reference to string and left-hand side result
# @_lsep:		non-zero SP-separated list of non-zero, possibly multi-character, expression operator prefixes
#
# Calling convention:	out ref. @_rexpr, inout ref. @_rlhs
# Notate bene:		@_lsep list items are shell patterns
# Returns:		zero (0) on success, non-zero (>0) on absence of unescaped expressions in @_rlhs
#
rtlp_install_v2_splitl_subexpr() {
	local	_ri2ss_rexpr="${1#\$}" _ri2ss_rlhs="${2#\$}" _ri2ss_lsep="${3}" _ri2ss_lhs=""		\
		_ri2ss_matchfl="" _ri2ss_nsep="" _ri2ss_rc=1 _ri2ss_sep="" _ri2ss_sexpr=""		\
		_ri2ss_sexpr_lhs="" _ri2ss_sexpr_lhs_new="" _ri2ss_sexpr_rhs=""				\
		_ri2ss_sexpr_rhs_new="" _ri2ss_sexpr_rhs_new_min="" _ri2ss_sexpr_rhs_new_min_new=""	\
		_ri2ss_sexpr_sep="" _ri2ss_sexpr_sep_new=""

	eval _ri2ss_lhs='${'"${_ri2ss_rlhs}"'}'; set -- ${_ri2ss_lsep};

	if [ "${_ri2ss_lhs:+1}" = 1 ]; then
		_ri2ss_matchfl=0; _ri2ss_nsep=1; while [ "${_ri2ss_nsep}" -le "${#}" ]; do
			eval _ri2ss_sep='${'"${_ri2ss_nsep}"'}';
			case "${_ri2ss_lhs}" in
			${_ri2ss_sep}*)	_ri2ss_matchfl=1; break; ;;
			*)		: $((_ri2ss_nsep+=1)); ;;
			esac;
		done;

		if [ "${_ri2ss_matchfl}" -eq 1 ]; then
			_ri2ss_sexpr=""; _ri2ss_sexpr_lhs="${_ri2ss_sep}";
			_ri2ss_sexpr_rhs="${_ri2ss_lhs#${_ri2ss_sep}}";

			while [ "${_ri2ss_sexpr_rhs:+1}" = 1 ]; do
				_ri2ss_sexpr_rhs_new_min=-1; _ri2ss_sexpr_sep=""; _ri2ss_nsep=1;
				while [ "${_ri2ss_nsep}" -le "${#}" ]; do
					eval _ri2ss_sexpr_sep_new='${'"${_ri2ss_nsep}"'}';
					_ri2ss_sexpr_rhs_new="${_ri2ss_sexpr_rhs%%${_ri2ss_sexpr_sep_new}*}";
					if [ "${_ri2ss_sexpr_rhs_new}" != "${_ri2ss_sexpr_rhs}" ]; then
						_ri2ss_sexpr_rhs_new_min_new="${#_ri2ss_sexpr_rhs_new}";
						if [ "${_ri2ss_sexpr_rhs_new_min_new}" -le "${_ri2ss_sexpr_rhs_new_min}" ]\
						|| [ "${_ri2ss_sexpr_rhs_new_min}" -eq -1 ]; then
							_ri2ss_sexpr_rhs_new_min="${_ri2ss_sexpr_rhs_new_min_new}";
							_ri2ss_sexpr_sep="${_ri2ss_sexpr_sep_new}";
						fi;
					fi; : $((_ri2ss_nsep+=1));
				done;
				if [ "${_ri2ss_sexpr_sep:+1}" = 1 ]; then
					_ri2ss_sexpr_lhs_new="${_ri2ss_sexpr_rhs%%${_ri2ss_sexpr_sep}*}";
					if [ "${_ri2ss_sexpr_lhs_new%\\}" = "${_ri2ss_sexpr_lhs_new}" ]; then
						_ri2ss_sexpr_lhs="${_ri2ss_sexpr_lhs}${_ri2ss_sexpr_lhs_new}";
						_ri2ss_sexpr_rhs="${_ri2ss_sexpr_sep}${_ri2ss_sexpr_rhs#*${_ri2ss_sexpr_sep}}"; break;
					else
						_ri2ss_sexpr_lhs="${_ri2ss_sexpr_lhs}${_ri2ss_sexpr_rhs%%\\${_ri2ss_sexpr_sep}*}${_ri2ss_sexpr_sep}";
						_ri2ss_sexpr_rhs="${_ri2ss_sexpr_rhs#*\\${_ri2ss_sexpr_sep}}";
					fi;
				else
					_ri2ss_sexpr_lhs="${_ri2ss_sexpr_lhs}${_ri2ss_sexpr_rhs}"; _ri2ss_sexpr_rhs=""; break;
				fi;
			done;

			eval ${_ri2ss_rexpr}='${_ri2ss_sexpr_lhs}' ${_ri2ss_rlhs}='${_ri2ss_sexpr_rhs}'; _ri2ss_rc=0;
		fi;
	fi;

	return "${_ri2ss_rc}";
};
# }}}

#
# rtl_install_v2() - install files
# @_rstatus:		reference to out variable of status string on failure
# @[-i]:		continue on soft errors
# @[-I ifs]:		process spec_list with ifs instead of NL
# @[-n]:		perform dry run
# @[-p name=val]:	set named parameter
# @[-v]:		increase verbosity
# @_prefix:		pathname prefix
# @_spec_list:		ifs-separated list of specs
#
# {{{ File installation DSL
# 
# ```
# (*
# SH_GLOB_PATTERN      = any valid portable shell pattern (see sh(1)); superset of PATHNAME
# SH_SUBSTRING_PATTERN = any valid portable substring processing shell pattern (see sh(1));
#                        superset of PATHNAME
# PARAMETER            = any valid portable shell variable name except that [0-9] may occur
#                        the beginning
# PATHNAME             = any valid filename, directory name, relative or absolute pathname
#                        excluding the characters NUL and NL
#  *)
# 
# spec                 = { op_flag, } op_unary, "=", op_spec, "\n", { spec } ;
#                      | { op_flag, } op_binary, op_spec, "=" op_spec, "\n", { spec } ;
#                      | "#" COMMENT ;
# op_unary             = "-" | "/" | "t" ;
# op_binary            = ":" | "!" | "@" | "+" | "g" | "m" | "o" | "T" ;
# op_flag              = "?" ;
# op_spec              = pattern_spec | PATHNAME | expr_spec | op_spec ;
# 
# pattern_spec         = "%<", SH_GLOB_PATTERN, ">" ;
# 
# expr_spec            = "%[", expr, { sexpr_spec }, "%]" ;
# expr                 = [ "@" ], "0" .. "9" | "DNAME" | "FNAME" | "ITEM" | PARAMETER ;
# 
# sexpr_spec           = sexpr_op_unary, SH_SUBSTRING_PATTERN, { sexpr } ;
# sexpr_op_unary       = "##" | "#" | "%%" | "%" ;
# ```
#   
# Single ``"="`` characters in ``spec``, the ``"%<"`` and ``"%["`` character
# sequences in ``pattern_spec`` and ``expr_spec``, resp., and the ``sexpr_op_unary``
# as well as ``sexpr_op_binary`` characters or character sequences may be
# escaped with a single backslash (``"\"``.) ``SH_SUBSTRING_PATTERN`` differs
# from ``SH_GLOB_PATTERN`` solely in that any of ``sexpr_op_unary`` and
# ``sexpr_op_binary`` occuring at the beginning of or in the former must
# be escaped with a single backslash (``"\"``,) e.g. ``"#\#pattern"`` and
# ``"%\%pattern"``, etc. and ``"#pat\%ern"`` and ``%patt\#ern", etc., resp.  
#   
# Named parameters (``PARAMETER``) are supplied via the ``-p name=value``
# argument to ``rtl_install()``, whereas numbered parameters are for
# internal usage only; the ``"DNAME"``, ``"FNAME"``, and ``"ITEM"`` parameters
# lazily evaluate to the directory name, file (aka base) name, and full
# pathname of the current item being processed relative to a specification
# with a pattern in it.
#   
# The following operation flags are defined:
# 
# | Flag      | Description              |
# | --------- | ------------------------ |
# | ``?``     | Continue on soft failure |
#   
# The following operations are defined:
# 
# | Operation      | Arity  | Description                                                      |
# | -------------- | ------ | ---------------------------------------------------------------- |
# | ``-``          | Unary  | Remove directories and/or files                                  |
# | ``/``          | Unary  | Create directories or trees thereof                              |
# | ``t``          | Unary  | touch(1) files and/or directories                                |
# | ``:``          | Binary | Copy directories and/or files                                    |
# | ``!``          | Binary | Move/rename directories and/or files                             |
# | ``@``          | Binary | Create/update symbolic links                                     |
# | ``+``          | Binary | Copy directories and/or files if newer and follow symbolic links |
# | ``g``          | Binary | Set group owner of files and/or directories                      |
# | ``m``          | Binary | Set mode bits of files and/or directories                        |
# | ``o``          | Binary | Set user and/or group owner of files and/or directories          |
# | ``T``          | Binary | touch(1) files and/or directories with timestamp                 |
#   
# The following expression modifiers are defined:
# 
# | Modifier       | Description                               |
# | -------------- | ----------------------------------------- |
# | ``@``          | Recursively reevaluate after substituting |
#   
# The following subexpression operators are defined:
# 
# | Operation      | Arity  | Description                                                      |
# | -------------- | ------ | ---------------------------------------------------------------- |
# | ``##``         | Unary  | Remove largest prefix from left-hand side                        |
# | ``#``          | Unary  | Remove prefix from left-hand side                                |
# | ``%%``         | Unary  | Remove largest postfix from right-hand side                      |
# | ``%``          | Unary  | Remove postfix from right-hand side                              |
#   
# ```shell
# #
# # Examples:
# # 
# 
# #
# # Create directory %[_minipix]/bin and copy all files
# # in %[_minipix_dist]/bin/ to %[_minipix]/bin/ with
# # identical file names.
# /=%[_minipix]/bin
# ?%[_minipix_dist]/bin/%<*>=%[_minipix]/bin/%[FNAME]
# 
# #
# # Rename all files in share/info/ matching *.info to
# # their filenames with the `.info' postfix removed and
# # `-2.64.info' appended and all files in share/man/man1/
# # matching *.1 with the `.1' postfix removed and -2.64.1
# # appended.
# !share/info/%<*.info>=share/info/%[FNAME%.info]-2.64.info
# !share/man/man1/%<*.1>=share/man/man1/%[FNAME%.1]-2.64.1
# 
# #
# # Create/update symbolic links named include/ffi.h and
# # include/ffitarget.h with ../lib/libffi-3.2.1/include/ffi.h
# # and ../lib/libffi-3.2.1/include/ffitarget.h as targets, resp.
# @../lib/libffi-3.2.1/include/ffi.h=include/ffi.h
# @../lib/libffi-3.2.1/include/ffitarget.h=include/ffitarget.h
#
# ```
#
# }}}
#
# Returns:		zero (0) on success, non-zero (>0) on failure
#
rtl_install_v2() {
	local	_ri2_rstatus="${1#\$}"										\
		_ri2_prefix="" _ri2_spec_flag="" _ri2_spec_list="" _ri2_iflag=0 _ri2_IFS="${IFS:- 	}"	\
		_ri2_nflag=0 _ri2_paramsc=0 _ri2_vflag=0 _ri2_IFS0 _ri2_nparam=0 _ri2_opt="" _ri2_param=""	\
		_ri2_rc=0 _ri2_spec="" _ri2_spec_dst="" _ri2_spec_src="" IFS OPTARG="" OPTIND=1;
	shift;

	while true; do
		if [ "${1:-}" = "--" ]; then
			: $((OPTIND+=1)); break;
		elif ! getopts hiI:np:v _ri2_opt; then
			break;
		else case "${_ri2_opt}" in
		h)	printf "usage: rtl_install [-i] [-I ifs] [-n] [-p name=val] [-v] prefix spec_list\n" >&2;
			printf "       -i...........: continue on soft errors\n" >&2;
			printf "       -I ifs.......: process spec_list with ifs instead of NL\n" >&2;
			printf "       -n...........: perform dry run\n" >&2;
			printf "       -p name=val..: set named parameter\n" >&2;
			printf "       -v...........: increase verbosity\n" >&2;
			printf "       prefix.......: pathname prefix\n" >&2;
			printf "       spec_list....: ifs-separated list of specs\n" >&2; return 1; ;;
		i)	_ri2_iflag=1; ;;
		I)	_ri2_IFS="${OPTARG}"; ;;
		n)	_ri2_nflag=1; ;;
		p)	: $((_ri2_paramsc+=1)); local _ri2_params${OPTARG%%=*}="${OPTARG#*=}"; ;;
		v)	: $((_ri2_vflag+=1)); ;;
		*)	return 1; ;;
		esac; fi;
	done; shift $((${OPTIND}-1));
	_ri2_prefix="${1:-}"; _ri2_spec_list="${2:-}"; shift 2;
	_ri2_IFS0="${IFS:- 	}"; IFS="${_ri2_IFS}"; set -- ${_ri2_spec_list}; IFS="${_ri2_IFS0}";

	while [ ${#} -gt 0 ]; do
		_ri2_spec_src="${1}";
		case "${_ri2_spec_src}" in
		\?*)	_ri2_spec_flag="?"; ;;
		*)	_ri2_spec_flag=""; ;;
		esac;
		if ! rtlp_install_v2_splitl \$_ri2_spec_src \$_ri2_spec_dst "="; then
			_ri2_rc=1;
			rtl_setrstatus "${_ri2_rstatus}" 'zero-length or invalid specification \`'"${1}"''\';
		else case "${_ri2_spec_src}" in

		-)
			rtlp_install_v2_fmap "${_ri2_rstatus}" \$_ri2_params "${_ri2_prefix}" "${_ri2_spec_dst}"	\
				rtlp_install_v2_op_rm "${_ri2_nflag}" "${_ri2_prefix}" "${_ri2_vflag}"			\
					""										\
					-- "%[1]" "%[2]" "%[3]" "%[ITEM]"; ;;

		/)
			rtlp_install_v2_fmap "${_ri2_rstatus}" \$_ri2_params "${_ri2_prefix}" "${_ri2_spec_dst}"	\
				rtlp_install_v2_op_mkdir "${_ri2_nflag}" "${_ri2_prefix}" "${_ri2_vflag}"		\
					""										\
				       	-- "%[1]" "%[2]" "%[3]" "%[ITEM]"; ;;

		t*)
			rtlp_install_v2_fmap "${_ri2_rstatus}" \$_ri2_params "${_ri2_prefix}" "${_ri2_spec_dst}"	\
				rtlp_install_v2_op_touch "${_ri2_nflag}" "${_ri2_prefix}" "${_ri2_vflag}"		\
					"" "" 										\
					-- "%[1]" "%[2]" "%[3]" "%[ITEM]" "%[5]"; ;;

		:*)
			rtlp_install_v2_fmap "${_ri2_rstatus}" \$_ri2_params "${_ri2_prefix}" "${_ri2_spec_src#:}"	\
				rtlp_install_v2_op_cp "${_ri2_nflag}" "${_ri2_prefix}" "${_ri2_vflag}"			\
					"${_ri2_spec_dst}" ""								\
					-- "%[1]" "%[2]" "%[3]" "%[@4]" "%[ITEM]"; ;;

		!*)
			rtlp_install_v2_fmap "${_ri2_rstatus}" \$_ri2_params "${_ri2_prefix}" "${_ri2_spec_src#!}"	\
				rtlp_install_v2_op_mv "${_ri2_nflag}" "${_ri2_prefix}" "${_ri2_vflag}"			\
					"${_ri2_spec_dst}" ""								\
					--  "%[1]" "%[2]" "%[3]" "%[@4]" "%[ITEM]"; ;;

		@*)
			rtlp_install_v2_fmap "${_ri2_rstatus}" \$_ri2_params "${_ri2_prefix}" "${_ri2_spec_dst}"	\
				rtlp_install_v2_op_ln_symbolic "${_ri2_nflag}" "${_ri2_prefix}"				\
					"${_ri2_vflag}" "" "${_ri2_spec_src#@}" ""					\
					-- "%[1]" "%[2]" "%[3]" "%[ITEM]" "%[@5]"; ;;

		+*)
			rtlp_install_v2_fmap "${_ri2_rstatus}" \$_ri2_params "${_ri2_prefix}" "${_ri2_spec_src#+}"	\
				rtlp_install_v2_op_cp_follow_if_newer "${_ri2_nflag}" "${_ri2_prefix}"			\
					"${_ri2_vflag}" "${_ri2_spec_dst}" ""						\
					-- "%[1]" "%[2]" "%[3]" "%[@4]" "%[ITEM]"; ;;

		g*)
			rtlp_install_v2_fmap "${_ri2_rstatus}" \$_ri2_params "${_ri2_prefix}" "${_ri2_spec_dst}"	\
				rtlp_install_v2_op_chgrp "${_ri2_nflag}" "${_ri2_prefix}" "${_ri2_vflag}"		\
					"" "${_ri2_spec_src#g}" 							\
					-- "%[1]" "%[2]" "%[3]" "%[ITEM]" "%[5]"; ;;

		m[0-7][0-7][0-7][0-7])
			rtlp_install_v2_fmap "${_ri2_rstatus}" \$_ri2_params "${_ri2_prefix}" "${_ri2_spec_dst}"	\
				rtlp_install_v2_op_chmod "${_ri2_nflag}" "${_ri2_prefix}" "${_ri2_vflag}"		\
					"" "${_ri2_spec_src#m}"								\
					-- "%[1]" "%[2]" "%[3]" "%[ITEM]" "%[5]"; ;;

		o*)
			rtlp_install_v2_fmap "${_ri2_rstatus}" \$_ri2_params "${_ri2_prefix}" "${_ri2_spec_dst}"	\
				rtlp_install_v2_op_chown "${_ri2_nflag}" "${_ri2_prefix}" "${_ri2_vflag}"		\
					"" "${_ri2_spec_src#o}" 							\
					-- "%[1]" "%[2]" "%[3]" "%[ITEM]" "%[5]"; ;;

		T*)
			rtlp_install_v2_fmap "${_ri2_rstatus}" \$_ri2_params "${_ri2_prefix}" "${_ri2_spec_dst}"	\
				rtlp_install_v2_op_touch "${_ri2_nflag}" "${_ri2_prefix}" "${_ri2_vflag}"		\
					"" "${_ri2_spec_src#T}" 							\
					-- "%[1]" "%[2]" "%[3]" "%[ITEM]" "%[5]"; ;;

		\#*|"")
			;;

		esac; _ri2_rc="${?}"; fi;
		shift;

		if [ "${_ri2_rc}" -ne 0 ]\
		&& [ "${_ri2_iflag}" -eq 0 ]; then
			break;
		fi;
	done;

	return "${_ri2_rc}";
};

# vim:filetype=sh textwidth=0