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

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Wed, Feb 26, 2014 at 11:13 AM, Leo R. Lundgren <leo@xxxxxxxxxxxxxxx> wrote:
> 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.

> 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@xxxxxxxxxxxxxxx
> More majordomo info at  http://vger.kernel.org/majordomo-info.html
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html




[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]