Skip to content

Commit

Permalink
Issue #13213: Remove '//ok' comments from InputJavadocMethodProtected…
Browse files Browse the repository at this point in the history
…Scope
  • Loading branch information
prathm3 authored and romani committed Apr 30, 2024
1 parent b947eca commit c4d557c
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 39 deletions.
26 changes: 0 additions & 26 deletions config/checkstyle-input-suppressions.xml
Expand Up @@ -297,32 +297,6 @@
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodParamsTags.java"/>
<suppress id="UnnecessaryOkComment"
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodParamsTags.java"/>
<suppress id="UnnecessaryOkComment"
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodProtectedScopeJavadoc.java"/>
<suppress id="UnnecessaryOkComment"
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodProtectedScopeJavadoc.java"/>
<suppress id="UnnecessaryOkComment"
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodProtectedScopeJavadoc.java"/>
<suppress id="UnnecessaryOkComment"
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodProtectedScopeJavadoc.java"/>
<suppress id="UnnecessaryOkComment"
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodProtectedScopeJavadoc.java"/>
<suppress id="UnnecessaryOkComment"
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodProtectedScopeJavadoc.java"/>
<suppress id="UnnecessaryOkComment"
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodProtectedScopeJavadoc.java"/>
<suppress id="UnnecessaryOkComment"
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodProtectedScopeJavadoc.java"/>
<suppress id="UnnecessaryOkComment"
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodProtectedScopeJavadoc.java"/>
<suppress id="UnnecessaryOkComment"
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodProtectedScopeJavadoc.java"/>
<suppress id="UnnecessaryOkComment"
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodProtectedScopeJavadoc.java"/>
<suppress id="UnnecessaryOkComment"
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodProtectedScopeJavadoc.java"/>
<suppress id="UnnecessaryOkComment"
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodProtectedScopeJavadoc.java"/>
<suppress id="UnnecessaryOkComment"
files="checks[\\/]javadoc[\\/]javadocmethod[\\/]InputJavadocMethodPublicOnly.java"/>
<suppress id="UnnecessaryOkComment"
Expand Down
Expand Up @@ -12,9 +12,9 @@

package com.puppycrawl.tools.checkstyle.checks.javadoc.javadocmethod;

public class InputJavadocMethodProtectedScopeJavadoc // ignore - need javadoc // ok
public class InputJavadocMethodProtectedScopeJavadoc // ignore - need javadoc
{
private interface InnerInterface // ignore - when not relaxed about Javadoc // ok
private interface InnerInterface // ignore - when not relaxed about Javadoc
{
String CONST = "InnerInterface"; // ignore - w.n.r.a.j
void method(); // ignore - when not relaxed about Javadoc
Expand All @@ -33,7 +33,7 @@ private InnerInnerClass()
void method2() // ignore - when not relaxed about Javadoc
{
final Runnable r = new Runnable() {
public void run() {}; // ok
public void run() {};
};
}
}
Expand All @@ -54,32 +54,32 @@ void method() // ignore - when not relaxed about Javadoc
public int aFreddo; // ignore

// ignore - need Javadoc
private InputJavadocMethodProtectedScopeJavadoc(int aA) // ok
private InputJavadocMethodProtectedScopeJavadoc(int aA)
{
}

// ignore - need Javadoc when not relaxed
InputJavadocMethodProtectedScopeJavadoc(String aA) // ok
InputJavadocMethodProtectedScopeJavadoc(String aA)
{
}

// ignore - always need javadoc
protected InputJavadocMethodProtectedScopeJavadoc(Object aA) // ok
protected InputJavadocMethodProtectedScopeJavadoc(Object aA)
{
}

// ignore - always need javadoc
public InputJavadocMethodProtectedScopeJavadoc(Class<Object> aA) // ok
public InputJavadocMethodProtectedScopeJavadoc(Class<Object> aA)
{
}

/** Here should not be an error, Out of scope */
private void method(int aA) // ok
private void method(int aA)
{
}

/** Here should not be an error, Out of scope */
void method(Long aA) // ok
void method(Long aA)
{
}

Expand All @@ -99,26 +99,26 @@ public void method(StringBuffer aA) // violation 'Expected @param tag for 'aA'.'
Writing a little documentation should not be worse than not
writing any documentation at all.
*/
private void method(String aA) // ok
private void method(String aA)
{
}

/**
This inner class has no author tag, which is OK.
*/
public class InnerWithoutAuthor // ok
public class InnerWithoutAuthor
{

}

/** {@inheritDoc} */
public String toString() // ok
public String toString()
{
return super.toString();
}

@Deprecated @Override
public int hashCode() // ok
public int hashCode()
{
return super.hashCode();
}
Expand Down

0 comments on commit c4d557c

Please sign in to comment.