You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Rick Hillegas (JIRA)" <ji...@apache.org> on 2010/11/09 18:43:07 UTC
[jira] Created: (DERBY-4896) Would like more detail on what
PlanExporter means by the term "advanced"
Would like more detail on what PlanExporter means by the term "advanced"
------------------------------------------------------------------------
Key: DERBY-4896
URL: https://issues.apache.org/jira/browse/DERBY-4896
Project: Derby
Issue Type: Improvement
Components: Documentation
Affects Versions: 10.7.1.0
Reporter: Rick Hillegas
1) The PlanExporter documentation uses the term "advanced style sheets". It would good to say something more about what we mean by "advanced". Does "advanced" just mean that the style sheet can contain javascript? If so, it would be good to say so.
2) Derby supplies two "advanced" style sheets. I think it is worth saying something about what these style sheets do for you. Perhaps something as simple as this: "Derby supplies two advanced style sheets which use javascript to expand and collapse the details of query plan nodes."
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (DERBY-4896) Would like more detail on what
PlanExporter means by the term "advanced"
Posted by "Bryan Pendleton (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4896?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12930422#action_12930422 ]
Bryan Pendleton commented on DERBY-4896:
----------------------------------------
Perhaps "alternate" would be better than "advanced"? I think the basic notion is that
you can use the style sheets that are pre-packaged with Derby, or you can write
your own. I don't think we place any restrictions on what you can put in your style
sheets, so they can be as simple or as advanced as you wish.
> Would like more detail on what PlanExporter means by the term "advanced"
> ------------------------------------------------------------------------
>
> Key: DERBY-4896
> URL: https://issues.apache.org/jira/browse/DERBY-4896
> Project: Derby
> Issue Type: Improvement
> Components: Documentation
> Affects Versions: 10.7.1.0
> Reporter: Rick Hillegas
>
> 1) The PlanExporter documentation uses the term "advanced style sheets". It would good to say something more about what we mean by "advanced". Does "advanced" just mean that the style sheet can contain javascript? If so, it would be good to say so.
> 2) Derby supplies two "advanced" style sheets. I think it is worth saying something about what these style sheets do for you. Perhaps something as simple as this: "Derby supplies two advanced style sheets which use javascript to expand and collapse the details of query plan nodes."
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (DERBY-4896) Would like more detail on what
PlanExporter means by the term "advanced"
Posted by "Rick Hillegas (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4896?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12930595#action_12930595 ]
Rick Hillegas commented on DERBY-4896:
--------------------------------------
Thanks for that quick response, Bryan. If "advanced" just means "alternate", does that mean that there is no longer any need for the -adv switch? The documentation in the Tools guide (http://db.apache.org/derby/docs/dev/tools/tools-single.html#ctoolsusingplanexp) indicates that you can you an alternate style sheet by specifying these switches:
-xsl $styleSheet -html $htmlOutput
It goes on to say that you can generate advanced output by throwing an additional switch:
-adv -xsl $styleSheet -xml $xmlOutput
I notice that the following combination of switches gives me a usage diagnostic:
-xsl $styleSheet -xml $xmlOutput
So "advanced" may have something to do with whether you are generating html or xml output.
> Would like more detail on what PlanExporter means by the term "advanced"
> ------------------------------------------------------------------------
>
> Key: DERBY-4896
> URL: https://issues.apache.org/jira/browse/DERBY-4896
> Project: Derby
> Issue Type: Improvement
> Components: Documentation
> Affects Versions: 10.7.1.0
> Reporter: Rick Hillegas
>
> 1) The PlanExporter documentation uses the term "advanced style sheets". It would good to say something more about what we mean by "advanced". Does "advanced" just mean that the style sheet can contain javascript? If so, it would be good to say so.
> 2) Derby supplies two "advanced" style sheets. I think it is worth saying something about what these style sheets do for you. Perhaps something as simple as this: "Derby supplies two advanced style sheets which use javascript to expand and collapse the details of query plan nodes."
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (DERBY-4896) Would like more detail on what
PlanExporter means by the term "advanced"
Posted by "Bryan Pendleton (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4896?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12930626#action_12930626 ]
Bryan Pendleton commented on DERBY-4896:
----------------------------------------
This part of the tool seems like it could do with some cleanup. It feels like the argument
syntax is a bit muddled, and looking at the argument processing code it seems like
it could be simplified. The code seems to want to know more about the type of output
that is being produced than it should need to know.
Naively, it seems like all we ought to need to specify to the PlanExporter is "what plan to
export", "where to put it", and, optionally, "which stylesheet to run to emit the desired output".
For the time being, though (10.7), we should probably just try to document the current
behavior as clearly as we can, and we can refine the tool's behavior down the road.
> Would like more detail on what PlanExporter means by the term "advanced"
> ------------------------------------------------------------------------
>
> Key: DERBY-4896
> URL: https://issues.apache.org/jira/browse/DERBY-4896
> Project: Derby
> Issue Type: Improvement
> Components: Documentation
> Affects Versions: 10.7.1.0
> Reporter: Rick Hillegas
>
> 1) The PlanExporter documentation uses the term "advanced style sheets". It would good to say something more about what we mean by "advanced". Does "advanced" just mean that the style sheet can contain javascript? If so, it would be good to say so.
> 2) Derby supplies two "advanced" style sheets. I think it is worth saying something about what these style sheets do for you. Perhaps something as simple as this: "Derby supplies two advanced style sheets which use javascript to expand and collapse the details of query plan nodes."
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.