mk/prepare.mk - third_party/rust - Git at Google

 # Copyright 2014 The Rust Project Developers. See the COPYRIGHT
 # file at the top-level directory of this distribution and at
 # http://rust-lang.org/COPYRIGHT.
 #
 # Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
 # http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
 # <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
 # option. This file may not be copied, modified, or distributed
 # except according to those terms.

 # Basic support for producing installation images.
 #
 # The 'prepare' build target copies all release artifacts from the build
 # directory to some other location, placing all binaries, libraries, and
 # docs in their final locations relative to each other.
 #
 # It requires the following variables to be set:
 #
 #   PREPARE_HOST - the host triple
 #   PREPARE_TARGETS - the target triples, space separated
 #   PREPARE_DEST_DIR - the directory to put the image

 PREPARE_STAGE=2

 DEFAULT_PREPARE_DIR_CMD = umask 022 && mkdir -p
 DEFAULT_PREPARE_BIN_CMD = install -m755
 DEFAULT_PREPARE_LIB_CMD = install -m644
 DEFAULT_PREPARE_MAN_CMD = install -m644

 # Create a directory
 # $(1) is the directory
 #
 # XXX: These defines are called to generate make steps.
 # Adding blank lines means two steps from different defines will not end up on
 # the same line.
 define PREPARE_DIR

 	@$(call E, prepare: $(1))
 	$(Q)$(PREPARE_DIR_CMD) $(1)

 endef

 # Copy an executable
 # $(1) is the filename/libname-glob
 #
 # See above for an explanation on the surrounding blank lines
 define PREPARE_BIN

 	@$(call E, prepare: $(PREPARE_DEST_BIN_DIR)/$(1))
 	$(Q)$(PREPARE_BIN_CMD) $(PREPARE_SOURCE_BIN_DIR)/$(1) $(PREPARE_DEST_BIN_DIR)/$(1)

 endef

 # Copy a dylib or rlib
 # $(1) is the filename/libname-glob
 #
 # See above for an explanation on the surrounding blank lines
 define PREPARE_LIB

 	@$(call E, prepare: $(PREPARE_WORKING_DEST_LIB_DIR)/$(1))
 	$(Q)LIB_NAME="$(notdir $(lastword $(wildcard $(PREPARE_WORKING_SOURCE_LIB_DIR)/$(1))))"; \
 	MATCHES="$(filter-out %$(notdir $(lastword $(wildcard $(PREPARE_WORKING_SOURCE_LIB_DIR)/$(1)))), \
                         $(wildcard $(PREPARE_WORKING_DEST_LIB_DIR)/$(1)))"; \
 	if [ -n "$$MATCHES" ]; then \
 	  echo "warning: one or libraries matching Rust library '$(1)'" && \
 	  echo "  (other than '$$LIB_NAME' itself) already present"     && \
 	  echo "  at destination $(PREPARE_WORKING_DEST_LIB_DIR):"      && \
 	  echo $$MATCHES ; \
 	fi
 	$(Q)$(PREPARE_LIB_CMD) `ls -drt1 $(PREPARE_WORKING_SOURCE_LIB_DIR)/$(1)` $(PREPARE_WORKING_DEST_LIB_DIR)/

 endef

 # Copy a man page
 # $(1) - source dir
 #
 # See above for an explanation on the surrounding blank lines
 define PREPARE_MAN

 	@$(call E, prepare: $(PREPARE_DEST_MAN_DIR)/$(1))
 	$(Q)$(PREPARE_MAN_CMD) $(PREPARE_SOURCE_MAN_DIR)/$(1) $(PREPARE_DEST_MAN_DIR)/$(1)

 endef

 PREPARE_TOOLS = $(filter-out compiletest rustbook error_index_generator, $(TOOLS))


 # $(1) is tool
 # $(2) is stage
 # $(3) is host
 # $(4) tag
 define DEF_PREPARE_HOST_TOOL
 prepare-host-tool-$(1)-$(2)-$(3)-$(4): \
 	PREPARE_SOURCE_BIN_DIR=$$(HBIN$(2)_H_$(3))
 prepare-host-tool-$(1)-$(2)-$(3)-$(4): prepare-maybe-clean-$(4) \
                                   $$(foreach dep,$$(TOOL_DEPS_$(1)),prepare-host-lib-$$(dep)-$(2)-$(3)-$(4)) \
                                   $$(HBIN$(2)_H_$(3))/$(1)$$(X_$(3)) \
                                   prepare-host-dirs-$(4)
 	$$(if $$(findstring $(2), $$(PREPARE_STAGE)), \
       $$(if $$(findstring $(3), $$(PREPARE_HOST)), \
         $$(call PREPARE_BIN,$(1)$$(X_$$(PREPARE_HOST))),),)
 	$$(if $$(findstring $(2), $$(PREPARE_STAGE)), \
       $$(if $$(findstring $(3), $$(PREPARE_HOST)), \
         $$(call PREPARE_MAN,$(1).1),),)
 endef

 # Libraries are compiled using the --libdir provided to configure, but
 # we store them in the tarball using just "lib" so that the install
 # script can then rewrite them back to the correct path.
 PREPARE_TAR_LIB_DIR = $(patsubst $(CFG_LIBDIR_RELATIVE)%,lib%,$(1))

 # For host libraries only install dylibs, not rlibs since the host libs are only
 # used to support rustc and rustc uses dynamic linking
 #
 # $(1) is tool
 # $(2) is stage
 # $(3) is host
 # $(4) tag
 define DEF_PREPARE_HOST_LIB
 prepare-host-lib-$(1)-$(2)-$(3)-$(4): \
 	PREPARE_WORKING_SOURCE_LIB_DIR=$$(HLIB$(2)_H_$(3))
 prepare-host-lib-$(1)-$(2)-$(3)-$(4): \
 	PREPARE_WORKING_DEST_LIB_DIR=$$(PREPARE_DEST_DIR)/$$(call PREPARE_TAR_LIB_DIR,$$(HLIB_RELATIVE$(2)_H_$(3)))
 prepare-host-lib-$(1)-$(2)-$(3)-$(4): prepare-maybe-clean-$(4) \
                                  $$(foreach dep,$$(RUST_DEPS_$(1)_T_$(3)),prepare-host-lib-$$(dep)-$(2)-$(3)-$(4)) \
                                  $$(HLIB$(2)_H_$(3))/stamp.$(1) \
                                  prepare-host-dirs-$(4)
 	$$(if $$(findstring $(2), $$(PREPARE_STAGE)), \
       $$(if $$(findstring $(3), $$(PREPARE_HOST)), \
         $$(if $$(findstring 1,$$(ONLY_RLIB_$(1))),, \
           $$(call PREPARE_LIB,$$(call CFG_LIB_GLOB_$$(PREPARE_HOST),$(1)))),),)
 endef


 # $(1) is stage
 # $(2) is target
 # $(3) is host
 # $(4) tag
 define DEF_PREPARE_TARGET_N
 # Rebind PREPARE_*_LIB_DIR to point to rustlib, then install the libs for the targets
 prepare-target-$(2)-host-$(3)-$(1)-$(4): \
 	PREPARE_WORKING_SOURCE_LIB_DIR=$$(TLIB$(1)_T_$(2)_H_$(3))
 prepare-target-$(2)-host-$(3)-$(1)-$(4): \
 	PREPARE_WORKING_DEST_LIB_DIR=$$(PREPARE_DEST_LIB_DIR)/rustlib/$(2)/lib
 prepare-target-$(2)-host-$(3)-$(1)-$(4): \
 	PREPARE_SOURCE_BIN_DIR=$$(TBIN$(1)_T_$(2)_H_$(3))
 prepare-target-$(2)-host-$(3)-$(1)-$(4): \
 	PREPARE_DEST_BIN_DIR=$$(PREPARE_DEST_LIB_DIR)/rustlib/$(3)/bin
 prepare-target-$(2)-host-$(3)-$(1)-$(4): prepare-maybe-clean-$(4) \
         $$(foreach crate,$$(TARGET_CRATES_$(2)), \
           $$(TLIB$(1)_T_$(2)_H_$(3))/stamp.$$(crate)) \
         $$(if $$(findstring $(2),$$(CFG_HOST)), \
           $$(foreach crate,$$(HOST_CRATES), \
             $$(TLIB$(1)_T_$(2)_H_$(3))/stamp.$$(crate)),)
 # Only install if this host and target combo is being prepared. Also be sure to
 # *not* install the rlibs for host crates because there's no need to statically
 # link against most of them. They just produce a large amount of extra size
 # bloat.
 	$$(if $$(findstring $(1), $$(PREPARE_STAGE)), \
       $$(if $$(findstring $(2), $$(PREPARE_TARGETS)), \
         $$(if $$(findstring $(3), $$(PREPARE_HOST)), \
           $$(call PREPARE_DIR,$$(PREPARE_WORKING_DEST_LIB_DIR)) \
           $$(call PREPARE_DIR,$$(PREPARE_DEST_BIN_DIR)) \
           $$(foreach crate,$$(TARGET_CRATES_$(2)), \
 	    $$(if $$(or $$(findstring 1, $$(ONLY_RLIB_$$(crate))),$$(findstring 1,$$(CFG_INSTALL_ONLY_RLIB_$(2)))),, \
               $$(call PREPARE_LIB,$$(call CFG_LIB_GLOB_$(2),$$(crate)))) \
             $$(call PREPARE_LIB,$$(call CFG_RLIB_GLOB,$$(crate)))) \
           $$(if $$(findstring $(2),$$(CFG_HOST)), \
             $$(foreach crate,$$(HOST_CRATES), \
               $$(call PREPARE_LIB,$$(call CFG_LIB_GLOB_$(2),$$(crate)))),) \
 	  $$(foreach object,$$(INSTALLED_OBJECTS_$(2)),\
 	    $$(call PREPARE_LIB,$$(object))) \
 	  $$(foreach bin,$$(INSTALLED_BINS_$(3)),\
 	    $$(call PREPARE_BIN,$$(bin))) \
 	,),),)
 endef

 define INSTALL_GDB_DEBUGGER_SCRIPTS_COMMANDS
 	$(Q)$(PREPARE_BIN_CMD) $(DEBUGGER_BIN_SCRIPTS_GDB_ABS) $(PREPARE_DEST_BIN_DIR)
 	$(Q)$(PREPARE_LIB_CMD) $(DEBUGGER_RUSTLIB_ETC_SCRIPTS_GDB_ABS) $(PREPARE_DEST_LIB_DIR)/rustlib/etc
 endef

 define INSTALL_LLDB_DEBUGGER_SCRIPTS_COMMANDS
 	$(Q)$(PREPARE_BIN_CMD) $(DEBUGGER_BIN_SCRIPTS_LLDB_ABS) $(PREPARE_DEST_BIN_DIR)
 	$(Q)$(PREPARE_LIB_CMD) $(DEBUGGER_RUSTLIB_ETC_SCRIPTS_LLDB_ABS) $(PREPARE_DEST_LIB_DIR)/rustlib/etc
 endef

 define INSTALL_NO_DEBUGGER_SCRIPTS_COMMANDS
 	$(Q)echo "No debugger scripts will be installed for host $(PREPARE_HOST)"
 endef

 # $(1) is PREPARE_HOST
 INSTALL_DEBUGGER_SCRIPT_COMMANDS=$(if $(findstring windows,$(1)),\
                                    $(INSTALL_NO_DEBUGGER_SCRIPTS_COMMANDS),\
                                    $(if $(findstring darwin,$(1)),\
                                      $(INSTALL_LLDB_DEBUGGER_SCRIPTS_COMMANDS),\
                                      $(INSTALL_GDB_DEBUGGER_SCRIPTS_COMMANDS)))

 define DEF_PREPARE

 prepare-base-$(1)-%: PREPARE_SOURCE_MAN_DIR=$$(S)/man
 prepare-base-$(1)-%: PREPARE_DEST_BIN_DIR=$$(PREPARE_DEST_DIR)/bin
 prepare-base-$(1)-%: PREPARE_DEST_LIB_DIR=$$(PREPARE_DEST_DIR)/$$(call PREPARE_TAR_LIB_DIR,$$(CFG_LIBDIR_RELATIVE))
 prepare-base-$(1)-%: PREPARE_DEST_MAN_DIR=$$(PREPARE_DEST_DIR)/share/man/man1

 prepare-base-$(1)-target: prepare-target-$(1)
 prepare-base-$(1)-host: prepare-host-$(1) prepare-debugger-scripts-$(1)

 prepare-host-$(1): prepare-host-tools-$(1)

 prepare-host-tools-$(1): \
         $$(foreach tool, $$(PREPARE_TOOLS), \
           $$(foreach host,$$(CFG_HOST), \
             prepare-host-tool-$$(tool)-$$(PREPARE_STAGE)-$$(host)-$(1)))

 prepare-host-dirs-$(1): prepare-maybe-clean-$(1)
 	$$(call PREPARE_DIR,$$(PREPARE_DEST_BIN_DIR))
 	$$(call PREPARE_DIR,$$(PREPARE_DEST_LIB_DIR))
 	$$(call PREPARE_DIR,$$(PREPARE_DEST_LIB_DIR)/rustlib/etc)
 	$$(call PREPARE_DIR,$$(PREPARE_DEST_MAN_DIR))

 prepare-debugger-scripts-$(1): prepare-host-dirs-$(1) \
                                $$(DEBUGGER_BIN_SCRIPTS_ALL_ABS) \
                                $$(DEBUGGER_RUSTLIB_ETC_SCRIPTS_ALL_ABS)
 	$$(call INSTALL_DEBUGGER_SCRIPT_COMMANDS,$$(PREPARE_HOST))

 $$(foreach tool,$$(PREPARE_TOOLS), \
   $$(foreach host,$$(CFG_HOST), \
       $$(eval $$(call DEF_PREPARE_HOST_TOOL,$$(tool),$$(PREPARE_STAGE),$$(host),$(1)))))

 $$(foreach lib,$$(CRATES), \
   $$(foreach host,$$(CFG_HOST), \
     $$(eval $$(call DEF_PREPARE_HOST_LIB,$$(lib),$$(PREPARE_STAGE),$$(host),$(1)))))

 prepare-target-$(1): \
         $$(foreach host,$$(CFG_HOST), \
            $$(foreach target,$$(CFG_TARGET), \
              prepare-target-$$(target)-host-$$(host)-$$(PREPARE_STAGE)-$(1)))

 $$(foreach host,$$(CFG_HOST), \
   $$(foreach target,$$(CFG_TARGET), \
     $$(eval $$(call DEF_PREPARE_TARGET_N,$$(PREPARE_STAGE),$$(target),$$(host),$(1)))))

 prepare-maybe-clean-$(1):
 	$$(if $$(findstring true,$$(PREPARE_CLEAN)), \
       @$$(call E, cleaning destination $$(PREPARE_DEST_DIR)),)
 	$$(if $$(findstring true,$$(PREPARE_CLEAN)), \
       $$(Q)rm -rf $$(PREPARE_DEST_DIR),)


 endef
	# Copyright 2014 The Rust Project Developers. See the COPYRIGHT
	# file at the top-level directory of this distribution and at
	# http://rust-lang.org/COPYRIGHT.
	#
	# Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
	# http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
	# <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
	# option. This file may not be copied, modified, or distributed
	# except according to those terms.

	# Basic support for producing installation images.
	#
	# The 'prepare' build target copies all release artifacts from the build
	# directory to some other location, placing all binaries, libraries, and
	# docs in their final locations relative to each other.
	#
	# It requires the following variables to be set:
	#
	# PREPARE_HOST - the host triple
	# PREPARE_TARGETS - the target triples, space separated
	# PREPARE_DEST_DIR - the directory to put the image

	PREPARE_STAGE=2

	DEFAULT_PREPARE_DIR_CMD = umask 022 && mkdir -p
	DEFAULT_PREPARE_BIN_CMD = install -m755
	DEFAULT_PREPARE_LIB_CMD = install -m644
	DEFAULT_PREPARE_MAN_CMD = install -m644

	# Create a directory
	# $(1) is the directory
	#
	# XXX: These defines are called to generate make steps.
	# Adding blank lines means two steps from different defines will not end up on
	# the same line.
	define PREPARE_DIR

	@$(call E, prepare: $(1))
	$(Q)$(PREPARE_DIR_CMD) $(1)

	endef

	# Copy an executable
	# $(1) is the filename/libname-glob
	#
	# See above for an explanation on the surrounding blank lines
	define PREPARE_BIN

	@$(call E, prepare: $(PREPARE_DEST_BIN_DIR)/$(1))
	$(Q)$(PREPARE_BIN_CMD) $(PREPARE_SOURCE_BIN_DIR)/$(1) $(PREPARE_DEST_BIN_DIR)/$(1)

	endef

	# Copy a dylib or rlib
	# $(1) is the filename/libname-glob
	#
	# See above for an explanation on the surrounding blank lines
	define PREPARE_LIB

	@$(call E, prepare: $(PREPARE_WORKING_DEST_LIB_DIR)/$(1))
	$(Q)LIB_NAME="$(notdir $(lastword $(wildcard $(PREPARE_WORKING_SOURCE_LIB_DIR)/$(1))))"; \
	MATCHES="$(filter-out %$(notdir $(lastword $(wildcard $(PREPARE_WORKING_SOURCE_LIB_DIR)/$(1)))), \
	$(wildcard $(PREPARE_WORKING_DEST_LIB_DIR)/$(1)))"; \
	if [ -n "$$MATCHES" ]; then \
	echo "warning: one or libraries matching Rust library '$(1)'" && \
	echo " (other than '$$LIB_NAME' itself) already present" && \
	echo " at destination $(PREPARE_WORKING_DEST_LIB_DIR):" && \
	echo $$MATCHES ; \
	fi
	$(Q)$(PREPARE_LIB_CMD) `ls -drt1 $(PREPARE_WORKING_SOURCE_LIB_DIR)/$(1)` $(PREPARE_WORKING_DEST_LIB_DIR)/

	endef

	# Copy a man page
	# $(1) - source dir
	#
	# See above for an explanation on the surrounding blank lines
	define PREPARE_MAN

	@$(call E, prepare: $(PREPARE_DEST_MAN_DIR)/$(1))
	$(Q)$(PREPARE_MAN_CMD) $(PREPARE_SOURCE_MAN_DIR)/$(1) $(PREPARE_DEST_MAN_DIR)/$(1)

	endef

	PREPARE_TOOLS = $(filter-out compiletest rustbook error_index_generator, $(TOOLS))


	# $(1) is tool
	# $(2) is stage
	# $(3) is host
	# $(4) tag
	define DEF_PREPARE_HOST_TOOL
	prepare-host-tool-$(1)-$(2)-$(3)-$(4): \
	PREPARE_SOURCE_BIN_DIR=$$(HBIN$(2)_H_$(3))
	prepare-host-tool-$(1)-$(2)-$(3)-$(4): prepare-maybe-clean-$(4) \
	$$(foreach dep,$$(TOOL_DEPS_$(1)),prepare-host-lib-$$(dep)-$(2)-$(3)-$(4)) \
	$$(HBIN$(2)_H_$(3))/$(1)$$(X_$(3)) \
	prepare-host-dirs-$(4)
	$$(if $$(findstring $(2), $$(PREPARE_STAGE)), \
	$$(if $$(findstring $(3), $$(PREPARE_HOST)), \
	$$(call PREPARE_BIN,$(1)$$(X_$$(PREPARE_HOST))),),)
	$$(if $$(findstring $(2), $$(PREPARE_STAGE)), \
	$$(if $$(findstring $(3), $$(PREPARE_HOST)), \
	$$(call PREPARE_MAN,$(1).1),),)
	endef

	# Libraries are compiled using the --libdir provided to configure, but
	# we store them in the tarball using just "lib" so that the install
	# script can then rewrite them back to the correct path.
	PREPARE_TAR_LIB_DIR = $(patsubst $(CFG_LIBDIR_RELATIVE)%,lib%,$(1))

	# For host libraries only install dylibs, not rlibs since the host libs are only
	# used to support rustc and rustc uses dynamic linking
	#
	# $(1) is tool
	# $(2) is stage
	# $(3) is host
	# $(4) tag
	define DEF_PREPARE_HOST_LIB
	prepare-host-lib-$(1)-$(2)-$(3)-$(4): \
	PREPARE_WORKING_SOURCE_LIB_DIR=$$(HLIB$(2)_H_$(3))
	prepare-host-lib-$(1)-$(2)-$(3)-$(4): \
	PREPARE_WORKING_DEST_LIB_DIR=$$(PREPARE_DEST_DIR)/$$(call PREPARE_TAR_LIB_DIR,$$(HLIB_RELATIVE$(2)_H_$(3)))
	prepare-host-lib-$(1)-$(2)-$(3)-$(4): prepare-maybe-clean-$(4) \
	$$(foreach dep,$$(RUST_DEPS_$(1)_T_$(3)),prepare-host-lib-$$(dep)-$(2)-$(3)-$(4)) \
	$$(HLIB$(2)_H_$(3))/stamp.$(1) \
	prepare-host-dirs-$(4)
	$$(if $$(findstring $(2), $$(PREPARE_STAGE)), \
	$$(if $$(findstring $(3), $$(PREPARE_HOST)), \
	$$(if $$(findstring 1,$$(ONLY_RLIB_$(1))),, \
	$$(call PREPARE_LIB,$$(call CFG_LIB_GLOB_$$(PREPARE_HOST),$(1)))),),)
	endef


	# $(1) is stage
	# $(2) is target
	# $(3) is host
	# $(4) tag
	define DEF_PREPARE_TARGET_N
	# Rebind PREPARE_*_LIB_DIR to point to rustlib, then install the libs for the targets
	prepare-target-$(2)-host-$(3)-$(1)-$(4): \
	PREPARE_WORKING_SOURCE_LIB_DIR=$$(TLIB$(1)_T_$(2)_H_$(3))
	prepare-target-$(2)-host-$(3)-$(1)-$(4): \
	PREPARE_WORKING_DEST_LIB_DIR=$$(PREPARE_DEST_LIB_DIR)/rustlib/$(2)/lib
	prepare-target-$(2)-host-$(3)-$(1)-$(4): \
	PREPARE_SOURCE_BIN_DIR=$$(TBIN$(1)_T_$(2)_H_$(3))
	prepare-target-$(2)-host-$(3)-$(1)-$(4): \
	PREPARE_DEST_BIN_DIR=$$(PREPARE_DEST_LIB_DIR)/rustlib/$(3)/bin
	prepare-target-$(2)-host-$(3)-$(1)-$(4): prepare-maybe-clean-$(4) \
	$$(foreach crate,$$(TARGET_CRATES_$(2)), \
	$$(TLIB$(1)_T_$(2)_H_$(3))/stamp.$$(crate)) \
	$$(if $$(findstring $(2),$$(CFG_HOST)), \
	$$(foreach crate,$$(HOST_CRATES), \
	$$(TLIB$(1)_T_$(2)_H_$(3))/stamp.$$(crate)),)
	# Only install if this host and target combo is being prepared. Also be sure to
	# not install the rlibs for host crates because there's no need to statically
	# link against most of them. They just produce a large amount of extra size
	# bloat.
	$$(if $$(findstring $(1), $$(PREPARE_STAGE)), \
	$$(if $$(findstring $(2), $$(PREPARE_TARGETS)), \
	$$(if $$(findstring $(3), $$(PREPARE_HOST)), \
	$$(call PREPARE_DIR,$$(PREPARE_WORKING_DEST_LIB_DIR)) \
	$$(call PREPARE_DIR,$$(PREPARE_DEST_BIN_DIR)) \
	$$(foreach crate,$$(TARGET_CRATES_$(2)), \
	$$(if $$(or $$(findstring 1, $$(ONLY_RLIB_$$(crate))),$$(findstring 1,$$(CFG_INSTALL_ONLY_RLIB_$(2)))),, \
	$$(call PREPARE_LIB,$$(call CFG_LIB_GLOB_$(2),$$(crate)))) \
	$$(call PREPARE_LIB,$$(call CFG_RLIB_GLOB,$$(crate)))) \
	$$(if $$(findstring $(2),$$(CFG_HOST)), \
	$$(foreach crate,$$(HOST_CRATES), \
	$$(call PREPARE_LIB,$$(call CFG_LIB_GLOB_$(2),$$(crate)))),) \
	$$(foreach object,$$(INSTALLED_OBJECTS_$(2)),\
	$$(call PREPARE_LIB,$$(object))) \
	$$(foreach bin,$$(INSTALLED_BINS_$(3)),\
	$$(call PREPARE_BIN,$$(bin))) \
	,),),)
	endef

	define INSTALL_GDB_DEBUGGER_SCRIPTS_COMMANDS
	$(Q)$(PREPARE_BIN_CMD) $(DEBUGGER_BIN_SCRIPTS_GDB_ABS) $(PREPARE_DEST_BIN_DIR)
	$(Q)$(PREPARE_LIB_CMD) $(DEBUGGER_RUSTLIB_ETC_SCRIPTS_GDB_ABS) $(PREPARE_DEST_LIB_DIR)/rustlib/etc
	endef

	define INSTALL_LLDB_DEBUGGER_SCRIPTS_COMMANDS
	$(Q)$(PREPARE_BIN_CMD) $(DEBUGGER_BIN_SCRIPTS_LLDB_ABS) $(PREPARE_DEST_BIN_DIR)
	$(Q)$(PREPARE_LIB_CMD) $(DEBUGGER_RUSTLIB_ETC_SCRIPTS_LLDB_ABS) $(PREPARE_DEST_LIB_DIR)/rustlib/etc
	endef

	define INSTALL_NO_DEBUGGER_SCRIPTS_COMMANDS
	$(Q)echo "No debugger scripts will be installed for host $(PREPARE_HOST)"
	endef

	# $(1) is PREPARE_HOST
	INSTALL_DEBUGGER_SCRIPT_COMMANDS=$(if $(findstring windows,$(1)),\
	$(INSTALL_NO_DEBUGGER_SCRIPTS_COMMANDS),\
	$(if $(findstring darwin,$(1)),\
	$(INSTALL_LLDB_DEBUGGER_SCRIPTS_COMMANDS),\
	$(INSTALL_GDB_DEBUGGER_SCRIPTS_COMMANDS)))

	define DEF_PREPARE

	prepare-base-$(1)-%: PREPARE_SOURCE_MAN_DIR=$$(S)/man
	prepare-base-$(1)-%: PREPARE_DEST_BIN_DIR=$$(PREPARE_DEST_DIR)/bin
	prepare-base-$(1)-%: PREPARE_DEST_LIB_DIR=$$(PREPARE_DEST_DIR)/$$(call PREPARE_TAR_LIB_DIR,$$(CFG_LIBDIR_RELATIVE))
	prepare-base-$(1)-%: PREPARE_DEST_MAN_DIR=$$(PREPARE_DEST_DIR)/share/man/man1

	prepare-base-$(1)-target: prepare-target-$(1)
	prepare-base-$(1)-host: prepare-host-$(1) prepare-debugger-scripts-$(1)

	prepare-host-$(1): prepare-host-tools-$(1)

	prepare-host-tools-$(1): \
	$$(foreach tool, $$(PREPARE_TOOLS), \
	$$(foreach host,$$(CFG_HOST), \
	prepare-host-tool-$$(tool)-$$(PREPARE_STAGE)-$$(host)-$(1)))

	prepare-host-dirs-$(1): prepare-maybe-clean-$(1)
	$$(call PREPARE_DIR,$$(PREPARE_DEST_BIN_DIR))
	$$(call PREPARE_DIR,$$(PREPARE_DEST_LIB_DIR))
	$$(call PREPARE_DIR,$$(PREPARE_DEST_LIB_DIR)/rustlib/etc)
	$$(call PREPARE_DIR,$$(PREPARE_DEST_MAN_DIR))

	prepare-debugger-scripts-$(1): prepare-host-dirs-$(1) \
	$$(DEBUGGER_BIN_SCRIPTS_ALL_ABS) \
	$$(DEBUGGER_RUSTLIB_ETC_SCRIPTS_ALL_ABS)
	$$(call INSTALL_DEBUGGER_SCRIPT_COMMANDS,$$(PREPARE_HOST))

	$$(foreach tool,$$(PREPARE_TOOLS), \
	$$(foreach host,$$(CFG_HOST), \
	$$(eval $$(call DEF_PREPARE_HOST_TOOL,$$(tool),$$(PREPARE_STAGE),$$(host),$(1)))))

	$$(foreach lib,$$(CRATES), \
	$$(foreach host,$$(CFG_HOST), \
	$$(eval $$(call DEF_PREPARE_HOST_LIB,$$(lib),$$(PREPARE_STAGE),$$(host),$(1)))))

	prepare-target-$(1): \
	$$(foreach host,$$(CFG_HOST), \
	$$(foreach target,$$(CFG_TARGET), \
	prepare-target-$$(target)-host-$$(host)-$$(PREPARE_STAGE)-$(1)))

	$$(foreach host,$$(CFG_HOST), \
	$$(foreach target,$$(CFG_TARGET), \
	$$(eval $$(call DEF_PREPARE_TARGET_N,$$(PREPARE_STAGE),$$(target),$$(host),$(1)))))

	prepare-maybe-clean-$(1):
	$$(if $$(findstring true,$$(PREPARE_CLEAN)), \
	@$$(call E, cleaning destination $$(PREPARE_DEST_DIR)),)
	$$(if $$(findstring true,$$(PREPARE_CLEAN)), \
	$$(Q)rm -rf $$(PREPARE_DEST_DIR),)


	endef