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

2014-02-26 Thread Eric Sunshine
On Wed, Feb 26, 2014 at 11:13 AM, Leo R. Lundgren  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
> ASCIID

Doc target fails to parse user-manual.xml

2014-02-26 Thread Leo R. Lundgren
Hi,

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:

- Extracted the 1.9.0 source code from GitHub.
- Ran `make configure` as regular user.
- Ran `./configure --prefix=/usr/local` as regular user.
- Ran `make all` as regular user - this works fine.
- Ran `make doc` as regular user - the log from this is below.

- 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


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