First look at Guide update
Thomas Bullock
tbullock at nd.edu
Mon Aug 16 15:49:32 EDT 2010
John Ralls [mailto:jralls at ceridwen.us] writes:
OK, I've taken your wiki posting and run it through xmllint. The output (after reformating it for clarity) is
> (sect1info? ,
> (title , subtitle? , titleabbrev?) ,
> (toc | lot | index | glossary | bibliography)* ,
> (
> (
> (calloutlist | glosslist | itemizedlist | orderedlist | segmentedlist |
> simplelist | variablelist | caution | important | note | tip | warning |
> literallayout | programlisting | programlistingco | screen | screenco |
> screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis |
> fieldsynopsis | constructorsynopsis | destructorsynopsis |
> methodsynopsis | formalpara | para | simpara | address | blockquote |
> graphic | graphicco | mediaobject | mediaobjectco | informalequation |
> informalexample | informalfigure | informaltable | equation | example |
> figure | table | msgset | procedure | sidebar | qandaset | anchor |
> bridgehead | remark | highlights | abstract | authorblurb | epigraph |
> indexterm | beginpage)+,
> (refentry* | sect2* | simplesect*)
> ) |
> refentry+ | sect2+ | simplesect+),
> (toc | lot | index | glossary | bibliography)*
> ), got
> (title
> para
> para
> para
> para
> sect2 <- "BEGIN NEW CONTENT" is in the middle of this section
> sect2
> sect2
> sect2
> sect2 <- "SIGNIFICANT NEW CONTENT ENDS HERE" is at the end of this one.
> tip
> sect2
> tip
> sect2
> tip
> note
> sect2
> )
which pretty clearly shows the problem: You promoted those <tip> and <note> elements to the top level; they should have remained in the <sect2> elements that they were in originally. In every case, the </sect2> tag needs to be moved from just above to just below the offending elements, after which xmllint passes.
Regards,
John Ralls
[<<Tom>>: ] that's what I got too, except I did not format for clarity. What you seem to be saying is that tips and notes always have to be the last things in a section, or at least section2's.
I accept that you are saying it, but how did you figure that out from the xmllint output? I have not been able to find any DTD or equivalent that spells out the expected sequence. I realize that xmllint has access to that in order for it to work. Where do I find what xmllint is using?
And thanks very much for clearing up my problem. I will make the changes and proceed to setting up a bugzilla patch.
Tom
More information about the gnucash-devel
mailing list