Date: Tue, 18 Dec 2018 09:12:48 +0000 From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 234120] inconsistent documentation build description, bugs in .XML: can not build docs Message-ID: <bug-234120-9@https.bugs.freebsd.org/bugzilla/>
next in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D234120 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@FreeBSD.org Reporter: ohartmann@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=20 # 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 matte= rs, too. It doesn't matter whether I follow the instructions from here:=20 https://www.freebsd.org/doc/en/books/fdp-primer/ Chapter 2. In /etc/make I've setup the following: DOC_LANG=3Den_US.ISO8859-1 de_DE.ISO8859-1=20 FORMATS=3Dhtml-split pdf=20=20=20 WEB_LANG=3Dde_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.=20 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=3D"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=20 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 err= or : 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 err= or : 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 err= or : 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 err= or : 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 err= or : 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 err= or : Entity 'chap.mirrors.ftp.inc' not defined &chap.mirrors.ftp.inc; ^ /usr/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml:506: parser err= or : chunk is not well balanced ^ /usr/doc/en_US.ISO8859-1/books/handbook/book.xml:311: parser error : Failur= e 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 : Failur= e 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. --=20 You are receiving this mail because: You are the assignee for the bug.=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-234120-9>