You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by bo...@werken.com on 2003/02/04 17:15:15 UTC

[maven-bug] New comment: (MAVEN-233) Make xdoc's doc:performJSL tag reusable

The following comment has been added to this issue:

     Author: Ben Walding
    Created: Tue, 4 Feb 2003 10:15 AM
       Body:
To make things a bit more consistent, here are the tags we will have

doc:transformFile - will do a complete xdoc transformation on a single file and place it into target/docs

doc:performJSL - transforms a directory
doc:jsl - JSL transforms a file to default dir
doc:jslFile - JSL transforms a file to arbitrary dir
---------------------------------------------------------------------
View the issue:

  http://jira.werken.com/secure/ViewIssue.jspa?key=MAVEN-233


Here is an overview of the issue:
---------------------------------------------------------------------
        Key: MAVEN-233
    Summary: Make xdoc's doc:performJSL  tag reusable
       Type: Improvement

     Status: Assigned
   Priority: Major

 Time Spent: Unknown
   Estimate: 2 hours

    Project: maven
  Component: None

   Assignee: Ben Walding
   Reporter: Ben Walding

    Created: Thu, 30 Jan 2003 11:37 PM
    Updated: Mon, 3 Feb 2003 9:16 AM

Description:
At present, the doc:performJSL while available for use outside the xdoc plugin is not reusable.

It relies on the xdoc:jelly-transform having run before, to set up a couple of variables / beans (mapper / stylesheetURI).

Ideally, a plugin should be able to request a JSL transform on any document to fit into the site.  While in theory a plugin should just generate their xdoc into generated-xdocs, this may not be feasible (eg LinkCheck / TOC generator? / index generator?) due to the ordering of the goals.  

It seems counterproductive to force a full site generation just to transform a single file, when said file depends on the results of the full site generation.






---------------------------------------------------------------------
JIRA INFORMATION:
This message is automatically generated by JIRA.

If you think it was sent incorrectly contact one of the administrators:
   http://jira.werken.com/Administrators.jspa

If you want more information on JIRA, or have a bug to report see:
   http://www.atlassian.com/software/jira