Re: 'Bug' in site.vsl

[dion]

> on 1/21/02 11:23 PM, "dion" <[EMAIL PROTECTED]> wrote:

> > Let me rephrase that. It expects it to be a direct child of either section or
> > subsection . See site.vsl line 143.

> Exactly. It was designed that way. What is your problem again?

> -jon

My problem was that I had produced some documentation that has it nested 
in a <p> in the HTML, and from the docs, I was expecting the <source> 
tag to be transformed into a box by the site.vsl. It wasn't. I posted my 
code.


At the moment site.vsl and site.xsl are producing different output. site.xsl works for 
me, site.vsl doesn't. I much prefer 
the behaviour of the xsl stylesheet. But I can see how it would be painful to do in 
site.vsl.

So, what's better? Documenting how <source> in site.vsl works and fixing 
site.xsl so it works the way the vsl does or just the docs?

Here's the patch to jakarta-site2/xdocs/site/jakarta-site-tags.xml to 
fix the documentation (attached). I don't currently have the karma to 
update it myself, or I would've already.

Thanks for your help, I hope the patch helps the next person that comes 
along from doing this  :-)

-- 
dIon Gillard, Multitask Consulting
http://www.multitask.com.au/developers


Index: xdocs/site/jakarta-site-tags.xml
===================================================================
RCS file: /home/cvs/jakarta-site2/xdocs/site/jakarta-site-tags.xml,v
retrieving revision 1.1
diff -u -r1.1 jakarta-site-tags.xml
--- xdocs/site/jakarta-site-tags.xml    9 Jul 2001 18:14:33 -0000       1.1
+++ xdocs/site/jakarta-site-tags.xml    22 Jan 2002 09:18:19 -0000
@@ -141,7 +141,8 @@
     &lt;ol&gt; and &lt;ul&gt; tags can be embedded as is.
     </li>
     <li>
-    &lt;source&gt; tags are special. If you are embedding other
+    &lt;source&gt; tags are special. &lt;source&gt; tags are only embedded
+    within &lt;section&gt; and &lt;subsection&gt; tags. If you are embedding other
     XML/XHTML markup within the source tags, then you need to place a
     CDATA section within the source section. Example:<strong>
     &lt;source&gt;&lt;![CDATA[ content here &lt;a



--
To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>