[GitHub] [netbeans] mbien commented on a diff in pull request #5672: apidoc error/warning fix (#4)

["mbien (via GitHub)" <gi...@apache.org>]

mbien commented on code in PR #5672:
URL: https://github.com/apache/netbeans/pull/5672#discussion_r1140927961


##########
ide/editor.fold/src/org/netbeans/modules/editor/fold/GapObjectArray.java:
##########
@@ -28,7 +28,7 @@
  * least one of the threads inserts/removes items, the whole access <i>must</i> be
  * synchronized externally.
  * 
- * <p/>
+ * <p/=>

Review Comment:
   typo?



##########
ide/editor.lib2/src/org/netbeans/spi/editor/typinghooks/CamelCaseInterceptor.java:
##########
@@ -233,8 +233,8 @@ Object[] getData() {
      *
      *
      * <pre>
-     * @MimeRegistrations({
-     *  @MimeRegistration(mimeType = "x-something", service = CamelCaseInterceptor.Factory.class)})
+     * &#64;MimeRegistrations({
+     *  &#64;MimeRegistration(mimeType = "x-something", service = CamelCaseInterceptor.Factory.class)})
      * </pre>

Review Comment:
   same here



##########
ide/editor.lib2/src/org/netbeans/api/editor/EditorActionRegistrations.java:
##########
@@ -30,8 +30,8 @@
  * <br>
  * Example:
  * <pre>
- * @EditorActionRegistrations({ @EditorActionRegistration(name = "name1", ...),
- *                              @EditorActionRegistration(name = "name2", ...)
+ * &#64;EditorActionRegistrations({ &#64;EditorActionRegistration(name = "name1", ...),
+ *                              &#64;EditorActionRegistration(name = "name2", ...)
  *                            })

Review Comment:
   nit: maybe a candidate for a `@code` section



##########
nbbuild/javadoctools/template.xml:
##########
@@ -315,7 +315,7 @@ cause it to fail.
             <bottom>${javadoc.footer}</bottom>
             <!-- Avoid timestamp comments in _all_ html generated files, to reduce unnecessary git commits -->
             <arg value="-notimestamp" />
-            <arg value="-Xdoclint:html,reference,syntax" />
+            <arg value="-Xdoclint:all,-missing" />

Review Comment:
   nice!



-- 
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: notifications-unsubscribe@netbeans.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org

For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists