From a3df68c525be5a2e178c6627d2f5fef88bf467b8 Mon Sep 17 00:00:00 2001
From: Jakub Skoczen <jakub@indexdata.com>
Date: Sat, 22 Jun 2024 19:11:19 +0200
Subject: [PATCH 1/2] Vscode XML editor settings

---
 .vscode/settings.json | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/.vscode/settings.json b/.vscode/settings.json
index 4b6c9976..84d6d2b7 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -4,5 +4,7 @@
         "sonarlint.pathToCompileCommands": "${workspaceFolder}/.vscode/compile_commands.json",
         "files.associations": {
                 "__locale": "c"
-        }
+        },
+        "xml.symbols.maxItemsComputed": 10000,
+        "xml.validation.resolveExternalEntities": true
 }

From 5263d57757507c73c7fdb32f388bc2cd98ba857f Mon Sep 17 00:00:00 2001
From: Jakub Skoczen <jakub@indexdata.com>
Date: Sat, 22 Jun 2024 19:45:29 +0200
Subject: [PATCH 2/2] Typos, long lines

---
 doc/book.xml | 31 +++++++++++++++++++++----------
 1 file changed, 21 insertions(+), 10 deletions(-)

diff --git a/doc/book.xml b/doc/book.xml
index d4623e57..c5762a71 100644
--- a/doc/book.xml
+++ b/doc/book.xml
@@ -849,8 +849,8 @@
      <para>
        Install Apple's Xcode Command Line Tools package from <ulink url="https://developer.apple.com/">Apple Developer</ulink>
        which provides necessary tools for building C/C++ programs on macOS.
-       This is sufficient for compiling &yaz; from a source distribution tarball
-       as macOS already includes libxml and libxslt development libraries.
+       This is sufficient for compiling basic &yaz; (e.g no ICU) from a source distribution tarball
+       as XCLT includes libxml2 and libxslt development headers.
      </para>
      <para>
        If you are compiling &yaz; from a Git checkout, at the time of writing the latest
@@ -866,7 +866,8 @@
        Note: XCLT 15.4 fails to make  <code>gm4</code> available as <code>m4</code> which can cause a silent Bison failure, one
        way to fix it is:
        <screen>
-         sudo ln -s /Library/Developer/CommandLineTools/usr/bin/gm4 /Library/Developer/CommandLineTools/usr/bin/m4
+         sudo ln -s /Library/Developer/CommandLineTools/usr/bin/gm4 \
+           /Library/Developer/CommandLineTools/usr/bin/m4
        </screen>
        Additionally, you will need to install DocBook stylesheets to generate documentation:
        <screen>
@@ -876,26 +877,36 @@
        <screen>
          export XML_CATALOG_FILES="/opt/homebrew/etc/xml/catalog"
        </screen>
-       If you want to compile &yaz; with ICU you must install it with Homebrew as macOS does not ship ICU headers:
+       If you want to compile &yaz; with ICU you must install it with Homebrew as XCLT does not ship with ICU headers:
        <screen>
          brew install icu4c
        </screen>
        and make sure to add compiler flags before the configure stage, per the caveats section (<code>brew info icu4c</code>):
        <screen>
          export LDFLAGS="-L/opt/homebrew/opt/icu4c/lib"
-         export CPPFLAGS="-I/opt/homebrew/opt/icu4c/include
-         export PKG_CONFIG_PATH="/opt/homebrew/opt/icu4c/lib/pkgconfig""
+         export CPPFLAGS="-I/opt/homebrew/opt/icu4c/include"
+         export PKG_CONFIG_PATH="/opt/homebrew/opt/icu4c/lib/pkgconfig"
        </screen>
        If you want to also compile with more recent version of libxml2 and libxslt,
        install them with Homebrew:
        <screen>
          brew install libxml2 libxslt
-       </screen> 
+       </screen>
        and again make sure to add compiler flags, per the caveats section (<code>brew info libxml2</code>):
        <screen>
-        export LDFLAGS="-L/opt/homebrew/opt/libxml2/lib -L/opt/homebrew/opt/libxslt/lib -L/opt/homebrew/opt/icu4c/lib"
-        export CPPFLAGS="-I/opt/homebrew/opt/libxml2/include -I/opt/homebrew/opt/libxslt/include -I/opt/homebrew/opt/icu4c/include"
-        export PKG_CONFIG_PATH="/opt/homebrew/opt/libxml2/lib/pkgconfig:/opt/homebrew/opt/libxslt/lib/pkgconfig:/opt/homebrew/opt/icu4c/lib/pkgconfig"
+         export PATH="/opt/homebrew/opt/bison/bin:\
+         /opt/homebrew/opt/libxml2/bin:\
+         /opt/homebrew/opt/libxslt/bin:\
+         $PATH"
+         export LDFLAGS="-L/opt/homebrew/opt/libxml2/lib \
+         -L/opt/homebrew/opt/libxslt/lib \
+         -L/opt/homebrew/opt/icu4c/lib"
+         export CPPFLAGS="-I/opt/homebrew/opt/libxml2/include \
+         -I/opt/homebrew/opt/libxslt/include \
+         -I/opt/homebrew/opt/icu4c/include"
+         export PKG_CONFIG_PATH="/opt/homebrew/opt/libxml2/lib/pkgconfig:\
+         /opt/homebrew/opt/libxslt/lib/pkgconfig:\
+         /opt/homebrew/opt/icu4c/lib/pkgconfig"
        </screen>
        Then configure and conpile with:
        <screen>