-
Notifications
You must be signed in to change notification settings - Fork 5
Fix java doc warnings #1413
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: dev
Are you sure you want to change the base?
Fix java doc warnings #1413
Conversation
# Conflicts: # CHANGELOG.md
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I haven't look at every class, but I think a lot of the automatically generated javadoc needs polishing.
@@ -7,21 +7,37 @@ | |||
|
|||
/** | |||
* Exception that should be used whenever something invalid happens in a implementation of a {@link | |||
* edu.ie3.datamodel.io.connectors.DataConnector} | |||
* edu.ie3.datamodel.io.connectors.DataConnector}* |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Why is there a *
here?
/** | ||
* Instantiates a new Duplicate entities exception. | ||
* | ||
* @param s the s |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This should be renamed into something like the message
. Maybe we should also rename the parameter.
@@ -7,17 +7,33 @@ | |||
|
|||
/** | |||
* Is thrown, when something went wrong during entity field mapping creation in a {@link | |||
* edu.ie3.datamodel.io.processor.EntityProcessor} | |||
* edu.ie3.datamodel.io.processor.EntityProcessor}* |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Same as before.
/** | ||
* Instantiates a new Topology exception. | ||
* | ||
* @param s the s |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should probably be renamed.
/** | ||
* Instantiates a new Topology exception. | ||
* | ||
* @param s the s |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Same as above.
/** The type Hp input factory. */ | ||
public class HpInputFactory |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Same as above.
/** The type Load input factory. */ | ||
public class LoadInputFactory |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Same as above.
@@ -45,6 +50,18 @@ protected T buildModel( | |||
return buildModel(data, uuid, id, nodeA, nodeB, operator, operationTime); | |||
} | |||
|
|||
/** | |||
* Build model t. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The t
should be replaced (maybe instance
).
/** The type Cylindrical storage input factory. */ | ||
public class CylindricalStorageInputFactory |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Same as above.
* @param <T> the type parameter | ||
* @version 0.1 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Same as above.
@staudtMarius I'm sorry, I should have written something about this beforehand. But I didn't expect someone to review this so quickly and in such depth. Most of it is generated automatically. There will certainly be improvements. There are now three options:
Let's discuss this in office / sprint somewhen. |
resolves #494
merge first