__call-ebuildshell() {

	if ! has ebuildshell ${FEATURES}; then

		"$@"

		return $?

	fi

	local __ebuildshell_args=( "$@" )

	# These are the variables I have seen 'bash -i' maintaining the values for:

	local __ebuildshell_bash_i_vars="__ebuildshell_.*

		_ BASH_ARGC BASH_ARGV BASH_COMMAND BASH_LINENO BASH_SOURCE

		BASH_VERSINFO BASH_SUBSHELL BASHOPTS BASHPID COMP_WORDBREAKS

		DIRSTACK EUID FUNCNAME GROUPS HISTCMD HISTFILE LINENO

		PIPESTATUS PPID PWD RANDOM SECONDS SHELLOPTS UID"

	# Allow recursive ebuildshell, for use in multibuild.eclass and similar:

	local __ebuildshell_pid=${BASHPID:-$(__bashpid)}

	local __ebuildshell_tmpf="${T}/ebuildshell.${__ebuildshell_pid}"

	rm -f "${__ebuildshell_tmpf}."{ebuild,return}-{env,rovars}

	(

		(

			declare -p

			declare -fp

			shopt -p

			[[ ${BASH_VERSINFO[0]} == 3 ]] && export

		) |

		(

			# we need everything but the bash vars after 'env -i'

			2>"${__ebuildshell_tmpf}.ebuild-rovars" \

			"${PORTAGE_PYTHON:-/tools/haubi/gentoo/s01en24/usr/bin/python}" \

				"${PORTAGE_BIN_PATH}"/filter-bash-environment.py \

					--report-readonly-variables \

					--preserve-readonly-attribute \

					"${__ebuildshell_bash_i_vars}" \

				|| die "filter-bash-environment.py failed"

		)

		# The already readonly variables, without bash maintained ones:

		__ebuildshell_ro_ebuild_vars=$(<"${__ebuildshell_tmpf}.ebuild-rovars")

		cat <<-EOE

			# properly quote the function arguments

			$(declare -p __ebuildshell_args)

			set -- "\${__ebuildshell_args[@]}"

			unset __ebuildshell_args

			# be informative about what to do

			PS1="EBUILD ${PN} $1 \$ "

			type $1

			echo "WANTED: \$@"

			echo "or use: \"\\\$@\""

			# use bash history, but not the 'user's real one

			HISTFILE=~/.bash_history

			# for copy&paste function body lines containing: !

			set +H

			# Support the 'local' keyword outside any shell function

			# for copy&paste of function body lines: Remember these

			# "local" variable names for filtering from return-env.

			__ebuildshell_local_vars=

			__ebuildshell_local() {

				local __ebuildshell_local_attr=

				while [[ \${1} == -* ]]; do

					__ebuildshell_local_attr+=" \${1}"

					shift

				done

				__ebuildshell_local_vars+=" \${1%%=*} "

				# Need to declare into the global shell namespace,

				# as we are in some shell function here apparently.

				declare -g \${__ebuildshell_local_attr} "\$@"

			}

			# within some function, BASH_LINENO is set, and we use real 'local'

			alias local='\$( (( \${#BASH_LINENO} > 0 )) && echo local || echo __ebuildshell_local)'

			# at exit, dump the current environment

			trap "

				unalias local

				unset -f __ebuildshell_local

				rm -f '${__ebuildshell_tmpf}.return-'*

				(

					(

						declare -p

						declare -fp

						shopt -p | grep -v 'extdebug$'

						$([[ ${BASH_VERSINFO[0]} == 3 ]] && echo export)

					) |

					(

						# We may have more readonly variables now, but we

						# need to filter variables that are readonly already.

						2>'${__ebuildshell_tmpf}.return-rovars' \\

						'${PORTAGE_PYTHON:-/tools/haubi/gentoo/s01en24/usr/bin/python}' \\

							'${PORTAGE_BIN_PATH}'/filter-bash-environment.py \\

								--report-readonly-variables \\

								--preserve-readonly-attribute \\

								'${__ebuildshell_bash_i_vars}

								 ${__ebuildshell_ro_ebuild_vars}

								 '\" \${__ebuildshell_local_vars}\" \\

							|| die 'filter-bash-environment.py failed'

					)

				) > '${__ebuildshell_tmpf}.return-env'

				" EXIT

			# this is a debugging shell already

			shopt -u extdebug

			trap - DEBUG

			# can do some cleanup already

			rm -f '${__ebuildshell_tmpf}.ebuild-'*

		EOE

	) > "${__ebuildshell_tmpf}.ebuild-env"

	# pre-fill the history with "$@"

	echo '"$@"' >> ~/.bash_history

	env -i ${BASH} --rcfile "${__ebuildshell_tmpf}.ebuild-env" -i

	# The environment- and exit-status handling after leaving the ebuildshell

	# prompt is expected to be identical as without the ebuildshell prompt.

	local __ebuildshell_status=$?

	# Defining a variable without using the the local keyword makes this

	# variable visible to the 'global' shell namespace.  But 'declare -p'

	# does not show the -g flag, so we need to add that one for all

	# variables that have been visible to the EXIT trap above.

	local __ebuildshell_orig_expand_aliases=$(shopt -p expand_aliases)

	alias declare='declare -g'

	shopt -s expand_aliases

	source "${__ebuildshell_tmpf}.return-env"

	unalias declare

	${__ebuildshell_orig_expand_aliases}

	# Portage does whitelist readonly variables. If an ebuild defines

	# more readonly variables, their readonly attribute is removed.

	# If we ever want to preserve additional readonly variables across

	# phases, their names are in "${__ebuildshell_tmpf}.return-rovars".

	rm -f "${__ebuildshell_tmpf}."{ebuild,return}-{env,rovars}

	return ${__ebuildshell_status}

}

		var = readonly_match.group(3)

		if '--report-readonly-variables' in options:

			sys.stderr.write(var + "\n")

		if '--preserve-readonly-attribute' in options:

			declare_opts += 'r'

.B ebuildshell

Drop into an interactive shell for each phase function, meant for

debugging.  Because the shell would normally be used to execute the

phase function, commands like src_unpack or epatch are available in the

interactive shell.  Use `die` to terminate the merge.

.TP

			"ebuildshell" not in self.settings.features and \

	"ebuildshell",