On 09/11/10 02:00, lomov.vl wrote:
Hi.
On Nov 8, 11:48 am, Stuart Rackham<[email protected]> wrote:
On 02/11/10 04:34, lomov.vl wrote:
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.
I don't trust my eyes :)
$ diff -Naur 197876{3,5}.xml
--- 1978763.xml 2010-11-08 20:51:31.000000000 +0800
+++ 1978765.xml 2010-11-08 20:51:10.000000000 +0800
@@ -4,7 +4,6 @@
<?asciidoc-numbered?>
<refentry>
<refmeta>
-<refentrytitle>git-mergetool--lib</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="source">Git</refmiscinfo>
<refmiscinfo class="version">1.7.3.2.146.gca209</refmiscinfo>
Now I don't understand.
I'm know a little about xml but this message:
[quote]
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
[/quote]
and the diff clearly says that xml is malformed! The refmeta MUST have
refentrytitle. If this tag there is somewhere in document further
doesn't concern this error message.
I'm still not clear on this, do we still have a problem with the AsciiDoc
output?
Cheers, Stuart
---
WBR, Vladimir Lomov.
--
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.
