14 files changed, 2750 insertions, 0 deletions
diff --git a/doc_example/Makefile.am b/doc_example/Makefile.am
new file mode 100644
index 0000000..0f097b2
--- /dev/null
+++ b/doc_example/Makefile.am
@@ -0,0 +1,110 @@
+
+AM_CPPFLAGS = \
+	-I$(top_srcdir)/include \
+	$(LIBIXION_CFLAGS) \
+	-DSRCDIR=\""$(top_srcdir)"\"
+
+bin_PROGRAMS =
+
+EXTRA_PROGRAMS = \
+	json-doc-1 \
+	json-doc-2 \
+	json-parser-1 \
+	xml-mapping-1 \
+	spreadsheet-doc-1 \
+	spreadsheet-doc-1-num-and-formula \
+	spreadsheet-doc-2 \
+	spreadsheet-doc-2-sheets-no-string-pool \
+	spreadsheet-doc-2-sheets-with-string-pool \
+	spreadsheet-doc-2-sheets-with-formula
+
+json_doc_1_SOURCES = \
+	json_doc_1.cpp
+
+json_doc_1_LDADD = \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la
+
+json_doc_2_SOURCES = \
+	json_doc_2.cpp
+
+json_doc_2_LDADD = \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la
+
+json_parser_1_SOURCES = \
+	json_parser_1.cpp
+
+json_parser_1_LDADD = \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la
+
+xml_mapping_1_SOURCES = \
+	xml_mapping_1.cpp
+
+xml_mapping_1_LDADD = \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la
+
+# Spreadsheet document examples.
+
+SPDOC_LDADD = \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la \
+	../src/spreadsheet/liborcus-spreadsheet-model-@ORCUS_API_VERSION@.la \
+	$(LIBIXION_LIBS)
+
+spreadsheet_doc_1_SOURCES = \
+	spreadsheet_doc_1.cpp
+
+spreadsheet_doc_1_LDADD = $(SPDOC_LDADD)
+
+spreadsheet_doc_1_num_and_formula_SOURCES = \
+	spreadsheet_doc_1_num_and_formula.cpp
+
+spreadsheet_doc_1_num_and_formula_LDADD = $(SPDOC_LDADD)
+
+spreadsheet_doc_2_SOURCES = \
+	spreadsheet_doc_2.cpp
+
+spreadsheet_doc_2_LDADD = \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la
+
+spreadsheet_doc_2_sheets_no_string_pool_SOURCES = \
+	spreadsheet_doc_2_sheets_no_string_pool.cpp
+
+spreadsheet_doc_2_sheets_no_string_pool_LDADD = \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la
+
+spreadsheet_doc_2_sheets_with_string_pool_SOURCES = \
+	spreadsheet_doc_2_sheets_with_string_pool.cpp
+
+spreadsheet_doc_2_sheets_with_string_pool_LDADD = \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la
+
+spreadsheet_doc_2_sheets_with_formula_SOURCES = \
+	spreadsheet_doc_2_sheets_with_formula.cpp
+
+spreadsheet_doc_2_sheets_with_formula_LDADD = \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la
+
+AM_TESTS_ENVIRONMENT = \
+	INPUTDIR=$(srcdir)/files; export INPUTDIR;
+
+TESTS = \
+	json-doc-1 \
+	json-doc-2 \
+	json-parser-1 \
+	xml-mapping-1 \
+	spreadsheet-doc-1 \
+	spreadsheet-doc-1-num-and-formula \
+	spreadsheet-doc-2 \
+	spreadsheet-doc-2-sheets-no-string-pool \
+	spreadsheet-doc-2-sheets-with-string-pool \
+	spreadsheet-doc-2-sheets-with-formula
+
+distclean-local:
+	rm -rf $(TESTS)
diff --git a/doc_example/Makefile.in b/doc_example/Makefile.in
new file mode 100644
index 0000000..5eaad38
--- /dev/null
+++ b/doc_example/Makefile.in
@@ -0,0 +1,1409 @@
+# Makefile.in generated by automake 1.16.5 from Makefile.am.
+# @configure_input@
+
+# Copyright (C) 1994-2021 Free Software Foundation, Inc.
+
+# This Makefile.in is free software; the Free Software Foundation
+# gives unlimited permission to copy and/or distribute it,
+# with or without modifications, as long as this notice is preserved.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
+# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+# PARTICULAR PURPOSE.
+
+@SET_MAKE@
+
+VPATH = @srcdir@
+am__is_gnu_make = { \
+  if test -z '$(MAKELEVEL)'; then \
+    false; \
+  elif test -n '$(MAKE_HOST)'; then \
+    true; \
+  elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \
+    true; \
+  else \
+    false; \
+  fi; \
+}
+am__make_running_with_option = \
+  case $${target_option-} in \
+      ?) ;; \
+      *) echo "am__make_running_with_option: internal error: invalid" \
+              "target option '$${target_option-}' specified" >&2; \
+         exit 1;; \
+  esac; \
+  has_opt=no; \
+  sane_makeflags=$$MAKEFLAGS; \
+  if $(am__is_gnu_make); then \
+    sane_makeflags=$$MFLAGS; \
+  else \
+    case $$MAKEFLAGS in \
+      *\\[\ \	]*) \
+        bs=\\; \
+        sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \
+          | sed "s/$$bs$$bs[$$bs $$bs	]*//g"`;; \
+    esac; \
+  fi; \
+  skip_next=no; \
+  strip_trailopt () \
+  { \
+    flg=`printf '%s\n' "$$flg" | sed "s/$$1.*$$//"`; \
+  }; \
+  for flg in $$sane_makeflags; do \
+    test $$skip_next = yes && { skip_next=no; continue; }; \
+    case $$flg in \
+      *=*|--*) continue;; \
+        -*I) strip_trailopt 'I'; skip_next=yes;; \
+      -*I?*) strip_trailopt 'I';; \
+        -*O) strip_trailopt 'O'; skip_next=yes;; \
+      -*O?*) strip_trailopt 'O';; \
+        -*l) strip_trailopt 'l'; skip_next=yes;; \
+      -*l?*) strip_trailopt 'l';; \
+      -[dEDm]) skip_next=yes;; \
+      -[JT]) skip_next=yes;; \
+    esac; \
+    case $$flg in \
+      *$$target_option*) has_opt=yes; break;; \
+    esac; \
+  done; \
+  test $$has_opt = yes
+am__make_dryrun = (target_option=n; $(am__make_running_with_option))
+am__make_keepgoing = (target_option=k; $(am__make_running_with_option))
+pkgdatadir = $(datadir)/@PACKAGE@
+pkgincludedir = $(includedir)/@PACKAGE@
+pkglibdir = $(libdir)/@PACKAGE@
+pkglibexecdir = $(libexecdir)/@PACKAGE@
+am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
+install_sh_DATA = $(install_sh) -c -m 644
+install_sh_PROGRAM = $(install_sh) -c
+install_sh_SCRIPT = $(install_sh) -c
+INSTALL_HEADER = $(INSTALL_DATA)
+transform = $(program_transform_name)
+NORMAL_INSTALL = :
+PRE_INSTALL = :
+POST_INSTALL = :
+NORMAL_UNINSTALL = :
+PRE_UNINSTALL = :
+POST_UNINSTALL = :
+build_triplet = @build@
+host_triplet = @host@
+bin_PROGRAMS =
+EXTRA_PROGRAMS = json-doc-1$(EXEEXT) json-doc-2$(EXEEXT) \
+	json-parser-1$(EXEEXT) xml-mapping-1$(EXEEXT) \
+	spreadsheet-doc-1$(EXEEXT) \
+	spreadsheet-doc-1-num-and-formula$(EXEEXT) \
+	spreadsheet-doc-2$(EXEEXT) \
+	spreadsheet-doc-2-sheets-no-string-pool$(EXEEXT) \
+	spreadsheet-doc-2-sheets-with-string-pool$(EXEEXT) \
+	spreadsheet-doc-2-sheets-with-formula$(EXEEXT)
+TESTS = json-doc-1$(EXEEXT) json-doc-2$(EXEEXT) json-parser-1$(EXEEXT) \
+	xml-mapping-1$(EXEEXT) spreadsheet-doc-1$(EXEEXT) \
+	spreadsheet-doc-1-num-and-formula$(EXEEXT) \
+	spreadsheet-doc-2$(EXEEXT) \
+	spreadsheet-doc-2-sheets-no-string-pool$(EXEEXT) \
+	spreadsheet-doc-2-sheets-with-string-pool$(EXEEXT) \
+	spreadsheet-doc-2-sheets-with-formula$(EXEEXT)
+subdir = doc_example
+ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
+am__aclocal_m4_deps = $(top_srcdir)/m4/ax_cxx_compile_stdcxx.m4 \
+	$(top_srcdir)/m4/ax_cxx_compile_stdcxx_17.m4 \
+	$(top_srcdir)/m4/boost.m4 $(top_srcdir)/m4/libtool.m4 \
+	$(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \
+	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
+	$(top_srcdir)/m4/m4_ax_valgrind_check.m4 \
+	$(top_srcdir)/configure.ac
+am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
+	$(ACLOCAL_M4)
+DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON)
+mkinstalldirs = $(install_sh) -d
+CONFIG_HEADER = $(top_builddir)/config.h
+CONFIG_CLEAN_FILES =
+CONFIG_CLEAN_VPATH_FILES =
+am__installdirs = "$(DESTDIR)$(bindir)"
+PROGRAMS = $(bin_PROGRAMS)
+am_json_doc_1_OBJECTS = json_doc_1.$(OBJEXT)
+json_doc_1_OBJECTS = $(am_json_doc_1_OBJECTS)
+json_doc_1_DEPENDENCIES =  \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la
+AM_V_lt = $(am__v_lt_@AM_V@)
+am__v_lt_ = $(am__v_lt_@AM_DEFAULT_V@)
+am__v_lt_0 = --silent
+am__v_lt_1 = 
+am_json_doc_2_OBJECTS = json_doc_2.$(OBJEXT)
+json_doc_2_OBJECTS = $(am_json_doc_2_OBJECTS)
+json_doc_2_DEPENDENCIES =  \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la
+am_json_parser_1_OBJECTS = json_parser_1.$(OBJEXT)
+json_parser_1_OBJECTS = $(am_json_parser_1_OBJECTS)
+json_parser_1_DEPENDENCIES =  \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la
+am_spreadsheet_doc_1_OBJECTS = spreadsheet_doc_1.$(OBJEXT)
+spreadsheet_doc_1_OBJECTS = $(am_spreadsheet_doc_1_OBJECTS)
+am__DEPENDENCIES_1 =
+am__DEPENDENCIES_2 =  \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la \
+	../src/spreadsheet/liborcus-spreadsheet-model-@ORCUS_API_VERSION@.la \
+	$(am__DEPENDENCIES_1)
+spreadsheet_doc_1_DEPENDENCIES = $(am__DEPENDENCIES_2)
+am_spreadsheet_doc_1_num_and_formula_OBJECTS =  \
+	spreadsheet_doc_1_num_and_formula.$(OBJEXT)
+spreadsheet_doc_1_num_and_formula_OBJECTS =  \
+	$(am_spreadsheet_doc_1_num_and_formula_OBJECTS)
+spreadsheet_doc_1_num_and_formula_DEPENDENCIES =  \
+	$(am__DEPENDENCIES_2)
+am_spreadsheet_doc_2_OBJECTS = spreadsheet_doc_2.$(OBJEXT)
+spreadsheet_doc_2_OBJECTS = $(am_spreadsheet_doc_2_OBJECTS)
+spreadsheet_doc_2_DEPENDENCIES =  \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la
+am_spreadsheet_doc_2_sheets_no_string_pool_OBJECTS =  \
+	spreadsheet_doc_2_sheets_no_string_pool.$(OBJEXT)
+spreadsheet_doc_2_sheets_no_string_pool_OBJECTS =  \
+	$(am_spreadsheet_doc_2_sheets_no_string_pool_OBJECTS)
+spreadsheet_doc_2_sheets_no_string_pool_DEPENDENCIES =  \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la
+am_spreadsheet_doc_2_sheets_with_formula_OBJECTS =  \
+	spreadsheet_doc_2_sheets_with_formula.$(OBJEXT)
+spreadsheet_doc_2_sheets_with_formula_OBJECTS =  \
+	$(am_spreadsheet_doc_2_sheets_with_formula_OBJECTS)
+spreadsheet_doc_2_sheets_with_formula_DEPENDENCIES =  \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la
+am_spreadsheet_doc_2_sheets_with_string_pool_OBJECTS =  \
+	spreadsheet_doc_2_sheets_with_string_pool.$(OBJEXT)
+spreadsheet_doc_2_sheets_with_string_pool_OBJECTS =  \
+	$(am_spreadsheet_doc_2_sheets_with_string_pool_OBJECTS)
+spreadsheet_doc_2_sheets_with_string_pool_DEPENDENCIES =  \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la
+am_xml_mapping_1_OBJECTS = xml_mapping_1.$(OBJEXT)
+xml_mapping_1_OBJECTS = $(am_xml_mapping_1_OBJECTS)
+xml_mapping_1_DEPENDENCIES =  \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la
+AM_V_P = $(am__v_P_@AM_V@)
+am__v_P_ = $(am__v_P_@AM_DEFAULT_V@)
+am__v_P_0 = false
+am__v_P_1 = :
+AM_V_GEN = $(am__v_GEN_@AM_V@)
+am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@)
+am__v_GEN_0 = @echo "  GEN     " $@;
+am__v_GEN_1 = 
+AM_V_at = $(am__v_at_@AM_V@)
+am__v_at_ = $(am__v_at_@AM_DEFAULT_V@)
+am__v_at_0 = @
+am__v_at_1 = 
+DEFAULT_INCLUDES = -I.@am__isrc@ -I$(top_builddir)
+depcomp = $(SHELL) $(top_srcdir)/depcomp
+am__maybe_remake_depfiles = depfiles
+am__depfiles_remade = ./$(DEPDIR)/json_doc_1.Po \
+	./$(DEPDIR)/json_doc_2.Po ./$(DEPDIR)/json_parser_1.Po \
+	./$(DEPDIR)/spreadsheet_doc_1.Po \
+	./$(DEPDIR)/spreadsheet_doc_1_num_and_formula.Po \
+	./$(DEPDIR)/spreadsheet_doc_2.Po \
+	./$(DEPDIR)/spreadsheet_doc_2_sheets_no_string_pool.Po \
+	./$(DEPDIR)/spreadsheet_doc_2_sheets_with_formula.Po \
+	./$(DEPDIR)/spreadsheet_doc_2_sheets_with_string_pool.Po \
+	./$(DEPDIR)/xml_mapping_1.Po
+am__mv = mv -f
+CXXCOMPILE = $(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \
+	$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CXXFLAGS) $(CXXFLAGS)
+LTCXXCOMPILE = $(LIBTOOL) $(AM_V_lt) --tag=CXX $(AM_LIBTOOLFLAGS) \
+	$(LIBTOOLFLAGS) --mode=compile $(CXX) $(DEFS) \
+	$(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) \
+	$(AM_CXXFLAGS) $(CXXFLAGS)
+AM_V_CXX = $(am__v_CXX_@AM_V@)
+am__v_CXX_ = $(am__v_CXX_@AM_DEFAULT_V@)
+am__v_CXX_0 = @echo "  CXX     " $@;
+am__v_CXX_1 = 
+CXXLD = $(CXX)
+CXXLINK = $(LIBTOOL) $(AM_V_lt) --tag=CXX $(AM_LIBTOOLFLAGS) \
+	$(LIBTOOLFLAGS) --mode=link $(CXXLD) $(AM_CXXFLAGS) \
+	$(CXXFLAGS) $(AM_LDFLAGS) $(LDFLAGS) -o $@
+AM_V_CXXLD = $(am__v_CXXLD_@AM_V@)
+am__v_CXXLD_ = $(am__v_CXXLD_@AM_DEFAULT_V@)
+am__v_CXXLD_0 = @echo "  CXXLD   " $@;
+am__v_CXXLD_1 = 
+SOURCES = $(json_doc_1_SOURCES) $(json_doc_2_SOURCES) \
+	$(json_parser_1_SOURCES) $(spreadsheet_doc_1_SOURCES) \
+	$(spreadsheet_doc_1_num_and_formula_SOURCES) \
+	$(spreadsheet_doc_2_SOURCES) \
+	$(spreadsheet_doc_2_sheets_no_string_pool_SOURCES) \
+	$(spreadsheet_doc_2_sheets_with_formula_SOURCES) \
+	$(spreadsheet_doc_2_sheets_with_string_pool_SOURCES) \
+	$(xml_mapping_1_SOURCES)
+DIST_SOURCES = $(json_doc_1_SOURCES) $(json_doc_2_SOURCES) \
+	$(json_parser_1_SOURCES) $(spreadsheet_doc_1_SOURCES) \
+	$(spreadsheet_doc_1_num_and_formula_SOURCES) \
+	$(spreadsheet_doc_2_SOURCES) \
+	$(spreadsheet_doc_2_sheets_no_string_pool_SOURCES) \
+	$(spreadsheet_doc_2_sheets_with_formula_SOURCES) \
+	$(spreadsheet_doc_2_sheets_with_string_pool_SOURCES) \
+	$(xml_mapping_1_SOURCES)
+am__can_run_installinfo = \
+  case $$AM_UPDATE_INFO_DIR in \
+    n|no|NO) false;; \
+    *) (install-info --version) >/dev/null 2>&1;; \
+  esac
+am__extra_recursive_targets = check-valgrind-recursive \
+	check-valgrind-memcheck-recursive \
+	check-valgrind-helgrind-recursive check-valgrind-drd-recursive \
+	check-valgrind-sgcheck-recursive
+am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP)
+# Read a list of newline-separated strings from the standard input,
+# and print each of them once, without duplicates.  Input order is
+# *not* preserved.
+am__uniquify_input = $(AWK) '\
+  BEGIN { nonempty = 0; } \
+  { items[$$0] = 1; nonempty = 1; } \
+  END { if (nonempty) { for (i in items) print i; }; } \
+'
+# Make sure the list of sources is unique.  This is necessary because,
+# e.g., the same source file might be shared among _SOURCES variables
+# for different programs/libraries.
+am__define_uniq_tagged_files = \
+  list='$(am__tagged_files)'; \
+  unique=`for i in $$list; do \
+    if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
+  done | $(am__uniquify_input)`
+am__tty_colors_dummy = \
+  mgn= red= grn= lgn= blu= brg= std=; \
+  am__color_tests=no
+am__tty_colors = { \
+  $(am__tty_colors_dummy); \
+  if test "X$(AM_COLOR_TESTS)" = Xno; then \
+    am__color_tests=no; \
+  elif test "X$(AM_COLOR_TESTS)" = Xalways; then \
+    am__color_tests=yes; \
+  elif test "X$$TERM" != Xdumb && { test -t 1; } 2>/dev/null; then \
+    am__color_tests=yes; \
+  fi; \
+  if test $$am__color_tests = yes; then \
+    red='[0;31m'; \
+    grn='[0;32m'; \
+    lgn='[1;32m'; \
+    blu='[1;34m'; \
+    mgn='[0;35m'; \
+    brg='[1m'; \
+    std='[m'; \
+  fi; \
+}
+am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`;
+am__vpath_adj = case $$p in \
+    $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \
+    *) f=$$p;; \
+  esac;
+am__strip_dir = f=`echo $$p | sed -e 's|^.*/||'`;
+am__install_max = 40
+am__nobase_strip_setup = \
+  srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'`
+am__nobase_strip = \
+  for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||"
+am__nobase_list = $(am__nobase_strip_setup); \
+  for p in $$list; do echo "$$p $$p"; done | \
+  sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \
+  $(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \
+    if (++n[$$2] == $(am__install_max)) \
+      { print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \
+    END { for (dir in files) print dir, files[dir] }'
+am__base_list = \
+  sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \
+  sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g'
+am__uninstall_files_from_dir = { \
+  test -z "$$files" \
+    || { test ! -d "$$dir" && test ! -f "$$dir" && test ! -r "$$dir"; } \
+    || { echo " ( cd '$$dir' && rm -f" $$files ")"; \
+         $(am__cd) "$$dir" && rm -f $$files; }; \
+  }
+am__recheck_rx = ^[ 	]*:recheck:[ 	]*
+am__global_test_result_rx = ^[ 	]*:global-test-result:[ 	]*
+am__copy_in_global_log_rx = ^[ 	]*:copy-in-global-log:[ 	]*
+# A command that, given a newline-separated list of test names on the
+# standard input, print the name of the tests that are to be re-run
+# upon "make recheck".
+am__list_recheck_tests = $(AWK) '{ \
+  recheck = 1; \
+  while ((rc = (getline line < ($$0 ".trs"))) != 0) \
+    { \
+      if (rc < 0) \
+        { \
+          if ((getline line2 < ($$0 ".log")) < 0) \
+	    recheck = 0; \
+          break; \
+        } \
+      else if (line ~ /$(am__recheck_rx)[nN][Oo]/) \
+        { \
+          recheck = 0; \
+          break; \
+        } \
+      else if (line ~ /$(am__recheck_rx)[yY][eE][sS]/) \
+        { \
+          break; \
+        } \
+    }; \
+  if (recheck) \
+    print $$0; \
+  close ($$0 ".trs"); \
+  close ($$0 ".log"); \
+}'
+# A command that, given a newline-separated list of test names on the
+# standard input, create the global log from their .trs and .log files.
+am__create_global_log = $(AWK) ' \
+function fatal(msg) \
+{ \
+  print "fatal: making $@: " msg | "cat >&2"; \
+  exit 1; \
+} \
+function rst_section(header) \
+{ \
+  print header; \
+  len = length(header); \
+  for (i = 1; i <= len; i = i + 1) \
+    printf "="; \
+  printf "\n\n"; \
+} \
+{ \
+  copy_in_global_log = 1; \
+  global_test_result = "RUN"; \
+  while ((rc = (getline line < ($$0 ".trs"))) != 0) \
+    { \
+      if (rc < 0) \
+         fatal("failed to read from " $$0 ".trs"); \
+      if (line ~ /$(am__global_test_result_rx)/) \
+        { \
+          sub("$(am__global_test_result_rx)", "", line); \
+          sub("[ 	]*$$", "", line); \
+          global_test_result = line; \
+        } \
+      else if (line ~ /$(am__copy_in_global_log_rx)[nN][oO]/) \
+        copy_in_global_log = 0; \
+    }; \
+  if (copy_in_global_log) \
+    { \
+      rst_section(global_test_result ": " $$0); \
+      while ((rc = (getline line < ($$0 ".log"))) != 0) \
+      { \
+        if (rc < 0) \
+          fatal("failed to read from " $$0 ".log"); \
+        print line; \
+      }; \
+      printf "\n"; \
+    }; \
+  close ($$0 ".trs"); \
+  close ($$0 ".log"); \
+}'
+# Restructured Text title.
+am__rst_title = { sed 's/.*/   &   /;h;s/./=/g;p;x;s/ *$$//;p;g' && echo; }
+# Solaris 10 'make', and several other traditional 'make' implementations,
+# pass "-e" to $(SHELL), and POSIX 2008 even requires this.  Work around it
+# by disabling -e (using the XSI extension "set +e") if it's set.
+am__sh_e_setup = case $$- in *e*) set +e;; esac
+# Default flags passed to test drivers.
+am__common_driver_flags = \
+  --color-tests "$$am__color_tests" \
+  --enable-hard-errors "$$am__enable_hard_errors" \
+  --expect-failure "$$am__expect_failure"
+# To be inserted before the command running the test.  Creates the
+# directory for the log if needed.  Stores in $dir the directory
+# containing $f, in $tst the test, in $log the log.  Executes the
+# developer- defined test setup AM_TESTS_ENVIRONMENT (if any), and
+# passes TESTS_ENVIRONMENT.  Set up options for the wrapper that
+# will run the test scripts (or their associated LOG_COMPILER, if
+# thy have one).
+am__check_pre = \
+$(am__sh_e_setup);					\
+$(am__vpath_adj_setup) $(am__vpath_adj)			\
+$(am__tty_colors);					\
+srcdir=$(srcdir); export srcdir;			\
+case "$@" in						\
+  */*) am__odir=`echo "./$@" | sed 's|/[^/]*$$||'`;;	\
+    *) am__odir=.;; 					\
+esac;							\
+test "x$$am__odir" = x"." || test -d "$$am__odir" 	\
+  || $(MKDIR_P) "$$am__odir" || exit $$?;		\
+if test -f "./$$f"; then dir=./;			\
+elif test -f "$$f"; then dir=;				\
+else dir="$(srcdir)/"; fi;				\
+tst=$$dir$$f; log='$@'; 				\
+if test -n '$(DISABLE_HARD_ERRORS)'; then		\
+  am__enable_hard_errors=no; 				\
+else							\
+  am__enable_hard_errors=yes; 				\
+fi; 							\
+case " $(XFAIL_TESTS) " in				\
+  *[\ \	]$$f[\ \	]* | *[\ \	]$$dir$$f[\ \	]*) \
+    am__expect_failure=yes;;				\
+  *)							\
+    am__expect_failure=no;;				\
+esac; 							\
+$(AM_TESTS_ENVIRONMENT) $(TESTS_ENVIRONMENT)
+# A shell command to get the names of the tests scripts with any registered
+# extension removed (i.e., equivalently, the names of the test logs, with
+# the '.log' extension removed).  The result is saved in the shell variable
+# '$bases'.  This honors runtime overriding of TESTS and TEST_LOGS.  Sadly,
+# we cannot use something simpler, involving e.g., "$(TEST_LOGS:.log=)",
+# since that might cause problem with VPATH rewrites for suffix-less tests.
+# See also 'test-harness-vpath-rewrite.sh' and 'test-trs-basic.sh'.
+am__set_TESTS_bases = \
+  bases='$(TEST_LOGS)'; \
+  bases=`for i in $$bases; do echo $$i; done | sed 's/\.log$$//'`; \
+  bases=`echo $$bases`
+AM_TESTSUITE_SUMMARY_HEADER = ' for $(PACKAGE_STRING)'
+RECHECK_LOGS = $(TEST_LOGS)
+AM_RECURSIVE_TARGETS = check recheck
+TEST_SUITE_LOG = test-suite.log
+TEST_EXTENSIONS = @EXEEXT@ .test
+LOG_DRIVER = $(SHELL) $(top_srcdir)/test-driver
+LOG_COMPILE = $(LOG_COMPILER) $(AM_LOG_FLAGS) $(LOG_FLAGS)
+am__set_b = \
+  case '$@' in \
+    */*) \
+      case '$*' in \
+        */*) b='$*';; \
+          *) b=`echo '$@' | sed 's/\.log$$//'`; \
+       esac;; \
+    *) \
+      b='$*';; \
+  esac
+am__test_logs1 = $(TESTS:=.log)
+am__test_logs2 = $(am__test_logs1:@EXEEXT@.log=.log)
+TEST_LOGS = $(am__test_logs2:.test.log=.log)
+TEST_LOG_DRIVER = $(SHELL) $(top_srcdir)/test-driver
+TEST_LOG_COMPILE = $(TEST_LOG_COMPILER) $(AM_TEST_LOG_FLAGS) \
+	$(TEST_LOG_FLAGS)
+am__DIST_COMMON = $(srcdir)/Makefile.in $(top_srcdir)/depcomp \
+	$(top_srcdir)/test-driver
+DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
+ACLOCAL = @ACLOCAL@
+AMTAR = @AMTAR@
+AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@
+AR = @AR@
+AS = @AS@
+AUTOCONF = @AUTOCONF@
+AUTOHEADER = @AUTOHEADER@
+AUTOMAKE = @AUTOMAKE@
+AWK = @AWK@
+BOOST_CPPFLAGS = @BOOST_CPPFLAGS@
+BOOST_DATE_TIME_LDFLAGS = @BOOST_DATE_TIME_LDFLAGS@
+BOOST_DATE_TIME_LDPATH = @BOOST_DATE_TIME_LDPATH@
+BOOST_DATE_TIME_LIBS = @BOOST_DATE_TIME_LIBS@
+BOOST_FILESYSTEM_LDFLAGS = @BOOST_FILESYSTEM_LDFLAGS@
+BOOST_FILESYSTEM_LDPATH = @BOOST_FILESYSTEM_LDPATH@
+BOOST_FILESYSTEM_LIBS = @BOOST_FILESYSTEM_LIBS@
+BOOST_IOSTREAMS_LDFLAGS = @BOOST_IOSTREAMS_LDFLAGS@
+BOOST_IOSTREAMS_LDPATH = @BOOST_IOSTREAMS_LDPATH@
+BOOST_IOSTREAMS_LIBS = @BOOST_IOSTREAMS_LIBS@
+BOOST_LDPATH = @BOOST_LDPATH@
+BOOST_PROGRAM_OPTIONS_LDFLAGS = @BOOST_PROGRAM_OPTIONS_LDFLAGS@
+BOOST_PROGRAM_OPTIONS_LDPATH = @BOOST_PROGRAM_OPTIONS_LDPATH@
+BOOST_PROGRAM_OPTIONS_LIBS = @BOOST_PROGRAM_OPTIONS_LIBS@
+BOOST_ROOT = @BOOST_ROOT@
+BOOST_SYSTEM_LDFLAGS = @BOOST_SYSTEM_LDFLAGS@
+BOOST_SYSTEM_LDPATH = @BOOST_SYSTEM_LDPATH@
+BOOST_SYSTEM_LIBS = @BOOST_SYSTEM_LIBS@
+CC = @CC@
+CCDEPMODE = @CCDEPMODE@
+CFLAGS = @CFLAGS@
+CPP = @CPP@
+CPPFLAGS = @CPPFLAGS@
+CSCOPE = @CSCOPE@
+CTAGS = @CTAGS@
+CXX = @CXX@
+CXXCPP = @CXXCPP@
+CXXDEPMODE = @CXXDEPMODE@
+CXXFLAGS = @CXXFLAGS@
+CYGPATH_W = @CYGPATH_W@
+DEFS = @DEFS@
+DEPDIR = @DEPDIR@
+DISTCHECK_CONFIGURE_FLAGS = @DISTCHECK_CONFIGURE_FLAGS@
+DLLTOOL = @DLLTOOL@
+DSYMUTIL = @DSYMUTIL@
+DUMPBIN = @DUMPBIN@
+ECHO_C = @ECHO_C@
+ECHO_N = @ECHO_N@
+ECHO_T = @ECHO_T@
+EGREP = @EGREP@
+ENABLE_VALGRIND_drd = @ENABLE_VALGRIND_drd@
+ENABLE_VALGRIND_helgrind = @ENABLE_VALGRIND_helgrind@
+ENABLE_VALGRIND_memcheck = @ENABLE_VALGRIND_memcheck@
+ENABLE_VALGRIND_sgcheck = @ENABLE_VALGRIND_sgcheck@
+ETAGS = @ETAGS@
+EXEEXT = @EXEEXT@
+FGREP = @FGREP@
+GREP = @GREP@
+HAVE_CXX17 = @HAVE_CXX17@
+INSTALL = @INSTALL@
+INSTALL_DATA = @INSTALL_DATA@
+INSTALL_PROGRAM = @INSTALL_PROGRAM@
+INSTALL_SCRIPT = @INSTALL_SCRIPT@
+INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
+IXION_REQUIRED_API_VERSION = @IXION_REQUIRED_API_VERSION@
+LD = @LD@
+LDFLAGS = @LDFLAGS@
+LIBIXION_CFLAGS = @LIBIXION_CFLAGS@
+LIBIXION_LIBS = @LIBIXION_LIBS@
+LIBOBJS = @LIBOBJS@
+LIBS = @LIBS@
+LIBTOOL = @LIBTOOL@
+LIPO = @LIPO@
+LN_S = @LN_S@
+LTLIBOBJS = @LTLIBOBJS@
+LT_SYS_LIBRARY_PATH = @LT_SYS_LIBRARY_PATH@
+MAKEINFO = @MAKEINFO@
+MANIFEST_TOOL = @MANIFEST_TOOL@
+MDDS_CFLAGS = @MDDS_CFLAGS@
+MDDS_LIBS = @MDDS_LIBS@
+MKDIR_P = @MKDIR_P@
+NM = @NM@
+NMEDIT = @NMEDIT@
+OBJDUMP = @OBJDUMP@
+OBJEXT = @OBJEXT@
+ORCUS_API_VERSION = @ORCUS_API_VERSION@
+ORCUS_MAJOR_VERSION = @ORCUS_MAJOR_VERSION@
+ORCUS_MICRO_VERSION = @ORCUS_MICRO_VERSION@
+ORCUS_MINOR_VERSION = @ORCUS_MINOR_VERSION@
+OTOOL = @OTOOL@
+OTOOL64 = @OTOOL64@
+PACKAGE = @PACKAGE@
+PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
+PACKAGE_NAME = @PACKAGE_NAME@
+PACKAGE_STRING = @PACKAGE_STRING@
+PACKAGE_TARNAME = @PACKAGE_TARNAME@
+PACKAGE_URL = @PACKAGE_URL@
+PACKAGE_VERSION = @PACKAGE_VERSION@
+PARQUET_CFLAGS = @PARQUET_CFLAGS@
+PARQUET_LIBS = @PARQUET_LIBS@
+PATH_SEPARATOR = @PATH_SEPARATOR@
+PKG_CONFIG = @PKG_CONFIG@
+PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@
+PKG_CONFIG_PATH = @PKG_CONFIG_PATH@
+POW_LIB = @POW_LIB@
+PYTHON = @PYTHON@
+PYTHON_CFLAGS = @PYTHON_CFLAGS@
+PYTHON_EXEC_PREFIX = @PYTHON_EXEC_PREFIX@
+PYTHON_LIBS = @PYTHON_LIBS@
+PYTHON_PLATFORM = @PYTHON_PLATFORM@
+PYTHON_PREFIX = @PYTHON_PREFIX@
+PYTHON_VERSION = @PYTHON_VERSION@
+RANLIB = @RANLIB@
+SED = @SED@
+SET_MAKE = @SET_MAKE@
+SHELL = @SHELL@
+STRIP = @STRIP@
+VALGRIND = @VALGRIND@
+VALGRIND_ENABLED = @VALGRIND_ENABLED@
+VERSION = @VERSION@
+ZLIB_CFLAGS = @ZLIB_CFLAGS@
+ZLIB_LIBS = @ZLIB_LIBS@
+abs_builddir = @abs_builddir@
+abs_srcdir = @abs_srcdir@
+abs_top_builddir = @abs_top_builddir@
+abs_top_srcdir = @abs_top_srcdir@
+ac_ct_AR = @ac_ct_AR@
+ac_ct_CC = @ac_ct_CC@
+ac_ct_CXX = @ac_ct_CXX@
+ac_ct_DUMPBIN = @ac_ct_DUMPBIN@
+am__include = @am__include@
+am__leading_dot = @am__leading_dot@
+am__quote = @am__quote@
+am__tar = @am__tar@
+am__untar = @am__untar@
+bindir = @bindir@
+build = @build@
+build_alias = @build_alias@
+build_cpu = @build_cpu@
+build_os = @build_os@
+build_vendor = @build_vendor@
+builddir = @builddir@
+datadir = @datadir@
+datarootdir = @datarootdir@
+docdir = @docdir@
+dvidir = @dvidir@
+exec_prefix = @exec_prefix@
+host = @host@
+host_alias = @host_alias@
+host_cpu = @host_cpu@
+host_os = @host_os@
+host_vendor = @host_vendor@
+htmldir = @htmldir@
+includedir = @includedir@
+infodir = @infodir@
+install_sh = @install_sh@
+libdir = @libdir@
+libexecdir = @libexecdir@
+localedir = @localedir@
+localstatedir = @localstatedir@
+mandir = @mandir@
+mkdir_p = @mkdir_p@
+oldincludedir = @oldincludedir@
+pdfdir = @pdfdir@
+pkgpyexecdir = @pkgpyexecdir@
+pkgpythondir = @pkgpythondir@
+prefix = @prefix@
+program_transform_name = @program_transform_name@
+psdir = @psdir@
+pyexecdir = @pyexecdir@
+pythondir = @pythondir@
+runstatedir = @runstatedir@
+sbindir = @sbindir@
+sharedstatedir = @sharedstatedir@
+srcdir = @srcdir@
+sysconfdir = @sysconfdir@
+target_alias = @target_alias@
+top_build_prefix = @top_build_prefix@
+top_builddir = @top_builddir@
+top_srcdir = @top_srcdir@
+valgrind_enabled_tools = @valgrind_enabled_tools@
+valgrind_tools = @valgrind_tools@
+AM_CPPFLAGS = \
+	-I$(top_srcdir)/include \
+	$(LIBIXION_CFLAGS) \
+	-DSRCDIR=\""$(top_srcdir)"\"
+
+json_doc_1_SOURCES = \
+	json_doc_1.cpp
+
+json_doc_1_LDADD = \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la
+
+json_doc_2_SOURCES = \
+	json_doc_2.cpp
+
+json_doc_2_LDADD = \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la
+
+json_parser_1_SOURCES = \
+	json_parser_1.cpp
+
+json_parser_1_LDADD = \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la
+
+xml_mapping_1_SOURCES = \
+	xml_mapping_1.cpp
+
+xml_mapping_1_LDADD = \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la
+
+
+# Spreadsheet document examples.
+SPDOC_LDADD = \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la \
+	../src/spreadsheet/liborcus-spreadsheet-model-@ORCUS_API_VERSION@.la \
+	$(LIBIXION_LIBS)
+
+spreadsheet_doc_1_SOURCES = \
+	spreadsheet_doc_1.cpp
+
+spreadsheet_doc_1_LDADD = $(SPDOC_LDADD)
+spreadsheet_doc_1_num_and_formula_SOURCES = \
+	spreadsheet_doc_1_num_and_formula.cpp
+
+spreadsheet_doc_1_num_and_formula_LDADD = $(SPDOC_LDADD)
+spreadsheet_doc_2_SOURCES = \
+	spreadsheet_doc_2.cpp
+
+spreadsheet_doc_2_LDADD = \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la
+
+spreadsheet_doc_2_sheets_no_string_pool_SOURCES = \
+	spreadsheet_doc_2_sheets_no_string_pool.cpp
+
+spreadsheet_doc_2_sheets_no_string_pool_LDADD = \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la
+
+spreadsheet_doc_2_sheets_with_string_pool_SOURCES = \
+	spreadsheet_doc_2_sheets_with_string_pool.cpp
+
+spreadsheet_doc_2_sheets_with_string_pool_LDADD = \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la
+
+spreadsheet_doc_2_sheets_with_formula_SOURCES = \
+	spreadsheet_doc_2_sheets_with_formula.cpp
+
+spreadsheet_doc_2_sheets_with_formula_LDADD = \
+	../src/parser/liborcus-parser-@ORCUS_API_VERSION@.la \
+	../src/liborcus/liborcus-@ORCUS_API_VERSION@.la
+
+AM_TESTS_ENVIRONMENT = \
+	INPUTDIR=$(srcdir)/files; export INPUTDIR;
+
+all: all-am
+
+.SUFFIXES:
+.SUFFIXES: .cpp .lo .log .o .obj .test .test$(EXEEXT) .trs
+$(srcdir)/Makefile.in:  $(srcdir)/Makefile.am  $(am__configure_deps)
+	@for dep in $?; do \
+	  case '$(am__configure_deps)' in \
+	    *$$dep*) \
+	      ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \
+	        && { if test -f $@; then exit 0; else break; fi; }; \
+	      exit 1;; \
+	  esac; \
+	done; \
+	echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign doc_example/Makefile'; \
+	$(am__cd) $(top_srcdir) && \
+	  $(AUTOMAKE) --foreign doc_example/Makefile
+Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
+	@case '$?' in \
+	  *config.status*) \
+	    cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \
+	  *) \
+	    echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__maybe_remake_depfiles)'; \
+	    cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__maybe_remake_depfiles);; \
+	esac;
+
+$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES)
+	cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
+
+$(top_srcdir)/configure:  $(am__configure_deps)
+	cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
+$(ACLOCAL_M4):  $(am__aclocal_m4_deps)
+	cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
+$(am__aclocal_m4_deps):
+install-binPROGRAMS: $(bin_PROGRAMS)
+	@$(NORMAL_INSTALL)
+	@list='$(bin_PROGRAMS)'; test -n "$(bindir)" || list=; \
+	if test -n "$$list"; then \
+	  echo " $(MKDIR_P) '$(DESTDIR)$(bindir)'"; \
+	  $(MKDIR_P) "$(DESTDIR)$(bindir)" || exit 1; \
+	fi; \
+	for p in $$list; do echo "$$p $$p"; done | \
+	sed 's/$(EXEEXT)$$//' | \
+	while read p p1; do if test -f $$p \
+	 || test -f $$p1 \
+	  ; then echo "$$p"; echo "$$p"; else :; fi; \
+	done | \
+	sed -e 'p;s,.*/,,;n;h' \
+	    -e 's|.*|.|' \
+	    -e 'p;x;s,.*/,,;s/$(EXEEXT)$$//;$(transform);s/$$/$(EXEEXT)/' | \
+	sed 'N;N;N;s,\n, ,g' | \
+	$(AWK) 'BEGIN { files["."] = ""; dirs["."] = 1 } \
+	  { d=$$3; if (dirs[d] != 1) { print "d", d; dirs[d] = 1 } \
+	    if ($$2 == $$4) files[d] = files[d] " " $$1; \
+	    else { print "f", $$3 "/" $$4, $$1; } } \
+	  END { for (d in files) print "f", d, files[d] }' | \
+	while read type dir files; do \
+	    if test "$$dir" = .; then dir=; else dir=/$$dir; fi; \
+	    test -z "$$files" || { \
+	    echo " $(INSTALL_PROGRAM_ENV) $(LIBTOOL) $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) --mode=install $(INSTALL_PROGRAM) $$files '$(DESTDIR)$(bindir)$$dir'"; \
+	    $(INSTALL_PROGRAM_ENV) $(LIBTOOL) $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) --mode=install $(INSTALL_PROGRAM) $$files "$(DESTDIR)$(bindir)$$dir" || exit $$?; \
+	    } \
+	; done
+
+uninstall-binPROGRAMS:
+	@$(NORMAL_UNINSTALL)
+	@list='$(bin_PROGRAMS)'; test -n "$(bindir)" || list=; \
+	files=`for p in $$list; do echo "$$p"; done | \
+	  sed -e 'h;s,^.*/,,;s/$(EXEEXT)$$//;$(transform)' \
+	      -e 's/$$/$(EXEEXT)/' \
+	`; \
+	test -n "$$list" || exit 0; \
+	echo " ( cd '$(DESTDIR)$(bindir)' && rm -f" $$files ")"; \
+	cd "$(DESTDIR)$(bindir)" && rm -f $$files
+
+clean-binPROGRAMS:
+	@list='$(bin_PROGRAMS)'; test -n "$$list" || exit 0; \
+	echo " rm -f" $$list; \
+	rm -f $$list || exit $$?; \
+	test -n "$(EXEEXT)" || exit 0; \
+	list=`for p in $$list; do echo "$$p"; done | sed 's/$(EXEEXT)$$//'`; \
+	echo " rm -f" $$list; \
+	rm -f $$list
+
+json-doc-1$(EXEEXT): $(json_doc_1_OBJECTS) $(json_doc_1_DEPENDENCIES) $(EXTRA_json_doc_1_DEPENDENCIES) 
+	@rm -f json-doc-1$(EXEEXT)
+	$(AM_V_CXXLD)$(CXXLINK) $(json_doc_1_OBJECTS) $(json_doc_1_LDADD) $(LIBS)
+
+json-doc-2$(EXEEXT): $(json_doc_2_OBJECTS) $(json_doc_2_DEPENDENCIES) $(EXTRA_json_doc_2_DEPENDENCIES) 
+	@rm -f json-doc-2$(EXEEXT)
+	$(AM_V_CXXLD)$(CXXLINK) $(json_doc_2_OBJECTS) $(json_doc_2_LDADD) $(LIBS)
+
+json-parser-1$(EXEEXT): $(json_parser_1_OBJECTS) $(json_parser_1_DEPENDENCIES) $(EXTRA_json_parser_1_DEPENDENCIES) 
+	@rm -f json-parser-1$(EXEEXT)
+	$(AM_V_CXXLD)$(CXXLINK) $(json_parser_1_OBJECTS) $(json_parser_1_LDADD) $(LIBS)
+
+spreadsheet-doc-1$(EXEEXT): $(spreadsheet_doc_1_OBJECTS) $(spreadsheet_doc_1_DEPENDENCIES) $(EXTRA_spreadsheet_doc_1_DEPENDENCIES) 
+	@rm -f spreadsheet-doc-1$(EXEEXT)
+	$(AM_V_CXXLD)$(CXXLINK) $(spreadsheet_doc_1_OBJECTS) $(spreadsheet_doc_1_LDADD) $(LIBS)
+
+spreadsheet-doc-1-num-and-formula$(EXEEXT): $(spreadsheet_doc_1_num_and_formula_OBJECTS) $(spreadsheet_doc_1_num_and_formula_DEPENDENCIES) $(EXTRA_spreadsheet_doc_1_num_and_formula_DEPENDENCIES) 
+	@rm -f spreadsheet-doc-1-num-and-formula$(EXEEXT)
+	$(AM_V_CXXLD)$(CXXLINK) $(spreadsheet_doc_1_num_and_formula_OBJECTS) $(spreadsheet_doc_1_num_and_formula_LDADD) $(LIBS)
+
+spreadsheet-doc-2$(EXEEXT): $(spreadsheet_doc_2_OBJECTS) $(spreadsheet_doc_2_DEPENDENCIES) $(EXTRA_spreadsheet_doc_2_DEPENDENCIES) 
+	@rm -f spreadsheet-doc-2$(EXEEXT)
+	$(AM_V_CXXLD)$(CXXLINK) $(spreadsheet_doc_2_OBJECTS) $(spreadsheet_doc_2_LDADD) $(LIBS)
+
+spreadsheet-doc-2-sheets-no-string-pool$(EXEEXT): $(spreadsheet_doc_2_sheets_no_string_pool_OBJECTS) $(spreadsheet_doc_2_sheets_no_string_pool_DEPENDENCIES) $(EXTRA_spreadsheet_doc_2_sheets_no_string_pool_DEPENDENCIES) 
+	@rm -f spreadsheet-doc-2-sheets-no-string-pool$(EXEEXT)
+	$(AM_V_CXXLD)$(CXXLINK) $(spreadsheet_doc_2_sheets_no_string_pool_OBJECTS) $(spreadsheet_doc_2_sheets_no_string_pool_LDADD) $(LIBS)
+
+spreadsheet-doc-2-sheets-with-formula$(EXEEXT): $(spreadsheet_doc_2_sheets_with_formula_OBJECTS) $(spreadsheet_doc_2_sheets_with_formula_DEPENDENCIES) $(EXTRA_spreadsheet_doc_2_sheets_with_formula_DEPENDENCIES) 
+	@rm -f spreadsheet-doc-2-sheets-with-formula$(EXEEXT)
+	$(AM_V_CXXLD)$(CXXLINK) $(spreadsheet_doc_2_sheets_with_formula_OBJECTS) $(spreadsheet_doc_2_sheets_with_formula_LDADD) $(LIBS)
+
+spreadsheet-doc-2-sheets-with-string-pool$(EXEEXT): $(spreadsheet_doc_2_sheets_with_string_pool_OBJECTS) $(spreadsheet_doc_2_sheets_with_string_pool_DEPENDENCIES) $(EXTRA_spreadsheet_doc_2_sheets_with_string_pool_DEPENDENCIES) 
+	@rm -f spreadsheet-doc-2-sheets-with-string-pool$(EXEEXT)
+	$(AM_V_CXXLD)$(CXXLINK) $(spreadsheet_doc_2_sheets_with_string_pool_OBJECTS) $(spreadsheet_doc_2_sheets_with_string_pool_LDADD) $(LIBS)
+
+xml-mapping-1$(EXEEXT): $(xml_mapping_1_OBJECTS) $(xml_mapping_1_DEPENDENCIES) $(EXTRA_xml_mapping_1_DEPENDENCIES) 
+	@rm -f xml-mapping-1$(EXEEXT)
+	$(AM_V_CXXLD)$(CXXLINK) $(xml_mapping_1_OBJECTS) $(xml_mapping_1_LDADD) $(LIBS)
+
+mostlyclean-compile:
+	-rm -f *.$(OBJEXT)
+
+distclean-compile:
+	-rm -f *.tab.c
+
+@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/json_doc_1.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/json_doc_2.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/json_parser_1.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/spreadsheet_doc_1.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/spreadsheet_doc_1_num_and_formula.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/spreadsheet_doc_2.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/spreadsheet_doc_2_sheets_no_string_pool.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/spreadsheet_doc_2_sheets_with_formula.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/spreadsheet_doc_2_sheets_with_string_pool.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/xml_mapping_1.Po@am__quote@ # am--include-marker
+
+$(am__depfiles_remade):
+	@$(MKDIR_P) $(@D)
+	@echo '# dummy' >$@-t && $(am__mv) $@-t $@
+
+am--depfiles: $(am__depfiles_remade)
+
+.cpp.o:
+@am__fastdepCXX_TRUE@	$(AM_V_CXX)$(CXXCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $<
+@am__fastdepCXX_TRUE@	$(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po
+@AMDEP_TRUE@@am__fastdepCXX_FALSE@	$(AM_V_CXX)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCXX_FALSE@	DEPDIR=$(DEPDIR) $(CXXDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCXX_FALSE@	$(AM_V_CXX@am__nodep@)$(CXXCOMPILE) -c -o $@ $<
+
+.cpp.obj:
+@am__fastdepCXX_TRUE@	$(AM_V_CXX)$(CXXCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ `$(CYGPATH_W) '$<'`
+@am__fastdepCXX_TRUE@	$(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Po
+@AMDEP_TRUE@@am__fastdepCXX_FALSE@	$(AM_V_CXX)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCXX_FALSE@	DEPDIR=$(DEPDIR) $(CXXDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCXX_FALSE@	$(AM_V_CXX@am__nodep@)$(CXXCOMPILE) -c -o $@ `$(CYGPATH_W) '$<'`
+
+.cpp.lo:
+@am__fastdepCXX_TRUE@	$(AM_V_CXX)$(LTCXXCOMPILE) -MT $@ -MD -MP -MF $(DEPDIR)/$*.Tpo -c -o $@ $<
+@am__fastdepCXX_TRUE@	$(AM_V_at)$(am__mv) $(DEPDIR)/$*.Tpo $(DEPDIR)/$*.Plo
+@AMDEP_TRUE@@am__fastdepCXX_FALSE@	$(AM_V_CXX)source='$<' object='$@' libtool=yes @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCXX_FALSE@	DEPDIR=$(DEPDIR) $(CXXDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCXX_FALSE@	$(AM_V_CXX@am__nodep@)$(LTCXXCOMPILE) -c -o $@ $<
+
+mostlyclean-libtool:
+	-rm -f *.lo
+
+clean-libtool:
+	-rm -rf .libs _libs
+check-valgrind-local: 
+check-valgrind-memcheck-local: 
+check-valgrind-helgrind-local: 
+check-valgrind-drd-local: 
+check-valgrind-sgcheck-local: 
+
+ID: $(am__tagged_files)
+	$(am__define_uniq_tagged_files); mkid -fID $$unique
+tags: tags-am
+TAGS: tags
+
+tags-am: $(TAGS_DEPENDENCIES) $(am__tagged_files)
+	set x; \
+	here=`pwd`; \
+	$(am__define_uniq_tagged_files); \
+	shift; \
+	if test -z "$(ETAGS_ARGS)$$*$$unique"; then :; else \
+	  test -n "$$unique" || unique=$$empty_fix; \
+	  if test $$# -gt 0; then \
+	    $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \
+	      "$$@" $$unique; \
+	  else \
+	    $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \
+	      $$unique; \
+	  fi; \
+	fi
+ctags: ctags-am
+
+CTAGS: ctags
+ctags-am: $(TAGS_DEPENDENCIES) $(am__tagged_files)
+	$(am__define_uniq_tagged_files); \
+	test -z "$(CTAGS_ARGS)$$unique" \
+	  || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \
+	     $$unique
+
+GTAGS:
+	here=`$(am__cd) $(top_builddir) && pwd` \
+	  && $(am__cd) $(top_srcdir) \
+	  && gtags -i $(GTAGS_ARGS) "$$here"
+cscopelist: cscopelist-am
+
+cscopelist-am: $(am__tagged_files)
+	list='$(am__tagged_files)'; \
+	case "$(srcdir)" in \
+	  [\\/]* | ?:[\\/]*) sdir="$(srcdir)" ;; \
+	  *) sdir=$(subdir)/$(srcdir) ;; \
+	esac; \
+	for i in $$list; do \
+	  if test -f "$$i"; then \
+	    echo "$(subdir)/$$i"; \
+	  else \
+	    echo "$$sdir/$$i"; \
+	  fi; \
+	done >> $(top_builddir)/cscope.files
+
+distclean-tags:
+	-rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags
+
+# Recover from deleted '.trs' file; this should ensure that
+# "rm -f foo.log; make foo.trs" re-run 'foo.test', and re-create
+# both 'foo.log' and 'foo.trs'.  Break the recipe in two subshells
+# to avoid problems with "make -n".
+.log.trs:
+	rm -f $< $@
+	$(MAKE) $(AM_MAKEFLAGS) $<
+
+# Leading 'am--fnord' is there to ensure the list of targets does not
+# expand to empty, as could happen e.g. with make check TESTS=''.
+am--fnord $(TEST_LOGS) $(TEST_LOGS:.log=.trs): $(am__force_recheck)
+am--force-recheck:
+	@:
+
+$(TEST_SUITE_LOG): $(TEST_LOGS)
+	@$(am__set_TESTS_bases); \
+	am__f_ok () { test -f "$$1" && test -r "$$1"; }; \
+	redo_bases=`for i in $$bases; do \
+	              am__f_ok $$i.trs && am__f_ok $$i.log || echo $$i; \
+	            done`; \
+	if test -n "$$redo_bases"; then \
+	  redo_logs=`for i in $$redo_bases; do echo $$i.log; done`; \
+	  redo_results=`for i in $$redo_bases; do echo $$i.trs; done`; \
+	  if $(am__make_dryrun); then :; else \
+	    rm -f $$redo_logs && rm -f $$redo_results || exit 1; \
+	  fi; \
+	fi; \
+	if test -n "$$am__remaking_logs"; then \
+	  echo "fatal: making $(TEST_SUITE_LOG): possible infinite" \
+	       "recursion detected" >&2; \
+	elif test -n "$$redo_logs"; then \
+	  am__remaking_logs=yes $(MAKE) $(AM_MAKEFLAGS) $$redo_logs; \
+	fi; \
+	if $(am__make_dryrun); then :; else \
+	  st=0;  \
+	  errmsg="fatal: making $(TEST_SUITE_LOG): failed to create"; \
+	  for i in $$redo_bases; do \
+	    test -f $$i.trs && test -r $$i.trs \
+	      || { echo "$$errmsg $$i.trs" >&2; st=1; }; \
+	    test -f $$i.log && test -r $$i.log \
+	      || { echo "$$errmsg $$i.log" >&2; st=1; }; \
+	  done; \
+	  test $$st -eq 0 || exit 1; \
+	fi
+	@$(am__sh_e_setup); $(am__tty_colors); $(am__set_TESTS_bases); \
+	ws='[ 	]'; \
+	results=`for b in $$bases; do echo $$b.trs; done`; \
+	test -n "$$results" || results=/dev/null; \
+	all=`  grep "^$$ws*:test-result:"           $$results | wc -l`; \
+	pass=` grep "^$$ws*:test-result:$$ws*PASS"  $$results | wc -l`; \
+	fail=` grep "^$$ws*:test-result:$$ws*FAIL"  $$results | wc -l`; \
+	skip=` grep "^$$ws*:test-result:$$ws*SKIP"  $$results | wc -l`; \
+	xfail=`grep "^$$ws*:test-result:$$ws*XFAIL" $$results | wc -l`; \
+	xpass=`grep "^$$ws*:test-result:$$ws*XPASS" $$results | wc -l`; \
+	error=`grep "^$$ws*:test-result:$$ws*ERROR" $$results | wc -l`; \
+	if test `expr $$fail + $$xpass + $$error` -eq 0; then \
+	  success=true; \
+	else \
+	  success=false; \
+	fi; \
+	br='==================='; br=$$br$$br$$br$$br; \
+	result_count () \
+	{ \
+	    if test x"$$1" = x"--maybe-color"; then \
+	      maybe_colorize=yes; \
+	    elif test x"$$1" = x"--no-color"; then \
+	      maybe_colorize=no; \
+	    else \
+	      echo "$@: invalid 'result_count' usage" >&2; exit 4; \
+	    fi; \
+	    shift; \
+	    desc=$$1 count=$$2; \
+	    if test $$maybe_colorize = yes && test $$count -gt 0; then \
+	      color_start=$$3 color_end=$$std; \
+	    else \
+	      color_start= color_end=; \
+	    fi; \
+	    echo "$${color_start}# $$desc $$count$${color_end}"; \
+	}; \
+	create_testsuite_report () \
+	{ \
+	  result_count $$1 "TOTAL:" $$all   "$$brg"; \
+	  result_count $$1 "PASS: " $$pass  "$$grn"; \
+	  result_count $$1 "SKIP: " $$skip  "$$blu"; \
+	  result_count $$1 "XFAIL:" $$xfail "$$lgn"; \
+	  result_count $$1 "FAIL: " $$fail  "$$red"; \
+	  result_count $$1 "XPASS:" $$xpass "$$red"; \
+	  result_count $$1 "ERROR:" $$error "$$mgn"; \
+	}; \
+	{								\
+	  echo "$(PACKAGE_STRING): $(subdir)/$(TEST_SUITE_LOG)" |	\
+	    $(am__rst_title);						\
+	  create_testsuite_report --no-color;				\
+	  echo;								\
+	  echo ".. contents:: :depth: 2";				\
+	  echo;								\
+	  for b in $$bases; do echo $$b; done				\
+	    | $(am__create_global_log);					\
+	} >$(TEST_SUITE_LOG).tmp || exit 1;				\
+	mv $(TEST_SUITE_LOG).tmp $(TEST_SUITE_LOG);			\
+	if $$success; then						\
+	  col="$$grn";							\
+	 else								\
+	  col="$$red";							\
+	  test x"$$VERBOSE" = x || cat $(TEST_SUITE_LOG);		\
+	fi;								\
+	echo "$${col}$$br$${std}"; 					\
+	echo "$${col}Testsuite summary"$(AM_TESTSUITE_SUMMARY_HEADER)"$${std}";	\
+	echo "$${col}$$br$${std}"; 					\
+	create_testsuite_report --maybe-color;				\
+	echo "$$col$$br$$std";						\
+	if $$success; then :; else					\
+	  echo "$${col}See $(subdir)/$(TEST_SUITE_LOG)$${std}";		\
+	  if test -n "$(PACKAGE_BUGREPORT)"; then			\
+	    echo "$${col}Please report to $(PACKAGE_BUGREPORT)$${std}";	\
+	  fi;								\
+	  echo "$$col$$br$$std";					\
+	fi;								\
+	$$success || exit 1
+
+check-TESTS: 
+	@list='$(RECHECK_LOGS)';           test -z "$$list" || rm -f $$list
+	@list='$(RECHECK_LOGS:.log=.trs)'; test -z "$$list" || rm -f $$list
+	@test -z "$(TEST_SUITE_LOG)" || rm -f $(TEST_SUITE_LOG)
+	@set +e; $(am__set_TESTS_bases); \
+	log_list=`for i in $$bases; do echo $$i.log; done`; \
+	trs_list=`for i in $$bases; do echo $$i.trs; done`; \
+	log_list=`echo $$log_list`; trs_list=`echo $$trs_list`; \
+	$(MAKE) $(AM_MAKEFLAGS) $(TEST_SUITE_LOG) TEST_LOGS="$$log_list"; \
+	exit $$?;
+recheck: all 
+	@test -z "$(TEST_SUITE_LOG)" || rm -f $(TEST_SUITE_LOG)
+	@set +e; $(am__set_TESTS_bases); \
+	bases=`for i in $$bases; do echo $$i; done \
+	         | $(am__list_recheck_tests)` || exit 1; \
+	log_list=`for i in $$bases; do echo $$i.log; done`; \
+	log_list=`echo $$log_list`; \
+	$(MAKE) $(AM_MAKEFLAGS) $(TEST_SUITE_LOG) \
+	        am__force_recheck=am--force-recheck \
+	        TEST_LOGS="$$log_list"; \
+	exit $$?
+json-doc-1.log: json-doc-1$(EXEEXT)
+	@p='json-doc-1$(EXEEXT)'; \
+	b='json-doc-1'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+json-doc-2.log: json-doc-2$(EXEEXT)
+	@p='json-doc-2$(EXEEXT)'; \
+	b='json-doc-2'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+json-parser-1.log: json-parser-1$(EXEEXT)
+	@p='json-parser-1$(EXEEXT)'; \
+	b='json-parser-1'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+xml-mapping-1.log: xml-mapping-1$(EXEEXT)
+	@p='xml-mapping-1$(EXEEXT)'; \
+	b='xml-mapping-1'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+spreadsheet-doc-1.log: spreadsheet-doc-1$(EXEEXT)
+	@p='spreadsheet-doc-1$(EXEEXT)'; \
+	b='spreadsheet-doc-1'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+spreadsheet-doc-1-num-and-formula.log: spreadsheet-doc-1-num-and-formula$(EXEEXT)
+	@p='spreadsheet-doc-1-num-and-formula$(EXEEXT)'; \
+	b='spreadsheet-doc-1-num-and-formula'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+spreadsheet-doc-2.log: spreadsheet-doc-2$(EXEEXT)
+	@p='spreadsheet-doc-2$(EXEEXT)'; \
+	b='spreadsheet-doc-2'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+spreadsheet-doc-2-sheets-no-string-pool.log: spreadsheet-doc-2-sheets-no-string-pool$(EXEEXT)
+	@p='spreadsheet-doc-2-sheets-no-string-pool$(EXEEXT)'; \
+	b='spreadsheet-doc-2-sheets-no-string-pool'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+spreadsheet-doc-2-sheets-with-string-pool.log: spreadsheet-doc-2-sheets-with-string-pool$(EXEEXT)
+	@p='spreadsheet-doc-2-sheets-with-string-pool$(EXEEXT)'; \
+	b='spreadsheet-doc-2-sheets-with-string-pool'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+spreadsheet-doc-2-sheets-with-formula.log: spreadsheet-doc-2-sheets-with-formula$(EXEEXT)
+	@p='spreadsheet-doc-2-sheets-with-formula$(EXEEXT)'; \
+	b='spreadsheet-doc-2-sheets-with-formula'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+.test.log:
+	@p='$<'; \
+	$(am__set_b); \
+	$(am__check_pre) $(TEST_LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_TEST_LOG_DRIVER_FLAGS) $(TEST_LOG_DRIVER_FLAGS) -- $(TEST_LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+@am__EXEEXT_TRUE@.test$(EXEEXT).log:
+@am__EXEEXT_TRUE@	@p='$<'; \
+@am__EXEEXT_TRUE@	$(am__set_b); \
+@am__EXEEXT_TRUE@	$(am__check_pre) $(TEST_LOG_DRIVER) --test-name "$$f" \
+@am__EXEEXT_TRUE@	--log-file $$b.log --trs-file $$b.trs \
+@am__EXEEXT_TRUE@	$(am__common_driver_flags) $(AM_TEST_LOG_DRIVER_FLAGS) $(TEST_LOG_DRIVER_FLAGS) -- $(TEST_LOG_COMPILE) \
+@am__EXEEXT_TRUE@	"$$tst" $(AM_TESTS_FD_REDIRECT)
+distdir: $(BUILT_SOURCES)
+	$(MAKE) $(AM_MAKEFLAGS) distdir-am
+
+distdir-am: $(DISTFILES)
+	@srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
+	topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
+	list='$(DISTFILES)'; \
+	  dist_files=`for file in $$list; do echo $$file; done | \
+	  sed -e "s|^$$srcdirstrip/||;t" \
+	      -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \
+	case $$dist_files in \
+	  */*) $(MKDIR_P) `echo "$$dist_files" | \
+			   sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \
+			   sort -u` ;; \
+	esac; \
+	for file in $$dist_files; do \
+	  if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
+	  if test -d $$d/$$file; then \
+	    dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \
+	    if test -d "$(distdir)/$$file"; then \
+	      find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
+	    fi; \
+	    if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
+	      cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \
+	      find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
+	    fi; \
+	    cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \
+	  else \
+	    test -f "$(distdir)/$$file" \
+	    || cp -p $$d/$$file "$(distdir)/$$file" \
+	    || exit 1; \
+	  fi; \
+	done
+check-am: all-am
+	$(MAKE) $(AM_MAKEFLAGS) check-TESTS
+check: check-am
+all-am: Makefile $(PROGRAMS)
+installdirs:
+	for dir in "$(DESTDIR)$(bindir)"; do \
+	  test -z "$$dir" || $(MKDIR_P) "$$dir"; \
+	done
+install: install-am
+install-exec: install-exec-am
+install-data: install-data-am
+uninstall: uninstall-am
+
+install-am: all-am
+	@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
+
+installcheck: installcheck-am
+install-strip:
+	if test -z '$(STRIP)'; then \
+	  $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
+	    install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
+	      install; \
+	else \
+	  $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
+	    install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
+	    "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \
+	fi
+mostlyclean-generic:
+	-test -z "$(TEST_LOGS)" || rm -f $(TEST_LOGS)
+	-test -z "$(TEST_LOGS:.log=.trs)" || rm -f $(TEST_LOGS:.log=.trs)
+	-test -z "$(TEST_SUITE_LOG)" || rm -f $(TEST_SUITE_LOG)
+
+clean-generic:
+
+distclean-generic:
+	-test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES)
+	-test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES)
+
+maintainer-clean-generic:
+	@echo "This command is intended for maintainers to use"
+	@echo "it deletes files that may require special tools to rebuild."
+check-valgrind: check-valgrind-am
+
+check-valgrind-am: check-valgrind-local
+
+check-valgrind-drd: check-valgrind-drd-am
+
+check-valgrind-drd-am: check-valgrind-drd-local
+
+check-valgrind-helgrind: check-valgrind-helgrind-am
+
+check-valgrind-helgrind-am: check-valgrind-helgrind-local
+
+check-valgrind-memcheck: check-valgrind-memcheck-am
+
+check-valgrind-memcheck-am: check-valgrind-memcheck-local
+
+check-valgrind-sgcheck: check-valgrind-sgcheck-am
+
+check-valgrind-sgcheck-am: check-valgrind-sgcheck-local
+
+clean: clean-am
+
+clean-am: clean-binPROGRAMS clean-generic clean-libtool mostlyclean-am
+
+distclean: distclean-am
+		-rm -f ./$(DEPDIR)/json_doc_1.Po
+	-rm -f ./$(DEPDIR)/json_doc_2.Po
+	-rm -f ./$(DEPDIR)/json_parser_1.Po
+	-rm -f ./$(DEPDIR)/spreadsheet_doc_1.Po
+	-rm -f ./$(DEPDIR)/spreadsheet_doc_1_num_and_formula.Po
+	-rm -f ./$(DEPDIR)/spreadsheet_doc_2.Po
+	-rm -f ./$(DEPDIR)/spreadsheet_doc_2_sheets_no_string_pool.Po
+	-rm -f ./$(DEPDIR)/spreadsheet_doc_2_sheets_with_formula.Po
+	-rm -f ./$(DEPDIR)/spreadsheet_doc_2_sheets_with_string_pool.Po
+	-rm -f ./$(DEPDIR)/xml_mapping_1.Po
+	-rm -f Makefile
+distclean-am: clean-am distclean-compile distclean-generic \
+	distclean-local distclean-tags
+
+dvi: dvi-am
+
+dvi-am:
+
+html: html-am
+
+html-am:
+
+info: info-am
+
+info-am:
+
+install-data-am:
+
+install-dvi: install-dvi-am
+
+install-dvi-am:
+
+install-exec-am: install-binPROGRAMS
+
+install-html: install-html-am
+
+install-html-am:
+
+install-info: install-info-am
+
+install-info-am:
+
+install-man:
+
+install-pdf: install-pdf-am
+
+install-pdf-am:
+
+install-ps: install-ps-am
+
+install-ps-am:
+
+installcheck-am:
+
+maintainer-clean: maintainer-clean-am
+		-rm -f ./$(DEPDIR)/json_doc_1.Po
+	-rm -f ./$(DEPDIR)/json_doc_2.Po
+	-rm -f ./$(DEPDIR)/json_parser_1.Po
+	-rm -f ./$(DEPDIR)/spreadsheet_doc_1.Po
+	-rm -f ./$(DEPDIR)/spreadsheet_doc_1_num_and_formula.Po
+	-rm -f ./$(DEPDIR)/spreadsheet_doc_2.Po
+	-rm -f ./$(DEPDIR)/spreadsheet_doc_2_sheets_no_string_pool.Po
+	-rm -f ./$(DEPDIR)/spreadsheet_doc_2_sheets_with_formula.Po
+	-rm -f ./$(DEPDIR)/spreadsheet_doc_2_sheets_with_string_pool.Po
+	-rm -f ./$(DEPDIR)/xml_mapping_1.Po
+	-rm -f Makefile
+maintainer-clean-am: distclean-am maintainer-clean-generic
+
+mostlyclean: mostlyclean-am
+
+mostlyclean-am: mostlyclean-compile mostlyclean-generic \
+	mostlyclean-libtool
+
+pdf: pdf-am
+
+pdf-am:
+
+ps: ps-am
+
+ps-am:
+
+uninstall-am: uninstall-binPROGRAMS
+
+.MAKE: check-am install-am install-strip
+
+.PHONY: CTAGS GTAGS TAGS all all-am am--depfiles check check-TESTS \
+	check-am check-valgrind-am check-valgrind-drd-am \
+	check-valgrind-drd-local check-valgrind-helgrind-am \
+	check-valgrind-helgrind-local check-valgrind-local \
+	check-valgrind-memcheck-am check-valgrind-memcheck-local \
+	check-valgrind-sgcheck-am check-valgrind-sgcheck-local clean \
+	clean-binPROGRAMS clean-generic clean-libtool cscopelist-am \
+	ctags ctags-am distclean distclean-compile distclean-generic \
+	distclean-libtool distclean-local distclean-tags distdir dvi \
+	dvi-am html html-am info info-am install install-am \
+	install-binPROGRAMS install-data install-data-am install-dvi \
+	install-dvi-am install-exec install-exec-am install-html \
+	install-html-am install-info install-info-am install-man \
+	install-pdf install-pdf-am install-ps install-ps-am \
+	install-strip installcheck installcheck-am installdirs \
+	maintainer-clean maintainer-clean-generic mostlyclean \
+	mostlyclean-compile mostlyclean-generic mostlyclean-libtool \
+	pdf pdf-am ps ps-am recheck tags tags-am uninstall \
+	uninstall-am uninstall-binPROGRAMS
+
+.PRECIOUS: Makefile
+
+
+distclean-local:
+	rm -rf $(TESTS)
+
+# Tell versions [3.59,3.63) of GNU make to not export all variables.
+# Otherwise a system limit (for SysV at least) may be exceeded.
+.NOEXPORT:
diff --git a/doc_example/files/document.ods b/doc_example/files/document.ods
new file mode 100644
index 0000000..d310af2
--- /dev/null
+++ b/doc_example/files/document.ods
diff --git a/doc_example/files/multi-sheets.ods b/doc_example/files/multi-sheets.ods
new file mode 100644
index 0000000..87685e7
--- /dev/null
+++ b/doc_example/files/multi-sheets.ods
diff --git a/doc_example/json_doc_1.cpp b/doc_example/json_doc_1.cpp
new file mode 100644
index 0000000..cb5449f
--- /dev/null
+++ b/doc_example/json_doc_1.cpp
@@ -0,0 +1,55 @@
+
+#include <orcus/json_document_tree.hpp>
+#include <orcus/config.hpp>
+
+#include <cstdlib>
+#include <iostream>
+
+using namespace std;
+
+const char* json_string = "{"
+"   \"name\": \"John Doe\","
+"   \"occupation\": \"Software Engineer\","
+"   \"score\": [89, 67, 90]"
+"}";
+
+int main()
+{
+    using node = orcus::json::node;
+
+    orcus::json_config config; // Use default configuration.
+
+    orcus::json::document_tree doc;
+    doc.load(json_string, config);
+
+    // Root is an object containing three key-value pairs.
+    node root = doc.get_document_root();
+
+    for (std::string_view key : root.keys())
+    {
+        node value = root.child(key);
+        switch (value.type())
+        {
+            case orcus::json::node_t::string:
+                // string value
+                cout << key << ": " << value.string_value() << endl;
+                break;
+            case orcus::json::node_t::array:
+            {
+                // array value
+                cout << key << ":" << endl;
+
+                for (size_t i = 0; i < value.child_count(); ++i)
+                {
+                    node array_element = value.child(i);
+                    cout << "  - " << array_element.numeric_value() << endl;
+                }
+                break;
+            }
+            default:
+                ;
+        }
+    }
+
+    return EXIT_SUCCESS;
+}
diff --git a/doc_example/json_doc_2.cpp b/doc_example/json_doc_2.cpp
new file mode 100644
index 0000000..97ed3b5
--- /dev/null
+++ b/doc_example/json_doc_2.cpp
@@ -0,0 +1,219 @@
+
+#include <orcus/json_document_tree.hpp>
+#include <orcus/config.hpp>
+
+#include <iostream>
+#include <functional>
+#include <vector>
+
+void example_root_list()
+{
+    //!code-start: root list
+    orcus::json::document_tree doc = {
+        1.0, 2.0, "string value", false, nullptr
+    };
+
+    std::cout << doc.dump() << std::endl;
+    //!code-end: root list
+}
+
+void example_list_nested()
+{
+    //!code-start: list nested
+    orcus::json::document_tree doc = {
+        { true, false, nullptr },
+        { 1.1, 2.2, "text" }
+    };
+
+    std::cout << doc.dump() << std::endl;
+    //!code-end: list nested
+}
+
+void example_list_object()
+{
+    //!code-start: list object
+    orcus::json::document_tree doc = {
+        { "key1", 1.2 },
+        { "key2", "some text" },
+    };
+
+    std::cout << doc.dump() << std::endl;
+    //!code-end: list object
+}
+
+void example_list_object_2()
+{
+    //!code-start: list object 2
+    orcus::json::document_tree doc = {
+        { "parent1", {
+                { "child1", true  },
+                { "child2", false },
+                { "child3", 123.4 },
+            }
+        },
+        { "parent2", "not-nested" },
+    };
+
+    std::cout << doc.dump() << std::endl;
+    //!code-end: list object 2
+}
+
+void example_array_ambiguous()
+{
+    //!code-start: array ambiguous
+    orcus::json::document_tree doc = {
+        { "array", { "one", 987.0 } }
+    };
+    //!code-end: array ambiguous
+}
+
+void example_array_explicit()
+{
+    //!code-start: array explicit
+    using namespace orcus;
+
+    json::document_tree doc = {
+        { "array", json::array({ "one", 987.0 }) }
+    };
+
+    std::cout << doc.dump() << std::endl;
+    //!code-end: array explicit
+}
+
+void example_object_ambiguous()
+{
+    //!code-start: object ambiguous a
+    using namespace orcus;
+
+    json::document_tree doc = {};
+    //!code-end: object ambiguous a
+
+    //!code-start: object ambiguous b
+    try
+    {
+        auto root = doc.get_document_root();
+    }
+    catch (const json::document_error& e)
+    {
+        std::cout << e.what() << std::endl;
+    }
+    //!code-end: object ambiguous b
+}
+
+void example_object_explicit_1()
+{
+    //!code-start: object explicit 1
+    using namespace orcus;
+
+    json::document_tree doc = json::object();
+
+    std::cout << doc.dump() << std::endl;
+    //!code-end: object explicit 1
+}
+
+void example_object_explicit_2()
+{
+    //!code-start: object explicit 2
+    using namespace orcus;
+
+    json::document_tree doc = {
+        json::object(),
+        json::object(),
+        json::object()
+    };
+
+    std::cout << doc.dump() << std::endl;
+    //!code-end: object explicit 2
+}
+
+void example_root_object_add_child()
+{
+    //!code-start: root object add child
+    using namespace orcus;
+
+    // Initialize the tree with an empty object.
+    json::document_tree doc = json::object();
+
+    // Get the root object, and assign three key-value pairs.
+    json::node root = doc.get_document_root();
+    root["child1"] = 1.0;
+    root["child2"] = "string";
+    root["child3"] = { true, false }; // implicit array
+
+    // You can also create a key-value pair whose value is another object.
+    root["child object"] = {
+        { "key1", 100.0 },
+        { "key2", 200.0 }
+    };
+
+    root["child array"] = json::array({ 1.1, 1.2, true }); // explicit array
+
+    std::cout << doc.dump() << std::endl;
+    //!code-end: root object add child
+}
+
+void example_root_array_add_child()
+{
+    //!code-start: root array add child
+    using namespace orcus;
+
+    // Initialize the tree with an empty array root.
+    json::document_tree doc = json::array();
+
+    // Get the root array.
+    json::node root = doc.get_document_root();
+
+    // Append values to the array.
+    root.push_back(-1.2);
+    root.push_back("string");
+    root.push_back(true);
+    root.push_back(nullptr);
+
+    // You can append an object to the array via push_back() as well.
+    root.push_back({{"key1", 1.1}, {"key2", 1.2}});
+
+    std::cout << doc.dump() << std::endl;
+    //!code-end: root array add child
+}
+
+int main()
+{
+    using func_type = std::function<void()>;
+
+    std::vector<func_type> funcs = {
+        example_root_list,
+        example_list_nested,
+        example_list_object,
+        example_list_object_2,
+        example_array_explicit,
+        example_object_ambiguous,
+        example_object_explicit_1,
+        example_object_explicit_2,
+        example_root_object_add_child,
+        example_root_array_add_child,
+    };
+
+    for (func_type f : funcs)
+    {
+        std::cout << "--" << std::endl;
+        f();
+    }
+
+    std::vector<func_type> funcs_exc = {
+        example_array_ambiguous,
+    };
+
+    for (func_type f : funcs_exc)
+    {
+        try
+        {
+            f();
+        }
+        catch (orcus::json::key_value_error&)
+        {
+            // expected
+        }
+    }
+
+    return EXIT_SUCCESS;
+}
diff --git a/doc_example/json_parser_1.cpp b/doc_example/json_parser_1.cpp
new file mode 100644
index 0000000..322316a
--- /dev/null
+++ b/doc_example/json_parser_1.cpp
@@ -0,0 +1,41 @@
+
+#include <orcus/json_parser.hpp>
+#include <cstring>
+#include <iostream>
+
+using namespace std;
+
+class json_parser_handler : public orcus::json_handler
+{
+public:
+    void object_key(std::string_view key, bool /*transient*/)
+    {
+        cout << "object key: " << key << endl;
+    }
+
+    void string(std::string_view val, bool /*transient*/)
+    {
+        cout << "string: " << val << endl;
+    }
+
+    void number(double val)
+    {
+        cout << "number: " << val << endl;
+    }
+};
+
+int main()
+{
+    const char* test_code = "{\"key1\": [1,2,3,4,5], \"key2\": 12.3}";
+
+    cout << "JSON string: " << test_code << endl;
+
+    // Instantiate the parser with an own handler.
+    json_parser_handler hdl;
+    orcus::json_parser<json_parser_handler> parser(test_code, hdl);
+
+    // Parse the string.
+    parser.parse();
+
+    return EXIT_SUCCESS;
+}
diff --git a/doc_example/spreadsheet_doc_1.cpp b/doc_example/spreadsheet_doc_1.cpp
new file mode 100644
index 0000000..00bbba4
--- /dev/null
+++ b/doc_example/spreadsheet_doc_1.cpp
@@ -0,0 +1,64 @@
+
+#include <orcus/spreadsheet/document.hpp>
+#include <orcus/spreadsheet/factory.hpp>
+#include <orcus/orcus_ods.hpp>
+
+#include <ixion/address.hpp>
+#include <ixion/model_context.hpp>
+
+#include <iostream>
+#include <cstdlib>
+#include <filesystem>
+
+using namespace orcus;
+
+int main()
+{
+    std::filesystem::path input_dir = std::getenv("INPUTDIR");
+
+    //!code-start: instantiate
+    spreadsheet::range_size_t ss{1048576, 16384};
+    spreadsheet::document doc{ss};
+    spreadsheet::import_factory factory{doc};
+    //!code-end: instantiate
+
+    //!code-start: loader
+    orcus_ods loader(&factory);
+    //!code-end: loader
+
+    //!code-start: read-file
+    auto filepath = input_dir / "document.ods";
+    loader.read_file(filepath.native());
+    //!code-end: read-file
+
+    //!code-start: model-context
+    const ixion::model_context& model = doc.get_model_context();
+    //!code-end: model-context
+
+    //!code-start: string-id
+    ixion::abs_address_t pos(0, 0, 0); // Set the cell position to A1.
+    ixion::string_id_t str_id = model.get_string_identifier(pos);
+    //!code-end: string-id
+
+    //!code-start: print-string
+    const std::string* s = model.get_string(str_id);
+    assert(s);
+    std::cout << "A1: " << *s << std::endl;
+    //!code-end: print-string
+
+    //!code-start: rest
+    pos.column = 1; // Move to B1
+    str_id = model.get_string_identifier(pos);
+    s = model.get_string(str_id);
+    assert(s);
+    std::cout << "B1: " << *s << std::endl;
+
+    pos.column = 2; // Move to C1
+    str_id = model.get_string_identifier(pos);
+    s = model.get_string(str_id);
+    assert(s);
+    std::cout << "C1: " << *s << std::endl;
+    //!code-end: rest
+
+    return EXIT_SUCCESS;
+}
diff --git a/doc_example/spreadsheet_doc_1_num_and_formula.cpp b/doc_example/spreadsheet_doc_1_num_and_formula.cpp
new file mode 100644
index 0000000..88c405c
--- /dev/null
+++ b/doc_example/spreadsheet_doc_1_num_and_formula.cpp
@@ -0,0 +1,62 @@
+
+#include <orcus/spreadsheet/document.hpp>
+#include <orcus/spreadsheet/factory.hpp>
+#include <orcus/orcus_ods.hpp>
+
+#include <ixion/address.hpp>
+#include <ixion/model_context.hpp>
+#include <ixion/formula_result.hpp>
+#include <ixion/cell.hpp>
+
+#include <iostream>
+#include <filesystem>
+
+using namespace orcus;
+
+int main()
+{
+    std::filesystem::path input_dir = std::getenv("INPUTDIR");
+
+    // Instantiate a document, and wrap it with a factory.
+    spreadsheet::range_size_t ss{1048576, 16384};
+    spreadsheet::document doc{ss};
+    spreadsheet::import_factory factory{doc};
+
+    // Pass the factory to the document loader, and read the content from a file
+    // to populate the document.
+    orcus_ods loader(&factory);
+    auto filepath = input_dir / "document.ods";
+    loader.read_file(filepath.native());
+    doc.recalc_formula_cells();
+
+    // Now that the document is fully populated, access its content.
+    const ixion::model_context& model = doc.get_model_context();
+
+    //!code-start: print-numeric-cells
+    for (spreadsheet::row_t row = 1; row <= 6; ++row)
+    {
+        ixion::abs_address_t pos(0, row, 0);
+        double value = model.get_numeric_value(pos);
+        std::cout << "A" << (pos.row+1) << ": " << value << std::endl;
+    }
+    //!code-end: print-numeric-cells
+
+    //!code-start: print-formula-cells
+    for (spreadsheet::row_t row = 1; row <=6; ++row)
+    {
+        ixion::abs_address_t pos(0, row, 2); // Column C
+        const ixion::formula_cell* fc = model.get_formula_cell(pos);
+        assert(fc);
+
+        // Get the formula cell results.
+        const ixion::formula_result& result = fc->get_result_cache(
+            ixion::formula_result_wait_policy_t::throw_exception);
+
+        // We already know the result is a string.
+        const std::string& s = result.get_string();
+        std::cout << "C" << (pos.row+1) << ": " << s << std::endl;
+    }
+    //!code-end: print-formula-cells
+
+    return EXIT_SUCCESS;
+}
diff --git a/doc_example/spreadsheet_doc_2.cpp b/doc_example/spreadsheet_doc_2.cpp
new file mode 100644
index 0000000..614b50b
--- /dev/null
+++ b/doc_example/spreadsheet_doc_2.cpp
@@ -0,0 +1,44 @@
+
+#include <orcus/spreadsheet/import_interface.hpp>
+#include <orcus/orcus_ods.hpp>
+
+#include <filesystem>
+#include <iostream>
+
+namespace ss = orcus::spreadsheet;
+
+class my_empty_import_factory : public ss::iface::import_factory
+{
+public:
+    virtual ss::iface::import_sheet* append_sheet(ss::sheet_t sheet_index, std::string_view name) override
+    {
+        std::cout << "append_sheet: sheet index: " << sheet_index << "; sheet name: " << name << std::endl;
+        return nullptr;
+    }
+
+    virtual ss::iface::import_sheet* get_sheet(std::string_view name) override
+    {
+        std::cout << "get_sheet: sheet name: " << name << std::endl;
+        return nullptr;
+    }
+
+    virtual ss::iface::import_sheet* get_sheet(ss::sheet_t sheet_index) override
+    {
+        std::cout << "get_sheet: sheet index: " << sheet_index << std::endl;
+        return nullptr;
+    }
+
+    virtual void finalize() override {}
+};
+
+int main()
+{
+    std::filesystem::path input_dir = std::getenv("INPUTDIR");
+    auto filepath = input_dir / "multi-sheets.ods";
+
+    my_empty_import_factory factory;
+    orcus::orcus_ods loader(&factory);
+    loader.read_file(filepath.native());
+
+    return EXIT_SUCCESS;
+}
diff --git a/doc_example/spreadsheet_doc_2_sheets_no_string_pool.cpp b/doc_example/spreadsheet_doc_2_sheets_no_string_pool.cpp
new file mode 100644
index 0000000..ea58d5e
--- /dev/null
+++ b/doc_example/spreadsheet_doc_2_sheets_no_string_pool.cpp
@@ -0,0 +1,123 @@
+
+#include <orcus/spreadsheet/import_interface.hpp>
+#include <orcus/orcus_ods.hpp>
+
+#include <iostream>
+#include <memory>
+#include <filesystem>
+
+//!code-start: cell_value
+namespace ss = orcus::spreadsheet;
+
+enum class cell_value_type { empty, numeric, string };
+
+struct cell_value
+{
+    cell_value_type type;
+
+    union
+    {
+        std::size_t index;
+        double f;
+    };
+
+    cell_value() : type(cell_value_type::empty) {}
+};
+//!code-end: cell_value
+
+//!code-start: my_sheet
+class my_sheet : public ss::iface::import_sheet
+{
+    cell_value m_cells[100][1000];
+    ss::range_size_t m_sheet_size;
+    ss::sheet_t m_sheet_index;
+
+public:
+    my_sheet(ss::sheet_t sheet_index) :
+        m_sheet_index(sheet_index)
+    {
+        m_sheet_size.rows = 1000;
+        m_sheet_size.columns = 100;
+    }
+
+    virtual void set_string(ss::row_t row, ss::col_t col, ss::string_id_t sindex) override
+    {
+        std::cout << "(sheet: " << m_sheet_index << "; row: " << row << "; col: " << col
+            << "): string index = " << sindex << std::endl;
+
+        m_cells[col][row].type = cell_value_type::string;
+        m_cells[col][row].index = sindex;
+    }
+
+    virtual void set_value(ss::row_t row, ss::col_t col, double value) override
+    {
+        std::cout << "(sheet: " << m_sheet_index << "; row: " << row << "; col: " << col
+            << "): value = " << value << std::endl;
+
+        m_cells[col][row].type = cell_value_type::numeric;
+        m_cells[col][row].f = value;
+    }
+
+    virtual ss::range_size_t get_sheet_size() const override
+    {
+        return m_sheet_size;
+    }
+
+    // We don't implement these methods for now.
+    virtual void set_auto(ss::row_t, ss::col_t, std::string_view) override {}
+
+    virtual void set_bool(ss::row_t, ss::col_t, bool) override {}
+
+    virtual void set_date_time(ss::row_t, ss::col_t, int, int, int, int, int, double) override {}
+
+    virtual void set_format(ss::row_t, ss::col_t, std::size_t) override {}
+
+    virtual void set_format(ss::row_t, ss::col_t, ss::row_t, ss::col_t, std::size_t) override {}
+
+    virtual void set_column_format(ss::col_t, ss::col_t, std::size_t) override {}
+
+    virtual void set_row_format(ss::col_t, std::size_t) override {}
+
+    virtual void fill_down_cells(ss::row_t, ss::col_t, ss::row_t) override {}
+};
+//!code-end: my_sheet
+
+//!code-start: my_import_factory
+class my_import_factory : public ss::iface::import_factory
+{
+    std::vector<std::unique_ptr<my_sheet>> m_sheets;
+
+public:
+    virtual ss::iface::import_sheet* append_sheet(ss::sheet_t, std::string_view) override
+    {
+        m_sheets.push_back(std::make_unique<my_sheet>(m_sheets.size()));
+        return m_sheets.back().get();
+    }
+
+    virtual ss::iface::import_sheet* get_sheet(std::string_view) override
+    {
+        // TODO : implement this.
+        return nullptr;
+    }
+
+    virtual ss::iface::import_sheet* get_sheet(ss::sheet_t sheet_index) override
+    {
+        ss::sheet_t sheet_count = m_sheets.size();
+        return sheet_index < sheet_count ? m_sheets[sheet_index].get() : nullptr;
+    }
+
+    virtual void finalize() override {}
+};
+//!code-end: my_import_factory
+
+int main()
+{
+    std::filesystem::path input_dir = std::getenv("INPUTDIR");
+    auto filepath = input_dir / "multi-sheets.ods";
+
+    my_import_factory factory;
+    orcus::orcus_ods loader(&factory);
+    loader.read_file(filepath.native());
+
+    return EXIT_SUCCESS;
+}
diff --git a/doc_example/spreadsheet_doc_2_sheets_with_formula.cpp b/doc_example/spreadsheet_doc_2_sheets_with_formula.cpp
new file mode 100644
index 0000000..29511e4
--- /dev/null
+++ b/doc_example/spreadsheet_doc_2_sheets_with_formula.cpp
@@ -0,0 +1,290 @@
+
+#include <orcus/spreadsheet/import_interface.hpp>
+#include <orcus/orcus_ods.hpp>
+
+#include <iostream>
+#include <memory>
+#include <unordered_map>
+#include <deque>
+#include <filesystem>
+
+namespace ss = orcus::spreadsheet;
+
+//!code-start: cell_value_type
+enum class cell_value_type { empty, numeric, string, formula }; // adding a formula type here
+//!code-end: cell_value_type
+
+using ss_type = std::deque<std::string>;
+using ss_hash_type = std::unordered_map<std::string_view, std::size_t>;
+
+struct cell_value
+{
+    cell_value_type type;
+
+    union
+    {
+        size_t index;  // either a string index or a formula index
+        double f;
+    };
+
+    cell_value() : type(cell_value_type::empty) {}
+};
+
+//!code-start: cell_grid
+class cell_grid
+{
+    cell_value m_cells[100][1000];
+public:
+
+    cell_value& operator()(ss::row_t row, ss::col_t col)
+    {
+        return m_cells[col][row];
+    }
+};
+//!code-end: cell_grid
+
+//!code-start: formula
+struct formula
+{
+    std::string expression;
+    ss::formula_grammar_t grammar;
+
+    formula() : grammar(ss::formula_grammar_t::unknown) {}
+    formula(std::string _expression, ss::formula_grammar_t _grammar) :
+        expression(std::move(_expression)),
+        grammar(_grammar) {}
+};
+//!code-end: formula
+
+//!code-start: my_formula
+class my_formula : public ss::iface::import_formula
+{
+    ss::sheet_t m_sheet_index;
+    cell_grid& m_cells;
+    std::vector<formula>& m_formula_store;
+
+    ss::row_t m_row;
+    ss::col_t m_col;
+    formula m_formula;
+
+public:
+    my_formula(ss::sheet_t sheet, cell_grid& cells, std::vector<formula>& formulas) :
+        m_sheet_index(sheet),
+        m_cells(cells),
+        m_formula_store(formulas),
+        m_row(0),
+        m_col(0) {}
+
+    virtual void set_position(ss::row_t row, ss::col_t col) override
+    {
+        m_row = row;
+        m_col = col;
+    }
+
+    virtual void set_formula(ss::formula_grammar_t grammar, std::string_view formula) override
+    {
+        m_formula.expression = formula;
+        m_formula.grammar = grammar;
+    }
+
+    virtual void set_shared_formula_index(std::size_t) override {}
+
+    virtual void set_result_string(std::string_view) override {}
+
+    virtual void set_result_value(double) override {}
+
+    virtual void set_result_empty() override {}
+
+    virtual void set_result_bool(bool) override {}
+
+    virtual void commit() override
+    {
+        std::cout << "(sheet: " << m_sheet_index << "; row: " << m_row << "; col: " << m_col << "): formula = "
+            << m_formula.expression << " (" << m_formula.grammar << ")" << std::endl;
+
+        std::size_t index = m_formula_store.size();
+        m_cells(m_row, m_col).type = cell_value_type::formula;
+        m_cells(m_row, m_col).index = index;
+        m_formula_store.push_back(std::move(m_formula));
+    }
+};
+//!code-end: my_formula
+
+//!code-start: my_sheet
+class my_sheet : public ss::iface::import_sheet
+{
+    cell_grid m_cells;
+    std::vector<formula> m_formula_store;
+    my_formula m_formula_iface;
+    ss::range_size_t m_sheet_size;
+    ss::sheet_t m_sheet_index;
+    const ss_type& m_string_pool;
+
+public:
+    my_sheet(ss::sheet_t sheet_index, const ss_type& string_pool) :
+        m_formula_iface(sheet_index, m_cells, m_formula_store),
+        m_sheet_index(sheet_index),
+        m_string_pool(string_pool)
+    {
+        m_sheet_size.rows = 1000;
+        m_sheet_size.columns = 100;
+    }
+
+    virtual void set_string(ss::row_t row, ss::col_t col, ss::string_id_t sindex) override
+    {
+        std::cout << "(sheet: " << m_sheet_index << "; row: " << row << "; col: " << col
+             << "): string index = " << sindex << " (" << m_string_pool[sindex] << ")" << std::endl;
+
+        m_cells(row, col).type = cell_value_type::string;
+        m_cells(row, col).index = sindex;
+    }
+
+    virtual void set_value(ss::row_t row, ss::col_t col, double value) override
+    {
+        std::cout << "(sheet: " << m_sheet_index << "; row: " << row << "; col: " << col
+             << "): value = " << value << std::endl;
+
+        m_cells(row, col).type = cell_value_type::numeric;
+        m_cells(row, col).f = value;
+    }
+
+    virtual ss::range_size_t get_sheet_size() const override
+    {
+        return m_sheet_size;
+    }
+
+    // We don't implement these methods for now.
+    virtual void set_auto(ss::row_t, ss::col_t, std::string_view) override {}
+
+    virtual void set_bool(ss::row_t, ss::col_t, bool) override {}
+
+    virtual void set_date_time(ss::row_t, ss::col_t, int, int, int, int, int, double) override {}
+
+    virtual void set_format(ss::row_t, ss::col_t, std::size_t) override {}
+
+    virtual void set_format(ss::row_t, ss::col_t, ss::row_t, ss::col_t, std::size_t) override {}
+
+    virtual void set_column_format(ss::col_t, ss::col_t, std::size_t) override {}
+
+    virtual void set_row_format(ss::col_t, std::size_t) override {}
+
+    virtual void fill_down_cells(ss::row_t, ss::col_t, ss::row_t) override {}
+
+    virtual ss::iface::import_formula* get_formula() override
+    {
+        return &m_formula_iface;
+    }
+};
+//!code-end: my_sheet
+
+class my_shared_strings : public ss::iface::import_shared_strings
+{
+    ss_hash_type m_ss_hash;
+    ss_type& m_ss;
+    std::string m_current_string;
+
+public:
+    my_shared_strings(ss_type& ss) : m_ss(ss) {}
+
+    virtual size_t add(std::string_view s) override
+    {
+        auto it = m_ss_hash.find(s);
+        if (it != m_ss_hash.end())
+            // This string already exists in the pool.
+            return it->second;
+
+        // This is a brand-new string.
+        return append(s);
+    }
+
+    virtual size_t append(std::string_view s) override
+    {
+        std::size_t string_index = m_ss.size();
+        m_ss.emplace_back(s);
+        m_ss_hash.emplace(s, string_index);
+
+        return string_index;
+    }
+
+    // The following methods are for formatted text segments, which we ignore for now.
+    virtual void set_segment_bold(bool) override {}
+
+    virtual void set_segment_font(std::size_t) override {}
+
+    virtual void set_segment_font_color(
+        ss::color_elem_t,
+        ss::color_elem_t,
+        ss::color_elem_t,
+        ss::color_elem_t) override {}
+
+    virtual void set_segment_font_name(std::string_view) override {}
+
+    virtual void set_segment_font_size(double) override {}
+
+    virtual void set_segment_italic(bool) override {}
+
+    virtual void append_segment(std::string_view s) override
+    {
+        m_current_string += s;
+    }
+
+    virtual std::size_t commit_segments() override
+    {
+        std::size_t string_index = m_ss.size();
+        m_ss.push_back(std::move(m_current_string));
+
+        const std::string& s = m_ss.back();
+        std::string_view sv(s.data(), s.size());
+        m_ss_hash.emplace(sv, string_index);
+
+        return string_index;
+    }
+};
+
+class my_import_factory : public ss::iface::import_factory
+{
+    ss_type m_string_pool; // string pool to be shared everywhere.
+    my_shared_strings m_shared_strings;
+    std::vector<std::unique_ptr<my_sheet>> m_sheets;
+
+public:
+    my_import_factory() : m_shared_strings(m_string_pool) {}
+
+    virtual ss::iface::import_shared_strings* get_shared_strings() override
+    {
+        return &m_shared_strings;
+    }
+
+    virtual ss::iface::import_sheet* append_sheet(ss::sheet_t, std::string_view) override
+    {
+        // Pass the string pool to each sheet instance.
+        m_sheets.push_back(std::make_unique<my_sheet>(m_sheets.size(), m_string_pool));
+        return m_sheets.back().get();
+    }
+
+    virtual ss::iface::import_sheet* get_sheet(std::string_view) override
+    {
+        // TODO : implement this.
+        return nullptr;
+    }
+
+    virtual ss::iface::import_sheet* get_sheet(ss::sheet_t sheet_index) override
+    {
+        ss::sheet_t sheet_count = m_sheets.size();
+        return sheet_index < sheet_count ? m_sheets[sheet_index].get() : nullptr;
+    }
+
+    virtual void finalize() override {}
+};
+
+int main()
+{
+    std::filesystem::path input_dir = std::getenv("INPUTDIR");
+    auto filepath = input_dir / "multi-sheets.ods";
+
+    my_import_factory factory;
+    orcus::orcus_ods loader(&factory);
+    loader.read_file(filepath.native());
+
+    return EXIT_SUCCESS;
+}
diff --git a/doc_example/spreadsheet_doc_2_sheets_with_string_pool.cpp b/doc_example/spreadsheet_doc_2_sheets_with_string_pool.cpp
new file mode 100644
index 0000000..76fcf80
--- /dev/null
+++ b/doc_example/spreadsheet_doc_2_sheets_with_string_pool.cpp
@@ -0,0 +1,204 @@
+
+#include <orcus/spreadsheet/import_interface.hpp>
+#include <orcus/orcus_ods.hpp>
+
+#include <iostream>
+#include <memory>
+#include <unordered_map>
+#include <deque>
+#include <filesystem>
+
+namespace ss = orcus::spreadsheet;
+
+enum class cell_value_type { empty, numeric, string };
+
+//!code-start: types
+using ss_type = std::deque<std::string>;
+using ss_hash_type = std::unordered_map<std::string_view, std::size_t>;
+//!code-end: types
+
+struct cell_value
+{
+    cell_value_type type;
+
+    union
+    {
+        std::size_t index;
+        double f;
+    };
+
+    cell_value() : type(cell_value_type::empty) {}
+};
+
+class my_sheet : public ss::iface::import_sheet
+{
+    cell_value m_cells[100][1000];
+    ss::range_size_t m_sheet_size;
+    ss::sheet_t m_sheet_index;
+    const ss_type& m_string_pool;
+
+public:
+    my_sheet(ss::sheet_t sheet_index, const ss_type& string_pool) :
+        m_sheet_index(sheet_index),
+        m_string_pool(string_pool)
+    {
+        m_sheet_size.rows = 1000;
+        m_sheet_size.columns = 100;
+    }
+
+    virtual void set_string(ss::row_t row, ss::col_t col, ss::string_id_t sindex) override
+    {
+        std::cout << "(sheet: " << m_sheet_index << "; row: " << row << "; col: " << col
+            << "): string index = " << sindex << " (" << m_string_pool[sindex] << ")" << std::endl;
+
+        m_cells[col][row].type = cell_value_type::string;
+        m_cells[col][row].index = sindex;
+    }
+
+    virtual void set_value(ss::row_t row, ss::col_t col, double value) override
+    {
+        std::cout << "(sheet: " << m_sheet_index << "; row: " << row << "; col: " << col
+            << "): value = " << value << std::endl;
+
+        m_cells[col][row].type = cell_value_type::numeric;
+        m_cells[col][row].f = value;
+    }
+
+    virtual ss::range_size_t get_sheet_size() const override
+    {
+        return m_sheet_size;
+    }
+
+    // We don't implement these methods for now.
+    virtual void set_auto(ss::row_t, ss::col_t, std::string_view) override {}
+
+    virtual void set_bool(ss::row_t, ss::col_t, bool) override {}
+
+    virtual void set_date_time(ss::row_t, ss::col_t, int, int, int, int, int, double) override {}
+
+    virtual void set_format(ss::row_t, ss::col_t, std::size_t) override {}
+
+    virtual void set_format(ss::row_t, ss::col_t, ss::row_t, ss::col_t, std::size_t) override {}
+
+    virtual void set_column_format(ss::col_t, ss::col_t, std::size_t) override {}
+
+    virtual void set_row_format(ss::col_t, std::size_t) override {}
+
+    virtual void fill_down_cells(ss::row_t, ss::col_t, ss::row_t) override {}
+};
+
+//!code-start: my_shared_strings
+class my_shared_strings : public ss::iface::import_shared_strings
+{
+    ss_hash_type m_ss_hash;
+    ss_type& m_ss;
+    std::string m_current_string;
+
+public:
+    my_shared_strings(ss_type& ss) : m_ss(ss) {}
+
+    virtual std::size_t add(std::string_view s) override
+    {
+        auto it = m_ss_hash.find(s);
+        if (it != m_ss_hash.end())
+            // This string already exists in the pool.
+            return it->second;
+
+        // This is a brand-new string.
+        return append(s);
+    }
+
+    virtual std::size_t append(std::string_view s) override
+    {
+        std::size_t string_index = m_ss.size();
+        m_ss.emplace_back(s);
+        m_ss_hash.emplace(s, string_index);
+
+        return string_index;
+    }
+
+    // The following methods are for formatted text segments, which we ignore for now.
+    virtual void set_segment_bold(bool) override {}
+
+    virtual void set_segment_font(std::size_t) override {}
+
+    virtual void set_segment_font_color(
+        ss::color_elem_t,
+        ss::color_elem_t,
+        ss::color_elem_t,
+        ss::color_elem_t) override {}
+
+    virtual void set_segment_font_name(std::string_view) override {}
+
+    virtual void set_segment_font_size(double) override {}
+
+    virtual void set_segment_italic(bool) override {}
+
+    virtual void append_segment(std::string_view s) override
+    {
+        m_current_string += s;
+    }
+
+    virtual std::size_t commit_segments() override
+    {
+        std::size_t string_index = m_ss.size();
+        m_ss.push_back(std::move(m_current_string));
+
+        const std::string& s = m_ss.back();
+        std::string_view sv(s.data(), s.size());
+        m_ss_hash.emplace(sv, string_index);
+
+        return string_index;
+    }
+};
+//!code-end: my_shared_strings
+
+//!code-start: my_import_factory
+class my_import_factory : public ss::iface::import_factory
+{
+    ss_type m_string_pool; // string pool to be shared everywhere.
+    my_shared_strings m_shared_strings;
+    std::vector<std::unique_ptr<my_sheet>> m_sheets;
+
+public:
+    my_import_factory() : m_shared_strings(m_string_pool) {}
+
+    virtual ss::iface::import_shared_strings* get_shared_strings() override
+    {
+        return &m_shared_strings;
+    }
+
+    virtual ss::iface::import_sheet* append_sheet(ss::sheet_t, std::string_view) override
+    {
+        // Pass the string pool to each sheet instance.
+        m_sheets.push_back(std::make_unique<my_sheet>(m_sheets.size(), m_string_pool));
+        return m_sheets.back().get();
+    }
+
+    virtual ss::iface::import_sheet* get_sheet(std::string_view) override
+    {
+        // TODO : implement this.
+        return nullptr;
+    }
+
+    virtual ss::iface::import_sheet* get_sheet(ss::sheet_t sheet_index) override
+    {
+        ss::sheet_t sheet_count = m_sheets.size();
+        return sheet_index < sheet_count ? m_sheets[sheet_index].get() : nullptr;
+    }
+
+    virtual void finalize() override {}
+};
+//!code-end: my_import_factory
+
+int main()
+{
+    std::filesystem::path input_dir = std::getenv("INPUTDIR");
+    auto filepath = input_dir / "multi-sheets.ods";
+
+    my_import_factory factory;
+    orcus::orcus_ods loader(&factory);
+    loader.read_file(filepath.native());
+
+    return EXIT_SUCCESS;
+}
diff --git a/doc_example/xml_mapping_1.cpp b/doc_example/xml_mapping_1.cpp
new file mode 100644
index 0000000..33d6ff2
--- /dev/null
+++ b/doc_example/xml_mapping_1.cpp
@@ -0,0 +1,129 @@
+
+#include <orcus/xml_namespace.hpp>
+
+#include <iostream>
+
+using namespace orcus;
+using namespace std;
+
+void run_xmlns_example()
+{
+    // A namespace repository is a shared storage for namespace strings for
+    // multiple contexts.  The client code needs to simply create an instance
+    // from which to create contexts.
+    xmlns_repository ns_repo;
+
+    xmlns_context ns_cxt = ns_repo.create_context();
+
+    // Push namespaces with their aliases as you counter them.  The push()
+    // method then returns an identifier associated with the alias.
+
+    // empty alias is for default namespace.  You can either use nullptr or an
+    // empty string.
+    xmlns_id_t ns_default = ns_cxt.push(
+        std::string_view{}, "http://schemas.openxmlformats.org/spreadsheetml/2006/main");
+
+    xmlns_id_t ns_a = ns_cxt.push(
+        "a", "http://schemas.openxmlformats.org/drawingml/2006/main");
+
+    xmlns_id_t ns_r = ns_cxt.push(
+        "r", "http://schemas.openxmlformats.org/officeDocument/2006/relationships");
+
+    // You can retrieve the data associated with alias ID's.
+    for (const xmlns_id_t nsid : {ns_default, ns_a, ns_r})
+    {
+        std::string_view alias = ns_cxt.get_alias(nsid);
+        cout << "Namespace alias '" << alias << "' has an index of " << ns_cxt.get_index(nsid)
+            << " and a short name of '" << ns_cxt.get_short_name(nsid) << "'." << endl;
+        cout << "The value of the alias '" << alias << "' is '" << ns_cxt.get(alias) << "'." << endl;
+    }
+
+    // Iterate over all namespaces in the current context.
+    for (const xmlns_id_t nsid : ns_cxt.get_all_namespaces())
+        cout << "'" << ns_cxt.get_alias(nsid) << "' = " << ns_cxt.get_short_name(nsid) << endl;
+}
+
+void run_xmlns_stacked()
+{
+    xmlns_repository ns_repo;
+    xmlns_context ns_cxt = ns_repo.create_context();
+
+    // Push a first default namespace.
+    xmlns_id_t ns_default_1 = ns_cxt.push(std::string_view{}, "http://original");
+
+    // Push a nested deffault namespace.  This overwrites the original.
+    xmlns_id_t current_default_ns = ns_cxt.push(std::string_view{}, "http://nested");
+    cout << "same as original: " << (current_default_ns == ns_default_1) << endl;
+
+    // Pop the current default namespace.  After this the original namespace
+    // becomes the default namespace again.
+    ns_cxt.pop(std::string_view{});
+
+    // Get the current default namespace identifier.
+    current_default_ns = ns_cxt.get(std::string_view{});
+    cout << "same as original: " << (current_default_ns == ns_default_1) << endl;
+}
+
+void run_xmlns_same_ns_different_aliases()
+{
+    xmlns_repository ns_repo;
+
+    // Same namespace URI may be associated with different aliases in different
+    // contexts.
+
+    xmlns_id_t alias_1, alias_2;
+    {
+        xmlns_context ns_cxt = ns_repo.create_context();
+        alias_1 = ns_cxt.push("foo", "http://some-namespace");
+
+        for (const xmlns_id_t nsid : ns_cxt.get_all_namespaces())
+            cout << "'" << ns_cxt.get_alias(nsid) << "' = " << ns_cxt.get_short_name(nsid) << endl;
+    }
+
+    {
+        xmlns_context ns_cxt = ns_repo.create_context();
+        alias_2 = ns_cxt.push("bar", "http://some-namespace");
+
+        for (const xmlns_id_t nsid : ns_cxt.get_all_namespaces())
+            cout << "'" << ns_cxt.get_alias(nsid) << "' = " << ns_cxt.get_short_name(nsid) << endl;
+    }
+
+    cout << (alias_1 == alias_2 ? "same" : "different") << endl;
+}
+
+void run_xmlns_different_ns_same_alias()
+{
+    xmlns_repository ns_repo;
+
+    // Same alias may be associated with different namespace URI's in different
+    // contexts.
+
+    xmlns_id_t alias_1, alias_2;
+    {
+        xmlns_context ns_cxt = ns_repo.create_context();
+        alias_1 = ns_cxt.push("foo", "http://namespace-1");
+
+        for (const xmlns_id_t nsid : ns_cxt.get_all_namespaces())
+            cout << "'" << ns_cxt.get_alias(nsid) << "' = " << ns_cxt.get_short_name(nsid) << endl;
+    }
+
+    {
+        xmlns_context ns_cxt = ns_repo.create_context();
+        alias_2 = ns_cxt.push("foo", "http://namespace-2");
+
+        for (const xmlns_id_t nsid : ns_cxt.get_all_namespaces())
+            cout << "'" << ns_cxt.get_alias(nsid) << "' = " << ns_cxt.get_short_name(nsid) << endl;
+    }
+
+    cout << (alias_1 == alias_2 ? "same" : "different") << endl;
+}
+
+int main()
+{
+    run_xmlns_example();
+    run_xmlns_stacked();
+    run_xmlns_same_ns_different_aliases();
+    run_xmlns_different_ns_same_alias();
+
+    return EXIT_SUCCESS;
+}