Re: [PR] [XERCESJ-1781] Javadoc fixes in org.apache. wml.* [xerces-j]

elharo (via GitHub) <[email protected]> Thu, 20 Nov 2025 11:57:53 -0000

Newsgroups	gmane.text.xml.xerces-j.devel
Message-ID	<PR_kwDOLzdO6M60Mc5P-89822361-0621-4aef-a93a-6efc295b155a@gitbox.apache.org>

elharo commented on code in PR #49:
URL: https://github.com/apache/xerces-j/pull/49#discussion_r2539512138


##########
src/org/apache/wml/WMLAElement.java:
##########
@@ -40,7 +40,9 @@ public interface WMLAElement extends WMLElement {
     /**
      * 'xml:lang' specifics the natural or formal language in which
      * the document is written.  
-     * (Section 8.8, WAP WML Version 16-Jun-1999) 
+     * (Section 8.8, WAP WML Version 16-Jun-1999)
+     *
+     * @param newValue set a <code>xml:lang</code> value for the element

Review Comment:
   for `@param` in general this should be a noun, not a verb; e.g. 
   
   a language identifier as defined by [[IETF BCP 47]](https://www.w3.org/TR/xml/#RFC1766), Tags for the Identification of Languages; in addition, the empty string may be specified.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]