From owner-freebsd-doc@freebsd.org Tue Dec 18 09:12:50 2018 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id B8B6E134845B for ; Tue, 18 Dec 2018 09:12:50 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mailman.ysv.freebsd.org (mailman.ysv.freebsd.org [IPv6:2001:1900:2254:206a::50:5]) by mx1.freebsd.org (Postfix) with ESMTP id 53AF788AE0 for ; Tue, 18 Dec 2018 09:12:50 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: by mailman.ysv.freebsd.org (Postfix) id 16BBD134845A; Tue, 18 Dec 2018 09:12:50 +0000 (UTC) Delivered-To: doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id E84221348459 for ; Tue, 18 Dec 2018 09:12:49 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.ysv.freebsd.org (mxrelay.ysv.freebsd.org [IPv6:2001:1900:2254:206a::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.ysv.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 85CDB88ADE for ; Tue, 18 Dec 2018 09:12:49 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2001:1900:2254:206a::16:76]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.ysv.freebsd.org (Postfix) with ESMTPS id DA9A2ADD0 for ; Tue, 18 Dec 2018 09:12:48 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.118]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id wBI9Cmh1008495 for ; Tue, 18 Dec 2018 09:12:48 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id wBI9Cmpo008487 for doc@FreeBSD.org; Tue, 18 Dec 2018 09:12:48 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 234120] inconsistent documentation build description, bugs in .XML: can not build docs Date: Tue, 18 Dec 2018 09:12:48 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Documentation X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Many People X-Bugzilla-Who: ohartmann@walstatt.org X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: doc@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status bug_severity priority component assigned_to reporter Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated MIME-Version: 1.0 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 18 Dec 2018 09:12:51 -0000 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.=