On 02/11/10 04:34, lomov.vl wrote:
Hi.
On Nov 1, 8:02 am, Stuart Rackham<[email protected]> wrote:
On 30/10/10 20:00, lomov.vl wrote:
Hi.
Changes from 882 to 883 revs of asciidoc break compilation of git
documentation. Below is extract from make ASCIIDOC8=YesPlease doc:
---------------------8<---------------------
$ make ASCIIDOC8=YesPlease doc
...
ASCIIDOC git-verify-tag.xml
XMLTO git-verify-tag.1
ASCIIDOC git-ls-tree.xml
XMLTO git-ls-tree.1
ASCIIDOC git-update-index.xml
XMLTO git-update-index.1
ASCIIDOC git-reset.xml
XMLTO git-reset.1
ASCIIDOC git-init.xml
XMLTO git-init.1
ASCIIDOC git-web--browse.xml
XMLTO git-web--browse.1
xmlto: $HOME/buildpkg/git/src/git-build/Documentation/git-web--
browse.xml does not validate (status 3)
xmlto: Fix document syntax or use --skip-validation option
$HOME/buildpkg/git/src/git-build/Documentation/git-web--browse.xml:6:
element refmeta: validity error : Element refmeta content does not
follow the DTD, expecting (indexterm* , refentrytitle , manvolnum? ,
refmiscinfo* , indexterm*), got (manvolnum refmiscinfo refmiscinfo
refmiscinfo )
Document $HOME/buildpkg/git/src/git-build/Documentation/git-web--
browse.xml does not validate
make[1]: *** [git-web--browse.1] Error 13
make[1]: `/home/lomov/buildpkg/git/src/git-build/
Documentation'
make: *** [doc] Error 2
---------------------8<---------------------
I downloaded git 1.7.3.2 and built git-web--browse.xml:
$ cd ~/tmp/git-1.7.3.2/Documentation
$ make git-web--browse.xml
I don't have xmlto(1) installed so I used xmllint(1) to validate and there were
no errors:
$ $ xmllint --noout git-web--browse.xml
I then ran a2x to generate git-web--browse.1:
$ a2x -dmanpage -fmanpage git-web--browse.xml
It ran without errors and the man page looked fine.
So I'm unable to recreate the error, would you be able to:
1. Verify you're on the latest version of the trunk (I was running against the
current latest, changeset: 896:9175f96d2fe5).
2. Post the git-web--browse.xml that generated the validation error.
I tried with two files (this is strange enough, because now document
compilation fails on git-mergetool--lib but this file also breaked
compilation of git documentation a while ago) and two revisions: 882
and 896 (896:9175f...)
882/git-mergetool--lib.xml : http://pastebin.ca/1978763
882/git-web--browse.xml : http://pastebin.ca/1978764
896/git-mergetool--lib.xml : http://pastebin.ca/1978765
896/git-web--browse.xml : http://pastebin.ca/1978767
From first view, 896 generates files without refentrytitle and that
exactly error message that xmlto shows.
I don't understand, I downloaded both your 896 files from pastebin and they
validate and generate manpages:
$ xmllint --noout git-mergetool--lib.xml
$ a2x -fmanpage -dmanpage git-mergetool--lib.xml
They both have refentrytitle elements.
Cheers, Stuart
---
WBR, Vladimir
--
You received this message because you are subscribed to the Google Groups
"asciidoc" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/asciidoc?hl=en.
