The doc generation script seems to lose the chapter number from the code listing box number in a nested code listing box, making the numbers weird, e.g. from "3.1" to "3.2" to just ".3" Reproducible: Always Steps to Reproduce: 1. 2. 3.
Sadly this is a known issue :( I'm currently learning XSLT so we can have the numbering a little better (actually to get everything better :)
Created attachment 17306 [details, diff] guide.xsl.diff I did some XSLT-voodoo so that these errors could be fixed. Just apply the attached patch for the guide.xsl Following to our DTD you can call pre-elements in all the block-elements (like note, impo and warn) and also in tables and listings. The parameter has to be handed down to all the child-templates, so that the value doesn't become lost. That blows up the patch. The first entries in the patch are more "cosmetical" and - I would say - in a better XSLT-form.
I've fixed it in another way. What I was thinking was that code listings inside <warn>, <note> etc. aren't needed for full numbering, while code listings inside the real content of the document is. So i removed the first numbering. Also, code listings shouldn't be inside <warn> and <note>'s.