Skip to content
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

Doxygen documentation2 #1573

Merged
merged 23 commits into from
Nov 24, 2016
Merged

Conversation

endJunction
Copy link
Member

continuation of #1569 .

* Splits a string into a vector of strings. This method only works for string seperation
* recognised by the std::stringstream iterator such as ' ' or '\t'.
* Splits a string into a vector of strings. This method only works for string
* seperation recognised by the std::stringstream iterator such as ' ' or
Copy link
Collaborator

@chleh chleh Nov 24, 2016

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

typo separation ✅

@@ -86,6 +86,8 @@ class OctTree {
/// private constructor
/// @param ll lower left point
/// @param ur upper right point
/// @param eps the euclidean distance as a threshold to make objects unique
/// [default std::numeric_limits<double>::epsilon()]
Copy link
Collaborator

@chleh chleh Nov 24, 2016

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Where is the default set? The method declaration does not declare a default value.

@@ -46,6 +46,7 @@ template <typename POINT> class QuadTree
* (lower left and the upper right points).
* @param ll lower left point of the square
* @param ur upper right point of the square
* @param max_points_per_node maximum number of points per leaf
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

node vs. leaf?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixing the variable name.

* @param eps tolerance for numerical algorithm used or computing the property
* @return true if the point is not outside the element, false otherwise
* \copydoc MeshLib::Element::isPntInElement()
* @param nodes the nodes of the element.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You only document one parameter. Are the other parameter docs inherited by copydoc?
Smiliar for the other isPntInElement() methods.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes. Other parameters docs are copied (probably must have exactly the same types and names, which they do). Only extra parameters needs documentation.

@chleh
Copy link
Collaborator

chleh commented Nov 24, 2016

Just recognized that some of my comments acutally apply to #1569.

@endJunction endJunction merged commit 60288db into ufz:master Nov 24, 2016
@endJunction endJunction deleted the DoxygenDocumentation2 branch November 24, 2016 18:19
@ogsbot
Copy link
Member

ogsbot commented Jun 19, 2020

OpenGeoSys development has been moved to GitLab.

See this pull request on GitLab.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants