Subject: Re: [xsl] Are there stupid questions about documentation in xslt? From: "G. Ken Holman" <gkholman@xxxxxxxxxxxxxxxxxxxx> Date: Sun, 09 May 2010 15:02:15 -0400 |
<xsl:analyze-string select="." regex="{$regex}" doc="documenting this as an attribute because there is a really important reason why I'm doing this which I will never remember which is directly related to the analyze string function">
Clearly one cannot do this, well that I'm aware of but thought it might make for an interesting discussion if one can't.
I do document with xd:doc.. which is useful but not as localized as I would like and really kind of heavy on the screen real estate -- except for in the cases of documenting what a template or style sheet does in general. <xd:doc id="template" xmlns:xd="http://www.oxygenxml.com/ns/doc/xsl" scope="component"> <xd:desc> <xd:p>xsl:template match="conten".</xd:p> </xd:desc> </xd:doc>
<!-- --> should only be used to comment out code that one does not want in a document.
<?xslstyle documenting this as an attribute because there is a really important reason why I'm doing this which I will never remember which is directly related to the analyze string function?>
Let me know your thoughts
-- XSLT/XQuery training: after http://XMLPrague.cz 2011-03-28/04-01 Vote for your XML training: http://www.CraneSoftwrights.com/s/i/ Crane Softwrights Ltd. http://www.CraneSoftwrights.com/s/ G. Ken Holman mailto:gkholman@xxxxxxxxxxxxxxxxxxxx Male Cancer Awareness Nov'07 http://www.CraneSoftwrights.com/s/bc Legal business disclaimers: http://www.CraneSoftwrights.com/legal
Current Thread |
---|
|
<- Previous | Index | Next -> |
---|---|---|
Re: [xsl] Are there stupid question, Dimitre Novatchev | Thread | Re: [xsl] Are there stupid question, Alex Muir |
Re: [xsl] Are there stupid question, Dimitre Novatchev | Date | Re: [xsl] Are there stupid question, Alex Muir |
Month |