The following comment has been added to this issue:

     Author: Basil Vandegriend
    Created: Thu, 29 May 2003 4:19 PM
       Body:
I obtained performance measurements for xDoclet when the check is disabled for if the 
template is newer than the generated file.

The measurements show a 15-25% reduction in time taken to do a generation  when there 
is nothing out-of-date to generate.

To implement the change, I simply modified GenerationManager.java in the xdoclet 
package.  The easiest place to add the option switch is in TemplateSubTask, but it may 
make more sense to add the option to DocletTask and then pass it into the 
TemplateSubTask (which is passed into the GenerationManager).

---------------------------------------------------------------------
View the issue:

  http://opensource.atlassian.com/projects/xdoclet/secure/ViewIssue.jspa?key=XDT-504


Here is an overview of the issue:
---------------------------------------------------------------------
        Key: XDT-504
    Summary: Option to disable checking template files when determining if generation 
is needed
       Type: Improvement

     Status: Assigned
   Priority: Major

 Time Spent: Unknown
   Estimate: 0 minutes

    Project: XDoclet
 Components: 
             Core

   Assignee: xdoclet-devel (Use for new issues)
   Reporter: Basil Vandegriend

    Created: Thu, 29 May 2003 10:33 AM
    Updated: Thu, 29 May 2003 10:33 AM

Description:
Currently, as part of the process to determine if generation is necessary for a given 
file w.r.t a given template, xDoclet checks to see if the template is newer than the 
generated file.

Since one template can include (merge) other templates, there is some complex code to 
check all the merged templates to make sure that none of them are newer than the 
generated file.  

This check causes several problems:
1. The code has defects which arise in particular circumstances.  XDT-502 and XDT-349 
are two defects that I'm aware of in particular.
2. I believe that this check is a significant performance hit.

Therefore, my suggestion is that there be an option (perhaps in DocletTask) to disable 
checking if the template(s) are newer than the generated file.  This check is really 
only useful anyways if one is developing templates, or upgrades xDoclet.  Otherwise, 
for everyday use by regular (non-xdoclet) developers, it is not necessary to do this 
check.



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

If you think it was sent incorrectly contact one of the administrators:
   http://opensource.atlassian.com/projects/xdoclet/Administrators.jspa

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



-------------------------------------------------------
This SF.net email is sponsored by: eBay
Get office equipment for less on eBay!
http://adfarm.mediaplex.com/ad/ck/711-11697-6916-5
_______________________________________________
xdoclet-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/xdoclet-devel

Reply via email to