Warnings while building Tesseract related to man pages generation

[stefanCCS]

Current Behavior

I have tried to compile Tesseract Release 5.5.1.
While doing make I could see these errors belows.

1st: I assume this is not important for running tesseract afterwards, as it looks like "only" to be relevant for documentation - correct?
2nd: Maybe something I can do to avoid this?
(if needed, I can provide more more details ...)

...
  CXXLD    libtesseract_sse.la
  CXXLD    libtesseract.la
  CXXLD    tesseract
asciidoc -b docbook -d manpage -o - doc/combine_lang_model.1.asc | \
xsltproc --nonet -o doc/combine_lang_model.1 http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl -
<unknown>:1: SyntaxWarning: invalid escape sequence '\S'
<unknown>:1: SyntaxWarning: invalid escape sequence '\S'
I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
-:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
D DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
                                                                               ^
Note: Writing combine_lang_model.1
asciidoc -b docbook -d manpage -o - doc/combine_tessdata.1.asc | \
xsltproc --nonet -o doc/combine_tessdata.1 http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl -
<unknown>:1: SyntaxWarning: invalid escape sequence '\S'
<unknown>:1: SyntaxWarning: invalid escape sequence '\S'
I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
-:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
D DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
                                                                               ^
Note: Writing combine_tessdata.1
asciidoc -b docbook -d manpage -o - doc/dawg2wordlist.1.asc | \
...

Expected Behavior

No response

Suggested Fix

No response

tesseract -v

No response

Operating System

Ubuntu 24.04 Noble

Other Operating System

No response

uname -a

No response

Compiler

No response

CPU

No response

Virtualization / Containers

ESXi-8

Other Information

No response

[stweil]

1. Yes, it is only relevant for the documentation (man pages).
2. It works for me on Debian. All messages are warnings, so you can simply ignore them.

asciidoc -b docbook -d manpage -o - doc/combine_lang_model.1.asc | xsltproc --nonet -o doc/combine_lang_model.1 http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl -
I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
-:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
D DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
                                                                               ^
Note: Writing combine_lang_model.1

Which part of the pipeline throws the SyntaxWarning messages?

[stefanCCS]

Let me share some details:

• Here my complete logging from make, where this warning occurs:
  2025-08-20_09-47_make.log

This have been my commands:

git clone --branch 5.5.1 --depth 1 https://github.com/tesseract-ocr/tesseract.git tesseract-5.5.1
sudo apt update
sudo apt install automake ca-certificates g++ git libtool libleptonica-dev make pkg-config
sudo apt install --no-install-recommends asciidoc docbook-xsl xsltproc
sudo apt-get install libpango1.0-dev
cd tesseract-5.5.1
./autogen.sh
./configure
make
sudo make install
sudo ldconfig
make training
sudo make training-install

[stweil]

Try running asciidoc -b docbook -d manpage -o - doc/combine_lang_model.1.asc | xsltproc --nonet -o doc/combine_lang_model.1 http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl - from your Tesseract installation's root directory "tesseract-5.5.1". It should show the same messages.

Now run only asciidoc -b docbook -d manpage -o - doc/combine_lang_model.1.asc. Which messages does it produce?

[stefanCCS]

asciidoc -b docbook -d manpage -o - doc/combine_lang_model.1.asc | xsltproc --nonet -o doc/combine_lang_model.1 http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
<unknown>:1: SyntaxWarning: invalid escape sequence '\S'
<unknown>:1: SyntaxWarning: invalid escape sequence '\S'
Exception ignored in: <_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>
BrokenPipeError: [Errno 32] Broken pipe

2. (sorry for proving an image - somehow the XML output contains something which formats this comment here...)

--> are you interested in full output?

[amitdo]

Maybe we should use asciidoctor instead of asciidoc(-py).

https://github.com/asciidoctor/asciidoctor

https://github.com/asciidoc-py/asciidoc-py