[maven-bug] Created: (MAVEN-182) Improving Tasklist plugin parser - reducing sensitivity to javadoc quality

[bo...@werken.com]

Message:

  A new issue has been created in JIRA.

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

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


Here is an overview of the issue:
---------------------------------------------------------------------
        Key: MAVEN-182
    Summary: Improving Tasklist plugin parser - reducing sensitivity to javadoc quality
       Type: Improvement

     Status: Assigned
   Priority: Minor

 Time Spent: Unknown
   Estimate: 0 minutes

    Project: maven
  Component: None
   Versions:
             1.0-beta-7

   Assignee: Jason van Zyl
   Reporter: Nick Minutello

    Created: Mon, 30 Dec 2002 5:04 PM
    Updated: Mon, 30 Dec 2002 5:04 PM

Description:

Is it possible to improve the robustness of the tasklist generator - reduce its sensitivity and improve the error recovery?

It seems that the tasklist parser is very sensitive to formatting of the javadoc comments.

e.g. If you have 
/**
 *@task
 */

Instead of 

/**
 * @task
 */

It will give the error:
Non-fatal error while parsing file: E:\Projects\<snip>\RecordUpdateListener.java
[DEBUG] org.apache.maven.java.parser.ParseException: Encountered "@" at line 19, column 7.
Was expecting:
    <TEXT> ...

...and then parse no more of the document.

If the java source file starts with:

/**
 * Created by IntelliJ IDEA.
 * User: L_Fischer
 * Date: Oct 29, 2002
 * Time: 4:27:39 PM
 * To change this template use Options | File Templates.
 */

(ie a Javadoc comment), then it fails with the following error:

Non-fatal error while parsing file: E:\temp\<snip>\ChainListenerCallback.java
[DEBUG] org.apache.maven.java.parser.ParseException: Encountered "package" at line 8, column 1.
Was expecting one of:
    "abstract" ...
    "interface" ...
    "public" ...
    "strictfp" ...
    ";" ...
    "@" ...
    "*" ...
    <TEXT> ...
    "final" ...
    "class" ...

If the javadoc should contain a "**", the again, it will fail...


Regards,
Nick


---------------------------------------------------------------------
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

Re: [maven-bug] Created: (MAVEN-182) Improving Tasklist plugin parser - reducing sensitivity to javadoc quality

[Jason van Zyl <ja...@zenplex.com>]

On Mon, 2002-12-30 at 18:04, bob@werken.com wrote:
> Message:
> 
>   A new issue has been created in JIRA.
> 
> ---------------------------------------------------------------------
> View the issue:
> 
>   http://jira.werken.com/secure/ViewIssue.jspa?key=MAVEN-182
> 
> 
> Here is an overview of the issue:
> ---------------------------------------------------------------------
>         Key: MAVEN-182
>     Summary: Improving Tasklist plugin parser - reducing sensitivity to javadoc quality
>        Type: Improvement

Already done. We are using VDoclet, which uses QDox under the covers, so
the parser is much more robust.

> 
> jvz.
> 
> Jason van Zyl
> jason@zenplex.com
> http://tambora.zenplex.org
> 
> In short, man creates for himself a new religion of a rational
> and technical order to justify his work and to be justified in it.
>   
>   -- Jacques Ellul, The Technological Society