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