git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: Doc target fails to parse user-manual.xml

From
Eric Sunshine <sunshine@sunshineco.com>
Date
Feb 26, 2014, 20:31 UTC
Message-ID
<CAPig+cRWZzm3yZFUC9nEY5AONP+EtcfuROY_ToNDb5uYNFpYtA@mail.gmail.com>
In-Reply-To
<8244C605-810C-487A-8931-DBC15D4A3F2A@finalresort.org>
On Wed, Feb 26, 2014 at 11:13 AM, Leo R. Lundgren <leo@finalresort.org> wrote:
Show 28 quoted lines
> I'm installing git 1.9.0 from source, on a freshly installed SLES 11 SP3. The git binaries work fine to compile and install, but `make doc` fails on some XML parsing errors.
>
> The system is fully updated with the latest stable packages in the SLES 11 SP3 distribution. What I've done is:
>
> ----- 8< -----
>
> foo@bar:~> rpm -qa|grep xml
> libxml2-python-2.7.6-0.23.1
> php53-xmlwriter-5.3.17-0.13.7
> libxml2-2.7.6-0.23.1
> libxml2-32bit-2.7.6-0.23.1
> php53-xmlreader-5.3.17-0.13.7
> xmlcharent-0.3-403.14
> python-xml-2.6.8-0.15.1
> yast2-xml-2.16.1-1.23
>
> foo@bar:~> rpm -qa|grep doc
> docbook_4-4.5-111.14
> pam-doc-1.1.5-0.10.17
> perl-doc-5.10.0-64.67.52
> readline-doc-5.2-147.17.30
> docbook-xsl-stylesheets-1.78.1-0.7.17
> apparmor-docs-2.5.1.r1445-55.59.1
> asciidoc-8.2.7-29.21
> PolicyKit-doc-0.9-14.39.2
> nfs-doc-1.2.3-18.29.1
> bash-doc-3.2-147.17.30
> postgresql91-docs-9.1.9-0.3.1

Some of these packages are pretty old and possibly buggy. The documentation builds cleanly on my Linux and Mac boxes, but they are using newer versions of these tools. For instance, I have asciidoc 8.6.7 on Linux, and 8.6.9 on Mac, whereas your version is only at 8.2.7. Perhaps try updating your toolchain.

