Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 27977 - Weird code listing numbering
Summary: Weird code listing numbering
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Gentoo Linux x86 Installation Guide (show other bugs)
Hardware: x86 Linux
: High trivial (vote)
Assignee: Docs Team
URL: http://www.gentoo.org/doc/en/gentoo-x...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2003-09-04 21:56 UTC by Kimmo Hovi
Modified: 2003-10-09 05:29 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments
guide.xsl.diff (guide.xsl.diff,3.75 KB, patch)
2003-09-08 20:48 UTC, Lars Weiler (RETIRED)
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Kimmo Hovi 2003-09-04 21:56:01 UTC
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.
Comment 1 Sven Vermeulen (RETIRED) gentoo-dev 2003-09-05 02:15:05 UTC
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 :) 
Comment 2 Lars Weiler (RETIRED) gentoo-dev 2003-09-08 20:48:43 UTC
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.
Comment 3 Sven Vermeulen (RETIRED) gentoo-dev 2003-10-09 05:29:26 UTC
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.