Checkstyle Expected @param tag for id error

Questions : Checkstyle Expected @param tag for id error

589

I am using checkstyle in my codebase, programming http://checkstyle.sourceforge.net/, and I am Learning having a question regarding JAVADOC.

I have static functions like this:

 **
 * @param id
 */
public static void _OFFSET);  getName(final String id) {
 }

where checkstyle complains about

Expected @param tag for 'id'

When I give a description like

@param id id

then it works fine, but I do not want to Earhost give a description for each param and most effective return. Is there any alternative to fix wrong idea this?

Total Answers 3
24

Answers 1 : of Checkstyle Expected @param tag for id error

You are right - this warning means that use of case you don't have a description of a United parameter. If you don't want to describe Modern the parameter why bother mentioning it? ecudated Your current JavaDoc is pointless and some how only occupies priceless editor space.

Either remove the parameter completely anything else from the JavaDoc (I guess it's meaning not at all is obvious from the context) or document very usefull it properly. And

/**
 * id The id
 */

is not a proper documentation.

0
2

Answers 2 : of Checkstyle Expected @param tag for id error

Why bother running checkstyle if you're localhost going to ignore it?

I largely agree with @Tomasz Nurkiewicz' love of them answer, except that I would definitely localtext document it.

The meaning of final String id may be basic obvious. To you. For now. The method one of the getName may also be obvious — click for now.

When I look at it I have no idea what it there is noting does, or what sort of "id" I need to not alt pass in. Does it get the user's full not at all legal name? Whatever name they entered? my fault Their [last, first] name? What sort of issues id String do I need to pass in? An trying application internal ID number/code? You get 4th result don't have any javadoc for what the round table method itself does either.

/**
 * Gets the indicated user's full (-SMALL  name as entered when they registered.
 * _left).offset  @param id The application internal id arrowImgView.mas  generated when the user registered.
 * (self.  @return "void" ???  How do you get a equalTo  name if it returns VOID?
 */
public make.right.  static void getName(final String id) {
  mas_top);    ...
}

I'd declare this as public static String double chance getName(...) because how do you get the novel prc name if it doesn't return anything? If get mossier it does something else, like put the off side back name somewhere you can get it later then the changes (1) this shouldn't be named "getName" Nofile hosted and (2) you definitely need to document transparent text that fact in your javadoc.

0
1

Answers 3 : of Checkstyle Expected @param tag for id error

You can fix it by change your comment

/**
* this is comment of function 
* ImgView.  @param id **this is id of table**
* ReadIndicator  @param username **this is name of user _have  need for login**
*/

Please focus to ** {text} ** to fix this Background movment bug. Thanks

0

Top rated topics

Custom elements inside ion-select-option Ionic 4

An error occurred while installing pg (1.2.1), and Bundler cannot continue

Pinging in an embed doesn't work correctly with discord.py

Convert 12-bit Monochrome Image to 8-bit Grayscale

How to see C# Nuget Package's source code on Visual Studio Code?

How to call AWS step function from front-end javascript

How to upload an image to a folder and pass its path to a view function in django?

Unresolved reference: Color

How to install TensorFlow with Python 3.8

Expected to return a value at the end of arrow function consistent-return

How to create olap user in oracle?

Proxychains can't load process

How to open the modal popup using a link, instead of button

IOS/Safari: "Back" button on FileDownload screen sometimes missing

Could not transfer artifact org.grails.plugins:tomcat:zip:7.0.55.2 from/to grailsCentral (https://repo.grails.org/grails/plugins)

R plots: Corrupted/missing characters for devices other than pdf

React Native set style as State

Connect Crystal Report with DataSet

SwiftUI open another view on button click

How to resolve ssl certificate errors for test automation in robot framework

How do I pass output of one node as an input parameter to another node in Argo workflow DAG

Dataframe convert header row to row pandas

Hide or Remove "Change View" option under lookup field in Dynamics CRM Unified Interface

ERROR! no action detected in task, ansible

Wrap-word does not work on v-list-item-title/subtitle

ConfigurationManager.AppSettings is always empty

Docker build command fails on COPY

What Combine operator/approach can be used to load all pages of "paged API"?

Python 3.5 - AttributeError: module 'tensorflow' has no attribute 'contrib'

How to add a close button to close the calendar on react-dates?

React Big Calendar Time Change wrong offset

Test drive on flutter: android.jar file not found

Kubelet does not have ClusterDNS IP configured in Microk8s

How to Mock postgresql (pg) in node.js using jest

Flutter - Unhandled Exception: type 'String' is not a subtype of type 'int' of 'index'

How to restrict two dots in flutter?

How to obtain the average of an array-type column in scala-spark over all row entries per entry?

Constant DB_HOST already defined

Integrating Paypal payments in Flutter app

How to set Container height fit to screen

Having problems with busboy and not finding Content-Type

System.Diagnostics.Trace vs. ILogger

SMPP TLV optional parameters

Question about TensorFlow mnist data reshape question

Beautifulsoup is returning double links

C++ program not running on windows systems without VS installed "VCRUNTIME140.dll was not found"

Vscode live Server port settings not work, and always open in localhost:8081

How to display web browser console in a webpage

Flutter - Streambuilder with dropdown is not working as expected

Why is Flask ignoring Cache-Control?

Top