Show 223 quoted lines
> foo@bar:~/git-1.9.0> make doc
> make -C Documentation all
> make[1]: Entering directory `/home/foo/git-1.9.0/Documentation'
>     GEN mergetools-list.made
>     GEN cmd-list.made
>     GEN doc.dep
> make[2]: Entering directory `/home/foo/git-1.9.0'
> make[2]: `GIT-VERSION-FILE' is up to date.
> make[2]: Leaving directory `/home/foo/git-1.9.0'
> make[1]: Leaving directory `/home/foo/git-1.9.0/Documentation'
> make[1]: Entering directory `/home/foo/git-1.9.0/Documentation'
> make[2]: Entering directory `/home/foo/git-1.9.0'
> make[2]: `GIT-VERSION-FILE' is up to date.
> make[2]: Leaving directory `/home/foo/git-1.9.0'
>     ASCIIDOC git-add.html
>     ASCIIDOC git-am.html
>     ASCIIDOC git-annotate.html
>     ASCIIDOC git-apply.html
>     ASCIIDOC git-archimport.html
>     ASCIIDOC git-archive.html
>     ASCIIDOC git-bisect.html
>     ASCIIDOC git-blame.html
>     ASCIIDOC git-branch.html
>     ASCIIDOC git-bundle.html
>     ASCIIDOC git-cat-file.html
>     ASCIIDOC git-check-attr.html
>     ASCIIDOC git-check-ignore.html
>     ASCIIDOC git-check-mailmap.html
>     ASCIIDOC git-checkout-index.html
>     ASCIIDOC git-checkout.html
>     ASCIIDOC git-check-ref-format.html
>     ASCIIDOC git-cherry-pick.html
>     ASCIIDOC git-cherry.html
>     ASCIIDOC git-citool.html
>     ASCIIDOC git-clean.html
>     ASCIIDOC git-clone.html
>     ASCIIDOC git-column.html
>     ASCIIDOC git-commit-tree.html
>     ASCIIDOC git-commit.html
>     ASCIIDOC git-config.html
>     ASCIIDOC git-count-objects.html
>     ASCIIDOC git-credential-cache--daemon.html
>     ASCIIDOC git-credential-cache.html
>     ASCIIDOC git-credential-store.html
>     ASCIIDOC git-credential.html
>     ASCIIDOC git-cvsexportcommit.html
>     ASCIIDOC git-cvsimport.html
>     ASCIIDOC git-cvsserver.html
>     ASCIIDOC git-daemon.html
>     ASCIIDOC git-describe.html
>     ASCIIDOC git-diff-files.html
>     ASCIIDOC git-diff-index.html
>     ASCIIDOC git-difftool.html
>     ASCIIDOC git-diff-tree.html
>     ASCIIDOC git-diff.html
>     ASCIIDOC git-fast-export.html
>     ASCIIDOC git-fast-import.html
>     ASCIIDOC git-fetch-pack.html
>     ASCIIDOC git-fetch.html
>     ASCIIDOC git-filter-branch.html
>     ASCIIDOC git-fmt-merge-msg.html
>     ASCIIDOC git-for-each-ref.html
>     ASCIIDOC git-format-patch.html
>     ASCIIDOC git-fsck-objects.html
>     ASCIIDOC git-fsck.html
>     ASCIIDOC git-gc.html
>     ASCIIDOC git-get-tar-commit-id.html
>     ASCIIDOC git-grep.html
>     ASCIIDOC git-gui.html
>     ASCIIDOC git-hash-object.html
>     ASCIIDOC git-help.html
>     ASCIIDOC git-http-backend.html
>     ASCIIDOC git-http-fetch.html
>     ASCIIDOC git-http-push.html
>     ASCIIDOC git-imap-send.html
>     ASCIIDOC git-index-pack.html
>     ASCIIDOC git-init-db.html
>     ASCIIDOC git-init.html
>     ASCIIDOC git-instaweb.html
>     ASCIIDOC git-log.html
>     ASCIIDOC git-ls-files.html
>     ASCIIDOC git-ls-remote.html
>     ASCIIDOC git-ls-tree.html
>     ASCIIDOC git-mailinfo.html
>     ASCIIDOC git-mailsplit.html
>     ASCIIDOC git-merge-base.html
>     ASCIIDOC git-merge-file.html
>     ASCIIDOC git-merge-index.html
>     ASCIIDOC git-merge-one-file.html
>     ASCIIDOC git-mergetool--lib.html
>     ASCIIDOC git-mergetool.html
>     ASCIIDOC git-merge-tree.html
>     ASCIIDOC git-merge.html
>     ASCIIDOC git-mktag.html
>     ASCIIDOC git-mktree.html
>     ASCIIDOC git-mv.html
>     ASCIIDOC git-name-rev.html
>     ASCIIDOC git-notes.html
>     ASCIIDOC git-p4.html
>     ASCIIDOC git-pack-objects.html
>     ASCIIDOC git-pack-redundant.html
>     ASCIIDOC git-pack-refs.html
>     ASCIIDOC git-parse-remote.html
>     ASCIIDOC git-patch-id.html
>     ASCIIDOC git-prune-packed.html
>     ASCIIDOC git-prune.html
>     ASCIIDOC git-pull.html
>     ASCIIDOC git-push.html
>     ASCIIDOC git-quiltimport.html
>     ASCIIDOC git-read-tree.html
>     ASCIIDOC git-rebase.html
>     ASCIIDOC git-receive-pack.html
>     ASCIIDOC git-reflog.html
>     ASCIIDOC git-relink.html
>     ASCIIDOC git-remote-ext.html
> WARNING: git-remote-ext.txt: line 11: missing macro section: [ext]-inlinemacro
>     ASCIIDOC git-remote-fd.html
> WARNING: git-remote-fd.txt: line 10: missing macro section: [fd]-inlinemacro
>     ASCIIDOC git-remote-testgit.html
>     ASCIIDOC git-remote.html
>     ASCIIDOC git-repack.html
>     ASCIIDOC git-replace.html
>     ASCIIDOC git-request-pull.html
>     ASCIIDOC git-rerere.html
>     ASCIIDOC git-reset.html
>     ASCIIDOC git-revert.html
>     ASCIIDOC git-rev-list.html
>     ASCIIDOC git-rev-parse.html
>     ASCIIDOC git-rm.html
>     ASCIIDOC git-send-email.html
>     ASCIIDOC git-send-pack.html
>     ASCIIDOC git-shell.html
>     ASCIIDOC git-sh-i18n--envsubst.html
>     ASCIIDOC git-sh-i18n.html
>     ASCIIDOC git-shortlog.html
>     ASCIIDOC git-show-branch.html
>     ASCIIDOC git-show-index.html
>     ASCIIDOC git-show-ref.html
>     ASCIIDOC git-show.html
>     ASCIIDOC git-sh-setup.html
>     ASCIIDOC git-stage.html
>     ASCIIDOC git-stash.html
>     ASCIIDOC git-status.html
>     ASCIIDOC git-stripspace.html
>     ASCIIDOC git-submodule.html
>     ASCIIDOC git-svn.html
>     ASCIIDOC git-symbolic-ref.html
>     ASCIIDOC git-tag.html
>     ASCIIDOC git-unpack-file.html
>     ASCIIDOC git-unpack-objects.html
>     ASCIIDOC git-update-index.html
>     ASCIIDOC git-update-ref.html
>     ASCIIDOC git-update-server-info.html
>     ASCIIDOC git-upload-archive.html
>     ASCIIDOC git-upload-pack.html
>     ASCIIDOC git-var.html
>     ASCIIDOC git-verify-pack.html
>     ASCIIDOC git-verify-tag.html
>     ASCIIDOC git-web--browse.html
>     ASCIIDOC git-whatchanged.html
>     ASCIIDOC git-write-tree.html
>     ASCIIDOC git.html
>     ASCIIDOC gitk.html
>     ASCIIDOC gitremote-helpers.html
>     ASCIIDOC gitweb.html
>     ASCIIDOC gitattributes.html
>     ASCIIDOC githooks.html
>     ASCIIDOC gitignore.html
>     ASCIIDOC gitmodules.html
>     ASCIIDOC gitrepository-layout.html
>     ASCIIDOC gitweb.conf.html
>     ASCIIDOC gitcli.html
>     ASCIIDOC gitcore-tutorial.html
>     ASCIIDOC gitcredentials.html
>     ASCIIDOC gitcvs-migration.html
>     ASCIIDOC gitdiffcore.html
>     ASCIIDOC gitglossary.html
>     ASCIIDOC gitnamespaces.html
>     ASCIIDOC gitrevisions.html
>     ASCIIDOC gittutorial-2.html
>     ASCIIDOC gittutorial.html
>     ASCIIDOC gitworkflows.html
>     ASCIIDOC git-remote-helpers.html
>     GEN howto-index.txt
>     ASCIIDOC howto-index.html
>     ASCIIDOC everyday.html
>     ASCIIDOC git-tools.html
>     ASCIIDOC git-bisect-lk2009.html
>     ASCIIDOC user-manual.xml
>     XSLTPROC user-manual.html
> user-manual.xml:3774: parser error : Opening and ending tag mismatch: emphasis line 3774 and literal
>   char <emphasis role="strong"></literal>, but is actually expected to be a poin
>                                          ^
> user-manual.xml:3776: parser error : Opening and ending tag mismatch: literal line 3776 and emphasis
> mit.  Note that whenever a SHA-1 is passed as <literal>unsigned char </emphasis>
>                                                                                ^
> user-manual.xml:4538: parser error : Opening and ending tag mismatch: emphasis line 4538 and literal
> A leading "<literal><emphasis role="strong"></literal>" followed by a slash mean
>                                                       ^
> user-manual.xml:4539: parser error : Opening and ending tag mismatch: literal line 4539 and emphasis
>    directories. For example, "<literal></emphasis>/foo</literal>" matches file o
>                                                   ^
> user-manual.xml:4547: parser error : Opening and ending tag mismatch: emphasis line 4547 and literal
> A trailing "<literal>/<emphasis role="strong"></literal>" matches everything ins
>                                                         ^
> user-manual.xml:4548: parser error : Opening and ending tag mismatch: literal line 4548 and emphasis
>    "<literal>abc/</emphasis></literal>" matches all files inside directory "abc"
>                             ^
> unable to parse user-manual.xml
> make[1]: *** [user-manual.html] Error 6
> make[1]: Leaving directory `/home/foo/git-1.9.0/Documentation'
> make: *** [doc] Error 2
>
> ----- 8< -----
>
> It's not a huge issue for me, since I don't really need the docs on this system anyway, and the binaries work, but it would of course be nice if git compiled on a system like this since it's a rather common commercial distribution.
>
> I'd be happy to provide additional info if needed. Thanks!
>
> Regards, Leo--
> To unsubscribe from this list: send the line "unsubscribe git" in
> the body of a message to majordomo@vger.kernel.org
> More majordomo info at  http://vger.kernel.org/majordomo-info.html
Previous: Leo R. Lundgren
Message 2 of 2 in “Doc target fails to parse user-manual.xml”
  1. Leo R. LundgrenFeb 26, 2014
  2. Eric SunshineFeb 26, 2014

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.