react-native-nitro-xlsx 0.2.5 → 0.2.7

package/thirdparty/OpenXLSX/Makefile.GNU

@@ -0,0 +1,530 @@
+# GNU Makefile for OpenXLSX modules & demos
+# Version: 2025-08-26 15:15 CEST
+# $(error 2025-08-16 15:30 CEST: With recent changes to the project configuration, the GNU Makefile is currently non-functional)
+
+$(info 2025-08-26 Temporary override of options (only supported configuration is with libpugixml and libzip preinstalled on the build system))
+$(info ___________It remains TBD whether it will be possible (or is even desired) to pull in dependencies from the GNU Makefile)
+OPENXLSX_ENABLE_LIBPUGIXML=ON
+OPENXLSX_ENABLE_LIBZIP=ON
+OPENXLSX_ENABLE_LIBBOOST_NOWIDE=ON
+OPENXLSX_SHARED_LIBRARY=OFF
+$(info OPENXLSX_ENABLE_LIBPUGIXML         $(OPENXLSX_ENABLE_LIBPUGIXML))
+$(info OPENXLSX_ENABLE_LIBZIP             $(OPENXLSX_ENABLE_LIBZIP))
+$(info OPENXLSX_ENABLE_LIBBOOST_NOWIDE    $(OPENXLSX_ENABLE_LIBBOOST_NOWIDE))
+$(info OPENXLSX_SHARED_LIBRARY            $(OPENXLSX_SHARED_LIBRARY))
+
+# Makefile option OPENXLSX_ENABLE_LIBPUGIXML: Scripts/make-gnu.sh OPENXLSX_ENABLE_LIBPUGIXML=ON
+ifeq ("$(OPENXLSX_ENABLE_LIBPUGIXML)", "ON")
+	# use libpugixml
+	USE_LIBPUGIXML=yes
+else
+	# use pugixml in header-only version shipped with OpenXLSX
+	OPENXLSX_ENABLE_LIBPUGIXML=OFF
+	USE_LIBPUGIXML=no
+endif
+
+# Makefile option OPENXLSX_ENABLE_LIBZIP: Scripts/make-gnu.sh OPENXLSX_ENABLE_LIBZIP=ON (default)
+ifeq ("$(OPENXLSX_ENABLE_LIBZIP)", "OFF")
+	# use zippy
+	USE_LIBZIP=no
+else
+	# use libzip
+	OPENXLSX_ENABLE_LIBZIP=ON
+	USE_LIBZIP=yes
+endif
+
+# Makefile option OPENXLSX_FORCE_NOWIDE: Scripts/make-gnu.sh OPENXLSX_FORCE_NOWIDE=ON
+ifeq ("$(OPENXLSX_FORCE_NOWIDE)", "ON")
+	USE_NOWIDE_DEFAULT=yes
+else
+        OPENXLSX_FORCE_NOWIDE=OFF
+	USE_NOWIDE_DEFAULT=no
+endif
+
+# Makefile option OPENXLSX_ENABLE_LIBBOOST_NOWIDE: Scripts/make-gnu.sh OPENXLSX_ENABLE_LIBBOOST_NOWIDE=ON
+ifeq ("$(OPENXLSX_ENABLE_LIBBOOST_NOWIDE)", "ON")
+	# use libpugixml
+	USE_LIBBOOST_NOWIDE=yes
+else
+	# use pugixml in header-only version shipped with OpenXLSX
+	OPENXLSX_ENABLE_LIBBOOST_NOWIDE=OFF
+	USE_LIBBOOST_NOWIDE=no
+endif
+
+# Makefile option OPENXLSX_SHARED_LIBRARY: Scripts/make-gnu.sh OPENXLSX_SHARED_LIBRARY=ON
+ifeq ("$(OPENXLSX_SHARED_LIBRARY)", "ON")
+	# NOTE: Currently unsupported in GNU Makefile:
+	# build shared library
+	USE_SHARED_LIBRARY=yes
+else
+	# build static library (default & only supported option in GNU Makefile)
+	OPENXLSX_SHARED_LIBRARY=OFF
+	USE_SHARED_LIBRARY=no
+endif
+
+# version tags
+OPENXLSX_MAJOR_VERSION=0
+OPENXLSX_MINOR_VERSION=4
+OPENXLSX_MICRO_VERSION=2
+
+# NOTE: lib and library are available as aliases for OpenXLSX, to build the static library file
+TARGETS=OpenXLSX Demo1 Demo2 Demo3 Demo4 Demo5 Demo6 Demo7 Demo8 Demo9 Demo10
+ADDITIONAL_TARGETS=Demo1A
+
+DEMOS_SRC_DIR=Examples
+BIN_DIR=output
+
+CC=gcc
+CXX=g++
+
+# /usr/bin/ar: create archive without symbol table
+AR=ar
+# /usr/bin/ranlib: add symbol table to archive created with ar
+RANLIB=ranlib
+
+
+OPTIMIZATION_FLAGS=
+#OPTIMIZATION_FLAGS=-O3
+
+# === BEGIN: Detect OS platform based on gcc compiler defines ===
+# Actual detection command:
+DETECT_CMD="echo | $(CC) -dM -E -"
+
+# Test commands to "simulate" a platform
+# DETECT_CMD="echo \"\#define WIN32 1\""
+# DETECT_CMD="echo \"\#define _WIN32 1\""
+# DETECT_CMD="echo \"\#define __WIN32__ 1\""
+# DETECT_CMD="echo \"\#define _WIN64 1\""
+# DETECT_CMD="printf '\#define WIN32 1\n\#define _WIN32 1\n\#define __WIN32__ 1\n\#define _WIN64 1'" # test all defines together with line breaks
+# DETECT_CMD="echo \"\#define __linux__ 1\""
+# DETECT_CMD="echo \"\#define __CYGWIN__ 1\""
+
+__linux__ := $(shell "$(DETECT_CMD)" | grep "\b__linux__\b")
+ifdef __linux__
+	Linux=yes
+else
+	Linux=no
+endif
+
+WIN32 := $(shell "$(DETECT_CMD)" | grep "\bWIN32\b")
+_WIN32 := $(shell "$(DETECT_CMD)" | grep "\b_WIN32\b")
+__WIN32__ := $(shell "$(DETECT_CMD)" | grep "\b__WIN32__\b")
+_WIN64 := $(shell "$(DETECT_CMD)" | grep "\b_WIN64\b")
+ifdef WIN32
+	Windows=yes
+else ifdef _WIN32
+	Windows=yes
+else ifdef __WIN32__
+	Windows=yes
+else ifdef _WIN64
+	Windows=yes
+else
+	Windows=no
+endif
+
+__CYGWIN__ := $(shell "$(DETECT_CMD)" | grep "\b__CYGWIN__\b")
+ifdef __CYGWIN__
+	Cygwin=yes
+else
+	Cygwin=no
+endif
+# === END: detect OS platform based on gcc compiler defines ===
+
+OPENXLSX_DIR=OpenXLSX
+SRC_DIR=sources
+INCLUDE_DIR=headers
+OBJ_DIR=obj
+STATIC_LIBRARY=libOpenXLSX.a
+
+USE_NOWIDE=$(USE_NOWIDE_DEFAULT)
+ifeq ("$(Windows)", "yes")
+	# enable nowide on windows. CAUTION: do not append this comment to the variable assignment, it will break the ifeq check below
+	USE_NOWIDE=yes
+endif
+
+# SHARED_SUBDIR=shared
+EXTERNAL_SUBDIR=external
+NOWIDE_SUBDIR=$(EXTERNAL_SUBDIR)/nowide
+PUGIXML_SUBDIR=$(EXTERNAL_SUBDIR)/pugixml
+ZIPPY_SUBDIR=$(EXTERNAL_SUBDIR)/zippy
+
+# library / utility objects
+# OBJS_LICENSE=license.o
+# OBJS_SHARED=$(OBJS_LICENSE)
+OBJS_PUGIXML= # used as header-only module OR as system library (if USE_LIBPUGIXML=yes)
+OBJS_ZIPPY=   # header-only module
+OBJS_OPENXLSX=XLCell.o XLCellIterator.o XLCellRange.o XLCellReference.o XLCellValue.o XLColor.o XLColumn.o XLComments.o XLContentTypes.o XLDateTime.o XLDocument.o XLDrawing.o XLFormula.o XLMergeCells.o XLProperties.o XLRelationships.o XLRow.o XLRowData.o XLSharedStrings.o XLSheet.o XLStyles.o XLTables.o XLWorkbook.o XLXmlData.o XLXmlFile.o XLXmlParser.o XLZipArchive.o
+
+# create a version of OBJS_OPENXLSX that already has the correct prefix so that it can be used for linking without further modification
+OBJS_OPENXLSX_PREFIXED=$(addprefix $(OBJ_DIR)/$(OPENXLSX_DIR)/,$(OBJS_OPENXLSX))
+
+# OBJS_DEMOS=$(OBJS_OPENXLSX_PREFIXED) # no longer needed - using static library instead
+OBJS_DEMOS=$(BIN_DIR)/$(STATIC_LIBRARY) # use static library for linking demos
+
+ifeq ("$(USE_LIBPUGIXML)", "yes")
+	LDLIBS_PUGIXML=-lpugixml
+	ENABLE_LIBPUGIXML=-DUSE_LIBPUGIXML
+	INCLUDE_DIR_PUGIXML= # do not identify OpenXLSX-shipped pugixml path
+else
+	INCLUDE_DIR_PUGIXML= -I$(OPENXLSX_DIR)/$(PUGIXML_SUBDIR)
+endif
+ifeq ("$(USE_LIBZIP)", "yes")
+	ENABLE_LIBZIP=-DUSE_LIBZIP
+	LDLIBS_LIBZIP=-lzip
+endif
+ifeq ("$(USE_NOWIDE)", "yes")
+	ifeq ("$(USE_LIBBOOST_NOWIDE)", "yes")
+		ENABLE_NOWIDE=-DENABLE_NOWIDE -DENABLE_LIBBOOST_NOWIDE
+	else
+		ENABLE_NOWIDE=-DENABLE_NOWIDE
+	endif
+endif
+PROJECT_FLAGS=$(ENABLE_LIBPUGIXML) $(ENABLE_LIBZIP) $(ENABLE_NOWIDE)
+
+# additional include directories for 1) OPENXLSX project headers and 2) external nowide (parent) folder
+ADDITIONAL_INCLUDE_FLAGS=-I$(OPENXLSX_DIR) -I$(OPENXLSX_DIR)/$(EXTERNAL_SUBDIR)
+
+# application objects
+
+# Demo0 is a placeholder for test programs - if used, has to be explicitly provided as build target (not included in defaults)
+OBJS_DEMO0=Demo0.o
+OBJS_OPENXLSX_DEMO0=$(OBJS_DEMOS)
+LDLIBS_DEMO0=
+
+OBJS_DEMO1=Demo1.o
+OBJS_OPENXLSX_DEMO1=$(OBJS_DEMOS)
+LDLIBS_DEMO1=
+
+OBJS_DEMO1A=Demo1A.o
+OBJS_OPENXLSX_DEMO1A=$(OBJS_DEMOS)
+LDLIBS_DEMO1A=
+
+OBJS_DEMO2=Demo2.o
+OBJS_OPENXLSX_DEMO2=$(OBJS_DEMOS)
+LDLIBS_DEMO2=
+
+OBJS_DEMO3=Demo3.o
+OBJS_OPENXLSX_DEMO3=$(OBJS_DEMOS)
+LDLIBS_DEMO3=
+
+OBJS_DEMO4=Demo4.o
+OBJS_OPENXLSX_DEMO4=$(OBJS_DEMOS)
+LDLIBS_DEMO4=
+
+OBJS_DEMO5=Demo5.o
+OBJS_OPENXLSX_DEMO5=$(OBJS_DEMOS)
+LDLIBS_DEMO5=
+
+OBJS_DEMO6=Demo6.o
+OBJS_OPENXLSX_DEMO6=$(OBJS_DEMOS)
+LDLIBS_DEMO6=
+
+OBJS_DEMO7=Demo7.o
+OBJS_OPENXLSX_DEMO7=$(OBJS_DEMOS)
+LDLIBS_DEMO7=
+
+OBJS_DEMO8=Demo8.o
+OBJS_OPENXLSX_DEMO8=$(OBJS_DEMOS)
+LDLIBS_DEMO8=
+
+OBJS_DEMO9=Demo9.o
+OBJS_OPENXLSX_DEMO9=$(OBJS_DEMOS)
+LDLIBS_DEMO9=
+
+OBJS_DEMO10=Demo10.o
+OBJS_OPENXLSX_DEMO10=$(OBJS_DEMOS)
+LDLIBS_DEMO10=
+
+SANITIZE_FLAGS=
+# SANITIZE_FLAGS=-fsanitize=address
+# SANITIZE_FLAGS=-fsanitize=address -fsanitize=leak
+SANITIZE_LIBS=
+# SANITIZE_LIBS=-llsan
+
+# 2024-08-18 warning state:
+#   misleading-indentation: 0 warnings
+#   sign-compare: 0 warnings
+#   unknown-pragmas: 0 (disabled warning about previous 144 lines upsetting gcc/g++ by pragma)
+#   unused-function: 3 (disabled by pragma)
+#     OpenXLSX/sources/XLProperties.cpp: std::vector<std::string> headingPairsCategoriesStrings(XMLNode docNode)
+#     OpenXLSX/sources/XLDocument.cpp: bool fileExists(const std::string& fileName)
+#                                      bool isDirectory(const std::string& fileName)
+ENABLED_WARNING_FLAGS=-Wformat -Wformat-signedness -Wall -Wpedantic -Wextra
+DISABLED_WARNING_FLAGS=
+
+GENERIC_FLAGS=$(ADDITIONAL_INCLUDE_FLAGS) $(PROJECT_FLAGS) -fno-common $(SANITIZE_FLAGS) $(OPTIMIZATION_FLAGS) $(ENABLED_WARNING_FLAGS) $(DISABLED_WARNING_FLAGS)
+
+CPPFLAGS=$(GENERIC_FLAGS) -std=c++17
+# CPPFLAGS=$(GENERIC_FLAGS) -std=c++17 -D_GNU_SOURCE -D_POSIX_C_SOURCE=200809L -D_XOPEN_SOURCE=700
+
+LDFLAGS=$(SANITIZE_FLAGS)
+# LDFLAGS=-fno-common
+
+# TEST: truncate binary to actually used code (https://gcc.gnu.org/onlinedocs/gnat_ugn/Compilation-options.html)
+# GENERIC_FLAGS+= -ffunction-sections -fdata-sections
+# LDFLAGS+= -Wl,--gc-sections
+
+
+# precompiled libs go here
+LDLIBS=$(SANITIZE_LIBS) $(LDLIBS_PUGIXML) $(LDLIBS_LIBZIP)
+# LDLIBS=-lrt -pthread -lboost_program_options $(SANITIZE_LIBS) # example to add libraries if needed
+
+
+## additional tools for text substitution:
+# call tools like so:
+# VAR = MixedCaseText
+# LOWER_VAR = $(call lc,$(VAR))
+#   create all lowercase variable:
+# lc = $(subst A,a,$(subst B,b,$(subst C,c,$(subst D,d,$(subst E,e,$(subst F,f,$(subst G,g,$(subst H,h,$(subst I,i,$(subst J,j,$(subst K,k,$(subst L,l,$(subst M,m,$(subst N,n,$(subst O,o,$(subst P,p,$(subst Q,q,$(subst R,r,$(subst S,s,$(subst T,t,$(subst U,u,$(subst V,v,$(subst W,w,$(subst X,x,$(subst Y,y,$(subst Z,z,$1))))))))))))))))))))))))))
+#   create all uppercase variable:
+uc = $(subst a,A,$(subst b,B,$(subst c,C,$(subst d,D,$(subst e,E,$(subst f,F,$(subst g,G,$(subst h,H,$(subst i,I,$(subst j,J,$(subst k,K,$(subst l,L,$(subst m,M,$(subst n,N,$(subst o,O,$(subst p,P,$(subst q,Q,$(subst r,R,$(subst s,S,$(subst t,T,$(subst u,U,$(subst v,V,$(subst w,W,$(subst x,X,$(subst y,Y,$(subst z,Z,$1))))))))))))))))))))))))))
+
+
+## gnu make override to define the default make directive, only takes a single target
+.DEFAULT_GOAL := default
+default: $(TARGETS)
+
+all: $(TARGETS) $(ADDITIONAL_TARGETS)
+
+# the $(NOOP) rules are only needed for the dependency / forward to $(BIN_DIR)
+Demo0: $(BIN_DIR)/Demo0
+	$(NOOP)
+Demo1: $(BIN_DIR)/Demo1
+	$(NOOP)
+Demo1A: $(BIN_DIR)/Demo1A
+	$(NOOP)
+Demo2: $(BIN_DIR)/Demo2
+	$(NOOP)
+Demo3: $(BIN_DIR)/Demo3
+	$(NOOP)
+Demo4: $(BIN_DIR)/Demo4
+	$(NOOP)
+Demo5: $(BIN_DIR)/Demo5
+	$(NOOP)
+Demo6: $(BIN_DIR)/Demo6
+	$(NOOP)
+Demo7: $(BIN_DIR)/Demo7
+	$(NOOP)
+Demo8: $(BIN_DIR)/Demo8
+	$(NOOP)
+Demo9: $(BIN_DIR)/Demo9
+	$(NOOP)
+Demo10: $(BIN_DIR)/Demo10
+	$(NOOP)
+
+# re-direct from aliases
+lib: OpenXLSX
+library: OpenXLSX
+
+# static library target
+OpenXLSX: $(BIN_DIR)/$(STATIC_LIBRARY)
+
+# delete existing file, create static library archive file & add symbol table to archive
+# NOTE: if existing library file is not explicitly deleted, ar will fail to update a modified object file
+$(BIN_DIR)/$(STATIC_LIBRARY): $(OBJS_OPENXLSX_PREFIXED) | $(BIN_DIR)
+	rm -f $@ # explicitly delete existing library file
+	$(AR) qc $@ $(addprefix $(OBJ_DIR)/$(OPENXLSX_DIR)/,$(OBJS_OPENXLSX))
+	$(RANLIB) $@
+
+# complex rule for BIN_DIR targets: include objects from OBJS_<target> and libraries from LDLIBS_<target>
+.SECONDEXPANSION:
+$(BIN_DIR)/%: $$(addprefix $(OBJ_DIR)/,$$(OBJS_$$(call uc,$$*))) $$(OBJS_OPENXLSX_$$(call uc,$$*)) | $(BIN_DIR)
+	$(CXX) $(LDFLAGS) $^ $(LDLIBS) $(LDLIBS_$(call uc,$*)) -o $@
+
+# rule for .cpp files in DEMOS_SRC_DIR
+$(OBJ_DIR)/%.o: $(addprefix $(DEMOS_SRC_DIR)/,%.cpp) | $(OBJ_DIR) $(OPENXLSX_DIR)/OpenXLSX-Exports.hpp
+	$(CXX) $(CPPFLAGS) -I$(OPENXLSX_DIR)/$(INCLUDE_DIR) -I$(OPENXLSX_DIR)/$(NOWIDE_SUBDIR) -c $< -o $@
+
+# rule for OpenXLSX .cpp files
+$(OBJ_DIR)/$(OPENXLSX_DIR)/%.o: $(OPENXLSX_DIR)/$(SRC_DIR)/%.cpp | $(OBJ_DIR) $(OBJ_DIR)/$(OPENXLSX_DIR)/ $(OPENXLSX_DIR)/OpenXLSX-Exports.hpp
+	$(CXX) $(CPPFLAGS) -I$(OPENXLSX_DIR)/$(INCLUDE_DIR) -I$(OPENXLSX_DIR)/$(NOWIDE_SUBDIR) $(INCLUDE_DIR_PUGIXML) -I$(OPENXLSX_DIR)/$(ZIPPY_SUBDIR) -c $< -o $@
+
+# rule for nowide .cpp files: N/A, as nowide is header-only
+
+# rule for pugixml .cpp files: N/A, as pugixml is used as header only
+$(OBJ_DIR)/$(PUGIXML_SUBDIR)/%.o: $(OPENXLSX_DIR)/$(PUGIXML_SUBDIR)/%.cpp | $(OBJ_DIR) $(OBJ_DIR)/$(PUGIXML_SUBDIR)/
+	$(CXX) $(CPPFLAGS) $(INCLUDE_DIR_PUGIXML) -c $< -o $@
+
+# rule for zippy .cpp files: N/A, as zippy is header only
+
+$(OPENXLSX_DIR)/OpenXLSX-Exports.hpp:
+ifeq ("$(USE_SHARED_LIBRARY)", "yes")
+	cp gnu-make-crutch/OpenXLSX-Exports-shared.hpp $@
+else
+	cp gnu-make-crutch/OpenXLSX-Exports-static.hpp $@
+endif
+	
+# # rule for shared .cpp files
+# $(OBJ_DIR)/$(SHARED_SUBDIR)/%.o: $(OPENXLSX_DIR)/$(SRC_DIR)/$(SHARED_SUBDIR)/%.cpp | $(OBJ_DIR) $(OBJ_DIR)/$(SHARED_SUBDIR)/
+# 	$(CXX) $(CPPFLAGS) -I$(INCLUDE_DIR)/$(SHARED_SUBDIR) -c $< -o $@
+
+
+# create BIN_DIR if not existing
+$(BIN_DIR):
+	mkdir $@
+
+# create OBJ_DIR if not existing
+$(OBJ_DIR):
+	mkdir $@
+
+# $(OBJ_DIR)/$(SHARED_SUBDIR)/:
+# 	mkdir $@
+
+$(OBJ_DIR)/$(OPENXLSX_DIR)/:
+	mkdir $@
+
+$(OBJ_DIR)/$(PUGIXML_SUBDIR)/:
+	mkdir $@
+
+$(OBJ_DIR)/$(ZIPPY_SUBDIR)/:
+	mkdir $@
+
+# .SECONDARY with no prerequisites causes all targets to be treated
+# as secondary (i.e., no target is removed because it is considered
+# intermediate).
+.SECONDARY:
+
+# indicate all rules without target output
+.PHONY: default all clean cleanObjects cleanTargets cleanCrutch echo lib library OpenXLSX
+
+clean: cleanObjects cleanTargets cleanCrutch
+
+cleanObjects:
+	rm -f $(addprefix $(OBJ_DIR)/,$(OBJS_DEMO0) $(OBJS_DEMO1) $(OBJS_DEMO2) $(OBJS_DEMO3) $(OBJS_DEMO4) $(OBJS_DEMO5) $(OBJS_DEMO6) $(OBJS_DEMO7) $(OBJS_DEMO8) $(OBJS_DEMO9) $(OBJS_DEMO10)) \
+	      $(BIN_DIR)/$(STATIC_LIBRARY) \
+	      $(OBJS_OPENXLSX_PREFIXED) \
+	      $(addprefix $(OBJ_DIR)/$(PUGIXML_SUBDIR)/,$(OBJS_PUGIXML)) \
+	      $(addprefix $(OBJ_DIR)/$(ZIPPY_SUBDIR)/,$(OBJS_ZIPPY))
+# 	      $(addprefix $(OBJ_DIR)/$(SHARED_SUBDIR)/,$(OBJS_SHARED))
+
+cleanTargets:
+	rm -f $(addprefix $(BIN_DIR)/,Demo0) $(addprefix $(BIN_DIR)/,$(TARGETS)) $(addprefix $(BIN_DIR)/,$(ADDITIONAL_TARGETS))
+
+cleanCrutch:
+	rm $(OPENXLSX_DIR)/OpenXLSX-Exports.hpp 2>/dev/null
+
+
+# have a look at the established configuration
+echo:
+	@echo "OpenXLSX Makefile"
+	@echo "----------------------------------------------"
+	@echo "OpenXLSX library version: $(OPENXLSX_MAJOR_VERSION).$(OPENXLSX_MINOR_VERSION).$(OPENXLSX_MICRO_VERSION)"
+	@echo
+	@echo "Make options:"
+	@echo "  OPENXLSX_ENABLE_LIBPUGIXML:      $(OPENXLSX_ENABLE_LIBPUGIXML)"
+	@echo "  OPENXLSX_ENABLE_LIBZIP:          $(OPENXLSX_ENABLE_LIBZIP)"
+	@echo "  OPENXLSX_FORCE_NOWIDE:           $(OPENXLSX_FORCE_NOWIDE)"
+	@echo "  OPENXLSX_ENABLE_LIBBOOST_NOWIDE: $(OPENXLSX_ENABLE_LIBBOOST_NOWIDE)"
+	@echo "  OPENXLSX_SHARED_LIBRARY:         $(OPENXLSX_SHARED_LIBRARY)"
+	@echo "Resulting Makefile flags:"
+	@echo "  USE_LIBPUGIXML:      $(USE_LIBPUGIXML)"
+	@echo "  USE_LIBZIP:          $(USE_LIBZIP)"
+	@echo "  USE_NOWIDE_DEFAULT:  $(USE_NOWIDE_DEFAULT)"
+	@echo "  USE_LIBBOOST_NOWIDE: $(USE_LIBBOOST_NOWIDE)"
+	@echo "  USE_SHARED_LIBRARY:  $(USE_SHARED_LIBRARY) (currently unsupported, GNU Makefile will always build static library)"
+	@echo
+	@echo "TARGETS: $(TARGETS)"
+	@echo "ADDITIONAL_TARGETS: $(ADDITIONAL_TARGETS)"
+	@echo "DEMOS_SRC_DIR: $(DEMOS_SRC_DIR)"
+	@echo "BIN_DIR: $(BIN_DIR)"
+	@echo
+	@echo "CC    : $(CC)"
+	@echo "CXX   : $(CXX)"
+	@echo "AR    : $(AR)"
+	@echo "RANLIB: $(RANLIB)"
+	@echo
+	@echo "OPTIMIZATION_FLAGS: $(OPTIMIZATION_FLAGS)"
+	@echo
+	@echo "Platform detection variables:"
+	@echo "-----------------------------"
+	@echo 'DETECT_CMD: $(DETECT_CMD)'
+	@echo
+	@echo "__linux__ : $(__linux__)"
+	@echo "WIN32     : $(WIN32)"
+	@echo "_WIN32    : $(_WIN32)"
+	@echo "__WIN32__ : $(__WIN32__)"
+	@echo "_WIN64    : $(_WIN64)"
+	@echo "__CYGWIN__: $(__CYGWIN__)"
+	@echo
+	@echo "Platform detection results:"
+	@echo "---------------------------"
+	@echo "Linux  : $(Linux)"
+	@echo "Windows: $(Windows)"
+	@echo "Cygwin : $(Cygwin)"
+	@echo
+	@echo "OpenXLSX project configuration:"
+	@echo "-------------------------------"
+	@echo "USE_NOWIDE: $(USE_NOWIDE) (derived from Windows: $(Windows) and OPENXLSX_FORCE_NOWIDE: $(OPENXLSX_FORCE_NOWIDE))"
+	@echo
+	@echo "OPENXLSX_DIR: $(OPENXLSX_DIR)"
+	@echo "SRC_DIR: $(SRC_DIR)"
+	@echo "INCLUDE_DIR: $(INCLUDE_DIR)"
+	@echo "OBJ_DIR: $(OBJ_DIR)"
+	@echo "STATIC_LIBRARY: $(STATIC_LIBRARY)"
+	@echo
+	@echo "ENABLE_LIBPUGIXML: $(ENABLE_LIBPUGIXML)"
+	@echo "ENABLE_LIBZIP: $(ENABLE_LIBZIP)"
+	@echo "ENABLE_NOWIDE: $(ENABLE_NOWIDE)"
+	@echo
+# 	@echo "SHARED_SUBDIR: $(SHARED_SUBDIR)"
+	@echo "EXTERNAL_SUBDIR: $(EXTERNAL_SUBDIR)"
+	@echo "PUGIXML_SUBDIR: $(PUGIXML_SUBDIR)"
+	@echo "ZIPPY_SUBDIR: $(ZIPPY_SUBDIR)"
+	@echo
+# 	@echo "OBJS_LICENSE: $(OBJS_LICENSE)"
+# 	@echo "OBJS_SHARED: $(OBJS_SHARED)"
+	@echo "OBJS_PUGIXML: $(OBJS_PUGIXML)"
+	@echo "OBJS_ZIPPY: $(OBJS_ZIPPY)"
+	@echo "OBJS_OPENXLSX: $(OBJS_OPENXLSX)"
+	@echo "OBJS_OPENXLSX_PREFIXED: $(OBJS_OPENXLSX_PREFIXED)"
+	@echo "OBJS_DEMOS: $(OBJS_DEMOS)"
+	@echo
+	@echo "PROJECT_FLAGS: $(PROJECT_FLAGS)"
+	@echo "ADDITIONAL_INCLUDE_FLAGS: $(ADDITIONAL_INCLUDE_FLAGS)"
+	@echo
+	@echo "OBJS_DEMO0: $(OBJS_DEMO0)"
+	@echo "OBJS_OPENXLSX_DEMO0: $(OBJS_OPENXLSX_DEMO0)"
+	@echo "LDLIBS_DEMO0: $(LDLIBS_DEMO0)"
+	@echo "OBJS_DEMO1: $(OBJS_DEMO1)"
+	@echo "OBJS_OPENXLSX_DEMO1: $(OBJS_OPENXLSX_DEMO1)"
+	@echo "LDLIBS_DEMO1: $(LDLIBS_DEMO1)"
+	@echo "OBJS_DEMO2: $(OBJS_DEMO2)"
+	@echo "OBJS_OPENXLSX_DEMO2: $(OBJS_OPENXLSX_DEMO2)"
+	@echo "LDLIBS_DEMO2: $(LDLIBS_DEMO2)"
+	@echo "OBJS_DEMO3: $(OBJS_DEMO3)"
+	@echo "OBJS_OPENXLSX_DEMO3: $(OBJS_OPENXLSX_DEMO3)"
+	@echo "LDLIBS_DEMO3: $(LDLIBS_DEMO3)"
+	@echo "OBJS_DEMO4: $(OBJS_DEMO4)"
+	@echo "OBJS_OPENXLSX_DEMO4: $(OBJS_OPENXLSX_DEMO4)"
+	@echo "LDLIBS_DEMO4: $(LDLIBS_DEMO4)"
+	@echo "OBJS_DEMO5: $(OBJS_DEMO5)"
+	@echo "OBJS_OPENXLSX_DEMO5: $(OBJS_OPENXLSX_DEMO5)"
+	@echo "LDLIBS_DEMO5: $(LDLIBS_DEMO5)"
+	@echo "OBJS_DEMO6: $(OBJS_DEMO6)"
+	@echo "OBJS_OPENXLSX_DEMO6: $(OBJS_OPENXLSX_DEMO6)"
+	@echo "LDLIBS_DEMO6: $(LDLIBS_DEMO6)"
+	@echo "OBJS_DEMO7: $(OBJS_DEMO7)"
+	@echo "OBJS_OPENXLSX_DEMO7: $(OBJS_OPENXLSX_DEMO7)"
+	@echo "LDLIBS_DEMO7: $(LDLIBS_DEMO7)"
+	@echo "OBJS_DEMO8: $(OBJS_DEMO8)"
+	@echo "OBJS_OPENXLSX_DEMO8: $(OBJS_OPENXLSX_DEMO8)"
+	@echo "LDLIBS_DEMO8: $(LDLIBS_DEMO8)"
+	@echo "OBJS_DEMO9: $(OBJS_DEMO9)"
+	@echo "OBJS_OPENXLSX_DEMO9: $(OBJS_OPENXLSX_DEMO9)"
+	@echo "LDLIBS_DEMO9: $(LDLIBS_DEMO9)"
+	@echo "OBJS_DEMO10: $(OBJS_DEMO10)"
+	@echo "OBJS_OPENXLSX_DEMO10: $(OBJS_OPENXLSX_DEMO10)"
+	@echo "LDLIBS_DEMO10: $(LDLIBS_DEMO10)"
+	@echo
+	@echo "SANITIZE_FLAGS: $(SANITIZE_FLAGS)"
+	@echo "SANITIZE_LIBS: $(SANITIZE_LIBS)"
+	@echo "DISABLED_WARNING_FLAGS: $(DISABLED_WARNING_FLAGS)"
+	@echo "GENERIC_FLAGS: $(GENERIC_FLAGS)"
+	@echo "CPPFLAGS: $(CPPFLAGS)"
+	@echo
+	@echo "INCLUDE_DIR_PUGIXML: $(INCLUDE_DIR_PUGIXML)"
+	@echo
+	@echo "LDFLAGS: $(LDFLAGS)"
+	@echo "LDLIBS: $(LDLIBS)"
+	@echo "LDLIBS_PUGIXML: $(LDLIBS_PUGIXML)"
+	@echo "LDLIBS_LIBZIP: $(LDLIBS_LIBZIP)"

