[ 
https://issues.apache.org/jira/browse/XALANJ-2556?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13250138#comment-13250138
 ] 

Steven J. Hathaway commented on XALANJ-2556:
--------------------------------------------

XALANJ-2556 JavaDoc Comments

Related Files:  Needs Confirmation -- Identify needed comment changes

templates/ElemApplyImport.java:   * @param transformer non-null reference to 
the the current transform-time state.
templates/ElemApplyTemplates.java:   * @param transformer non-null reference to 
the the current transform-time state.
templates/ElemApplyTemplates.java:   * @param transformer non-null reference to 
the the current transform-time state.
templates/ElemAttribute.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemAttribute.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemAttributeSet.java:   * @param transformer non-null reference to 
the the current transform-time state.
templates/ElemCallTemplate.java:   * @param transformer non-null reference to 
the the current transform-time state.
templates/ElemChoose.java:   * @param transformer non-null reference to the the 
current transform-time state.
templates/ElemComment.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemCopy.java:   * @param transformer non-null reference to the the 
current transform-time state.
templates/ElemCopyOf.java:   * @param transformer non-null reference to the the 
current transform-time state.
templates/ElemElement.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemElement.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemExtensionCall.java:   * @param transformer non-null reference to 
the the current transform-time state.
templates/ElemExtensionCall.java:   * @param transformer non-null reference to 
the the current transform-time state.
templates/ElemExtensionCall.java:   * @param transformer non-null reference to 
the the current transform-time state.
templates/ElemFallback.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemFallback.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemForEach.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemForEach.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemIf.java:   * @param transformer non-null reference to the the 
current transform-time state.
templates/ElemLiteralResult.java:   * @param transformer non-null reference to 
the the current transform-time state.
templates/ElemMessage.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemNumber.java:   * @param transformer non-null reference to the the 
current transform-time state.
templates/ElemNumber.java:   * @param transformer non-null reference to the the 
current transform-time state.
templates/ElemNumber.java:   * @param transformer non-null reference to the the 
current transform-time state.
templates/ElemNumber.java:   * @param transformer non-null reference to the the 
current transform-time state.
templates/ElemNumber.java:   * @param transformer non-null reference to the the 
current transform-time state.
templates/ElemNumber.java:   * @param transformer non-null reference to the the 
current transform-time state.
templates/ElemParam.java:   * @param transformer non-null reference to the the 
current transform-time state.
templates/ElemPI.java:   * @param transformer non-null reference to the the 
current transform-time state.
templates/ElemTemplateElement.java:   * @param transformer non-null reference 
to the the current transform-time state.
templates/ElemTemplateElement.java:   * @param transformer non-null reference 
to the the current transform-time state.
templates/ElemTemplateElement.java:   * @param transformer non-null reference 
to the the current transform-time state.
templates/ElemTemplateElement.java:   * @param transformer non-null reference 
to the the current transform-time state.
templates/ElemTemplate.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemTextLiteral.java:   * @param transformer non-null reference to 
the the current transform-time state.
templates/ElemUnknown.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemUnknown.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemUse.java:   * @param transformer non-null reference to the the 
current transform-time state.
templates/ElemUse.java:   * @param transformer non-null reference to the the 
current transform-time state.
templates/ElemUse.java:   * @param transformer non-null reference to the the 
current transform-time state.
templates/ElemValueOf.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemVariable.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemVariable.java:   * @param transformer non-null reference to the 
the current transform-time state.
templates/ElemVariablePsuedo.java:   * @param transformer non-null reference to 
the the current transform-time state.
templates/ElemWithParam.java:   * @param transformer non-null reference to the 
the current transform-time state.

                
> Inconsistent Javadoc comment and code for execute(TransformerImpl) in 
> org.apache.xalan.templates.ElemFallback
> -------------------------------------------------------------------------------------------------------------
>
>                 Key: XALANJ-2556
>                 URL: https://issues.apache.org/jira/browse/XALANJ-2556
>             Project: XalanJ2
>          Issue Type: Bug
>      Security Level: No security risk; visible to anyone(Ordinary problems in 
> Xalan projects.  Anybody can view the issue.) 
>    Affects Versions: 2.7.1, 2.7
>         Environment: Platform Independent
>            Reporter: SHIN HWEI TAN
>              Labels: javadoc
>   Original Estimate: 0.05h
>  Remaining Estimate: 0.05h
>
> The Javadoc comment below states that the parameter transformer is a 
> "non-null reference to the the current transform-time state.":
>  /**
>   ...
>   * @param transformer non-null reference to the the current transform-time 
> state.
>   ...
>   */
> public void execute(TransformerImpl transformer) throws TransformerException
> However, the method does not check the parameter for "null". It executes 
> normally without throwing any exception when called with a null transformer. 
> Suggested Fixes:
> 1. Add parameter check for "null"
> or
> 2. Remove "non-null" from @param.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: 
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe, e-mail: xalan-dev-unsubscr...@xml.apache.org
For additional commands, e-mail: xalan-dev-h...@xml.apache.org

Reply via email to