Add a make variable to GNUmakefile for building the Tcl.framework for use as a subframework

2 files changed, 14 insertions, 0 deletions

diff --git a/macosx/GNUmakefile b/macosx/GNUmakefile
index 56e5500..e55b661 100644
--- a/macosx/GNUmakefile
+++ b/macosx/GNUmakefile
@@ -150,6 +150,9 @@ install-${PROJECT}: build-${PROJECT}
 ifeq (${EMBEDDED_BUILD}_${INSTALL_ROOT},1_)
 	@echo "Cannot install-embedded with empty INSTALL_ROOT !" && false
 endif
+ifeq (${SUBFRAMEWORK}_${DYLIB_INSTALL_DIR},1_)
+	@echo "Cannot install-subframework with empty DYLIB_INSTALL_DIR !" && false
+endif
 ifeq (${EMBEDDED_BUILD},1)
 	@rm -rf "${INSTALL_ROOT}${LIBDIR}/Tcl.framework"
 endif
diff --git a/macosx/README b/macosx/README
index c944c0a..cb36811 100644
--- a/macosx/README
+++ b/macosx/README
@@ -165,3 +165,14 @@ If you only want to build and install the debug or optimized build, use the
 For example, to build and install only the optimized versions:
 	make -C tcl${ver}/macosx deploy
 	sudo make -C tcl${ver}/macosx install-deploy
+
+- To build a Tcl.framework for use as a subframework in another framework, use the
+install-embedded target and set SUBFRAMEWORK=1.  Set the DYLIB_INSTALL_DIR
+variable to the path which should be the install_name path of the Tcl library, set
+the DESTDIR variable to the pathname of a staging directory where the framework
+will be written .  For example, running this command in the Tcl source directory:
+	make -C macosx install-embedded SUBFRAMEWORK=1 DESTDIR=/tmp/tcl \
+	DYLIB_INSTALL_DIR=/Library/Frameworks/Some.framework/Versions/3.9/Frameworks/Tcl
+will produce a Tcl.framework intended for installing as a subframework of the
+Python.framework.  The framework will be found in /tmp/tcl/Library/Frameworks/
+