package/thirdparty/OpenXLSX/Notes/TBDs.txt

@@ -0,0 +1,16 @@
+TBD:
+----
+* in XLWorkbook::setSheetIndex: What does this section do: // ===== Updated defined names with worksheet scopes. ???
+* in XLWorkbook::updateSheetReferences: What does this function actually do (TBD to verify definedNames logic)???
+* how to invoke non-const XMLDocument* getXmlDocument()? Had to use a const_cast because the compiler insisted on
+  using the const version for the assignment to a non-const XMLDocument pointer
+
+
+TBC:
+----
+* Does zippy.hpp line 10614 have bug in the return statement of the lambda to erase files from the result:
+                                            return (subFolderDepth == rootDepth && filename.back() != '/') || (subFolderDepth > rootDepth);
+?
+If I don't misread this, the condition filename.back() != '/' would delete all filenames from the result that are not directories, which would be in contradiction to the function description
+         * @brief Get a list of the entries in a specific directory of the archive. Depending on the input parameters,
+         * the list will include directories, files or both.

package/thirdparty/OpenXLSX/Notes/confirmed-TBCs.txt

@@ -0,0 +1,8 @@
+CONFIRMED:
+* XLCellReference constructor shall throw exception on empty string
+* node.empty() works on empty nodes, e.g.: XLMNode node() // --> node.empty() evaluates to true
+* Does an XLSX column type t default to "n" numeric? Because OpenXLSX does not add the t field for numbers:
+-> no type == generic value (for any application reading)
+
+* Pull request #191: can AmigaOS support ""/file-in-local-folder.xlsx, using "" as local folder?
+-> No, AmigaOS does NOT support an explicit identifier for the local folder

