[Bug 234120] inconsistent documentation build description, bugs in .XML: can not build docs
bugzilla-noreply at freebsd.org
bugzilla-noreply at freebsd.org
Tue Dec 18 09:12:51 UTC 2018
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=234120
Bug ID: 234120
Summary: inconsistent documentation build description, bugs in
.XML: can not build docs
Product: Documentation
Version: Latest
Hardware: Any
OS: Any
Status: New
Severity: Affects Many People
Priority: ---
Component: Documentation
Assignee: doc at FreeBSD.org
Reporter: ohartmann at walstatt.org
Since a couple of months for now I try to build the documentation of FreeBSD
including PDF handbook and the web page. That is true for 12-CURRENT and now
13-CURRENT. Since then, I'm unable to build what is in /usr/doc!
Starting with what is explained to build the doc tree at
https://www.freebsd.org/doc/en/books/fdp-primer/doc-build-toolset.html
firt I do is to update /usr/doc, which targets to
# svn info
Path: .
Working Copy Root Path: /usr/doc
URL: https://svn.freebsd.org/doc/head
Relative URL: ^/head
Repository Root: https://svn.freebsd.org/doc
Repository UUID: c2e8774f-c49f-e111-b436-862b2bbc8956
Revision: 52695
Node Kind: directory
Schedule: normal
Last Changed Author: rcyu
Last Changed Rev: 52695
Last Changed Date: 2018-12-17 16:08:35 +0100 (Mon, 17 Dec 2018)
The following requirements (ports) are installed and up to date:
textproc/iso8879
textproc/docbook-xml
textproc/xhtml
and as a (mutual) prerequisit
textproc/docbook
textproc/docproj
textproc/docproj has options DBLATEX and FOP set, if that information matters,
too.
It doesn't matter whether I follow the instructions from here:
https://www.freebsd.org/doc/en/books/fdp-primer/
Chapter 2.
In /etc/make I've setup the following:
DOC_LANG=en_US.ISO8859-1 de_DE.ISO8859-1
FORMATS=html-split pdf
WEB_LANG=de_DE.ISO8859-1 en_US.ISO8859-1
and prepared as shown above, staring
cd /usr/doc
make all
results all the time in a hard error as shown below.
It doesn't matter whether I start at /usr/doc and issue make all or try,
following dumb and blunt the instructions in the primer mentioned above and try
building only the en_US handbook as web pages, the error always pops up.
I am wondering how people build the official website's documentation!
We need offsite and off-LAN/network documentation in a security environment and
I'd like to build fresh docs from the repository for that purpose.
[...]
egrep: chapters.ent: No such file or directory
env
XML_CATALOG_FILES="file:///usr/obj/usr/doc/en_US.ISO8859-1/books/handbook/catalog-cwd.xml
file:///usr/doc/en_US.ISO8859-1/share/xml/catalog.xml
file:///usr/doc/share/xml/catalog.xml file:///usr/local/share/xml/catalog"
/usr/local/bin/xmllint --nonet --noent --valid --dropdtd --xinclude
/usr/doc/en_US.ISO8859-1/books/handbook/book.xml > book.parsed.xml.tmp
warning: failed to load external entity
"/usr/doc/en_US.ISO8859-1/books/handbook/mirrors.xml.ftp.index.inc"
/usr/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml:100: parser error :
Failure to process entity chap.mirrors.ftp.index.inc
&chap.mirrors.ftp.index.inc;
^
/usr/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml:100: parser error :
Entity 'chap.mirrors.ftp.index.inc' not defined
&chap.mirrors.ftp.index.inc;
^
warning: failed to load external entity
"/usr/doc/en_US.ISO8859-1/books/handbook/mirrors.lastmod.inc"
/usr/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml:102: parser error :
Failure to process entity chap.mirrors.lastmod.inc
&chap.mirrors.lastmod.inc;
^
/usr/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml:102: parser error :
Entity 'chap.mirrors.lastmod.inc' not defined
&chap.mirrors.lastmod.inc;
^
warning: failed to load external entity
"/usr/doc/en_US.ISO8859-1/books/handbook/mirrors.xml.ftp.inc"
/usr/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml:104: parser error :
Failure to process entity chap.mirrors.ftp.inc
&chap.mirrors.ftp.inc;
^
/usr/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml:104: parser error :
Entity 'chap.mirrors.ftp.inc' not defined
&chap.mirrors.ftp.inc;
^
/usr/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml:506: parser error :
chunk is not well balanced
^
/usr/doc/en_US.ISO8859-1/books/handbook/book.xml:311: parser error : Failure to
process entity chap.mirrors
&chap.mirrors;
^
/usr/doc/en_US.ISO8859-1/books/handbook/book.xml:311: parser error : Entity
'chap.mirrors' not defined
&chap.mirrors;
^
warning: failed to load external entity
"/usr/doc/en_US.ISO8859-1/books/handbook/eresources.xml.www.index.inc"
/usr/doc/en_US.ISO8859-1/books/handbook/eresources/chapter.xml:2457: parser
error : Failure to process entity chap.eresources.www.index.inc
&chap.eresources.www.index.inc;
^
/usr/doc/en_US.ISO8859-1/books/handbook/eresources/chapter.xml:2457: parser
error : Entity 'chap.eresources.www.index.inc' not defined
&chap.eresources.www.index.inc;
^
warning: failed to load external entity
"/usr/doc/en_US.ISO8859-1/books/handbook/mirrors.lastmod.inc"
/usr/doc/en_US.ISO8859-1/books/handbook/eresources/chapter.xml:2459: parser
error : Failure to process entity chap.mirrors.lastmod.inc
&chap.mirrors.lastmod.inc;
^
/usr/doc/en_US.ISO8859-1/books/handbook/eresources/chapter.xml:2459: parser
error : Entity 'chap.mirrors.lastmod.inc' not defined
&chap.mirrors.lastmod.inc;
^
warning: failed to load external entity
"/usr/doc/en_US.ISO8859-1/books/handbook/eresources.xml.www.inc"
/usr/doc/en_US.ISO8859-1/books/handbook/eresources/chapter.xml:2461: parser
error : Failure to process entity chap.eresources.www.inc
&chap.eresources.www.inc;
^
/usr/doc/en_US.ISO8859-1/books/handbook/eresources/chapter.xml:2461: parser
error : Entity 'chap.eresources.www.inc' not defined
&chap.eresources.www.inc;
^
/usr/doc/en_US.ISO8859-1/books/handbook/eresources/chapter.xml:2464: parser
error : chunk is not well balanced
^
/usr/doc/en_US.ISO8859-1/books/handbook/book.xml:313: parser error : Failure to
process entity chap.eresources
&chap.eresources;
^
/usr/doc/en_US.ISO8859-1/books/handbook/book.xml:313: parser error : Entity
'chap.eresources' not defined
&chap.eresources;
^
*** Error code 1
Stop.
make[3]: stopped in /usr/doc/en_US.ISO8859-1/books/handbook
*** Error code 1
Stop.
--
You are receiving this mail because:
You are the assignee for the bug.
More information about the freebsd-doc
mailing list