Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Typos, long lines #119

Merged
merged 1 commit into from
Jun 22, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 21 additions & 10 deletions doc/book.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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>
Expand All @@ -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>
Expand Down