package/thirdparty/OpenXLSX/Notes/styles-missing-support.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<styleSheet>
+	<tableStyles count="0" defaultTableStyle="TableStyleMedium2" defaultPivotStyle="PivotStyleLight16"/>
+	<extLst>
+		<ext xmlns:x14="http://schemas.microsoft.com/office/spreadsheetml/2009/9/main" uri="{EB79DEF2-80B8-43e5-95BD-54CBDDF9020C}">
+			<x14:slicerStyles defaultSlicerStyle="SlicerStyleLight1"/>
+		</ext>
+		<ext xmlns:x15="http://schemas.microsoft.com/office/spreadsheetml/2010/11/main" uri="{9260A510-F301-46a8-8635-F512D64BE5F5}">
+			<x15:timelineStyles defaultTimelineStyle="TimeSlicerStyleLight1"/>
+		</ext>
+	</extLst>
+</styleSheet>

package/thirdparty/OpenXLSX/Notes/todo-list.txt

@@ -0,0 +1,108 @@
+How to find TBDs in the source code:
+====================================
+  $ grep -rni "todo\|tbd\|caution"
+
+Planned features:
+=================
+* comments support: each xl/comments##.xml file refers to the corresponding xl/worksheets/sheets##.xml file with comments structured like so:
+  <x:commentList>
+    <x:comment ref="M5" authorId="0">
+      <x:text>
+        <x:t>Enabling this option will reduce memory usage by 
+saving some intermediate data from memory onto the
+computer's hard disk.</x:t>
+      </x:text>
+    </x:comment>
+  </x:commentList>
+
+  NOTE: each comments file should be listed in [Content_Types].xml:
+  * Types::Override node: <Override PartName="/xl/comments1.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.comments+xml"/>
+* support for worksheet specific relationships (comments, drawings)
+  <?xml version="1.0" encoding="utf-8"?>
+  <Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
+    <Relationship Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments" Target="/xl/comments10.xml" Id="Rd57c507abdc84ad0"/>
+    <Relationship Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/vmlDrawing" Target="/xl/drawings/vmldrawing10.vml" Id="Re5068d6e0dbe4bec"/>
+  </Relationships>
+
+TBD features (low priority):
+============================
+* support for rich-text cell contents (see idea for an implementation of rich-text cell contents at end of file)
+* replace leap year logic per XLDateTime.cpp with c++ built-in date functions
+* related to random 64bit identifiers: check [Content_Types].xml "support" (in that saving the file does not break anything):
+  ---------------------------------------------------------------------------------------------------------------------------
+  * Types::Default node: <Default Extension="xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml"/>
+    (alternative entry to ContentType="application/xml")
+  * Types::Default node: <Default Extension="vml" ContentType="application/vnd.openxmlformats-officedocument.vmlDrawing"/>
+  * Types::Default node: <Default Extension="dat" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.template.main+xml"/>
+
+
+
+Notes on status of random 64bit ID support in hex format for worksheet r:id values
+==================================================================================
+DONE:
+* XLRelationships: void UseRandomIDs() and void UseSequentialIDs() to switch between one and the other IDs implementation
+* [DONE] _rels/.rels <Relationship <!-- other attributes --> Id="R1089e9da7ec94cca"/>
+  --> used for relevant xml targets in the workbook
+* [DONE] xl/workbook##.xml sheets::sheet node: <x:sheet name="Workspace" sheetId="1" r:id="R4b78b06d10804515"/>
+  --> regular sheet Ids
+* xl/_rels/workbook##.xml.rels: <Relationship <!-- other attributes --> Id="Rca50407821924816"/>
+   workbook relationships: xl/sharedStrings.xml, xl/styles.xml, xl/theme/theme##.xml, and all worksheets
+   [DONE] --> regular sheet Ids for worksheets
+   TODO --> for the other xml files, it appears the IDs here are not used elsewhere
+* [NOT TOUCHED BY OpenXLSX] xl/worksheets/_rels/sheet##.xml.rels <Relationship <!-- other attributes --> Id="Rc3c7515c124f4337"/> 
+   each sheet needs a relationship entry for 
+   - Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments"
+     --> it appears the ID here is not used elsewhere
+   - Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/vmlDrawing"
+     --> the target for a vmlDrawing is referenced by this ID in the worksheet (see below)
+* [NOT TOUCHED BY OpenXLSX] xl/worksheets/sheet##.xml worksheet node "<x:legacyDrawing r:id="Rc3c7515c124f4337"/>"
+  --> refers to the ID defined in the worksheet relationships (above) no support needed atm
+
+
+
+Idea for an implementation of rich-text cell contents:
+======================================================
+based on: formatted text is rich-text in XML, so one element node per unique style
+  - user gets to "get style" for a given position in text (character):
+   XLRichText.rows() / .row(index i) -> allows to extract text rows by index, removing the ambiguity of how to count a line break index
+   XLRichText.row( i ) returns XLRichTextRow
+   XLRichTextRow exposes:
+    - std::string functionality for text manipulation, and on top of that:
+	 - .formatAt( size_t index ) which returns an XLStyle object that contains the style applicable to that character
+   XLRichText::insertText( XLRichTextRow row, XLRichText text ) // insert before row with given style
+   XLRichText::insertText( XLRichTextRow row, std::string text, XLStyle style == __next__ )
+   - when a row is inserted, it inherits the format as specified:
+      __previous__: use style of the previous row
+      __next__:     use style of row
+      (custom XLStyle): use custom style (can be default, e.g. XLStyle{})
+   XLRichText::insertText( XLRichTextRow row, int index, XLStyle style == __next__ )
+      __previous__: use style of the previous character
+      __next__:     use style of the next character
+      (custom XLStyle): use custom style (can be default)
+
+   XLRichText::prependText( XLRichTextRow row, std::string text, XLStyle style == __next__ )
+    - equivalent to XLRichText::insertText( XLRichText.row( 0 ), text, style ) // NOTE: style == __previous__ is not allowed here
+   XLRichText::appendText( XLRichTextRow row, std::string text, XLStyle style == __previous__ )
+    - equivalent to XLRichText::insertText( XLRichText.row( XLRichText.rows().count() - 1 ), text, style ) // NOTE: style == __next__ is not allowed here
+
+   XLRichText::format( int fromRow, int fromIndex, int toRow, int toIndex, XLStyle style )
+    - applies the given style to the indicated range -> if it overlaps with other styles, this will split rich text sections as needed, e.g.:
+      * assume simplified XLRichTextPos pos_i( row_i, index_i )
+      * existing style_a from pos_i to pos_j
+      * new style_b applied to pos_k to pos_l with pos_k > pos_i and pos_l < pos_j
+      * resulting style sections:
+        [pos_i;pos_k[ style_a
+        [pos_k;pos_l] style_b
+        ]pos_l;pos_j] style_a
+
+   NOTE: for all inserts, text can have line breaks & will be inserted into the XLRichText accordingly
+   The underlying cell string value is updated accordingly (with the access logic to shared strings)
+
+   For such manipulations, the user has to create an XLRichText by accessing a cell intentionally as rich text, which will load the cell contents into the above structure and allow according manipulations on the underlying XML. For repeated access, it would be recommended to *not* work on temporary objects, but keep the XLRichText alive until operations on the cell are complete.
+
+   A bunch of helper functions could then be added one after another, e.g.:
+   * introduce XLRichTextCharacter with iterator traits (and a parent property that points to the row)
+   * auto-select format ranges based on an XLRichTextRow or XLRichTextCharacters
+     --> XLRichText::format( XLRichTextRow row ), XLRichText::format( XLRichTextRow fromRow, toRow ), XLRichText::format( XLRichTextCharacter fromChar, XLRichTextCharacter toChar )
+
+   TBD: how to decide on duplication / deduplication of XLStyles in the styles table