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

[all] Update data comments #4751

Merged

Conversation

hugtalbot
Copy link
Contributor

In the context of the documentation improvement, and towards the automation of its generation, here is a first wide clean PR.

Replace #2751


By submitting this pull request, I acknowledge that
I have read, understand, and agree SOFA Developer Certificate of Origin (DCO).


Reviewers will merge this pull-request only if

  • it builds with SUCCESS for all platforms on the CI.
  • it does not generate new warnings.
  • it does not generate new unit test failures.
  • it does not generate new scene test failures.
  • it does not break API compatibility.
  • it is more than 1 week old (or has fast-merge label).

@hugtalbot hugtalbot added pr: status to review To notify reviewers to review this pull-request pr: clean Cleaning the code STC#17 Tasks for STC#17 coding sprint labels May 21, 2024
@hugtalbot hugtalbot added this to the v24.12 milestone May 22, 2024
Comment on lines 44 to 45
, m1(initData(&m1, "first_point","index of the constraint on the first model (object1)"))
, m2(initData(&m2, "second_point","index of the constraint on the second model (object2)"))
Copy link
Contributor

Choose a reason for hiding this comment

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

I don't understand why you added object1 and object2 here. What information does it add?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

it was just to relate with the proper data name

@@ -112,7 +112,7 @@ class SOFA_COMPONENT_CONTROLLER_API Controller : public core::behavior::BaseCont
Data < bool > handleEventTriggersUpdate;


Data< bool > d_handleEventTriggersUpdate; ///< Event reception triggers object update
Data< bool > d_handleEventTriggersUpdate; ///< Event handling frequency controls the controller update frequency
Copy link
Contributor

Choose a reason for hiding this comment

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

I am not comfortable with this sentence

Copy link
Contributor Author

Choose a reason for hiding this comment

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

It appears that this data is only used in MechanicalStateController and the associated code would love to get sweeped away :

https://github.com/sofa-framework/sofa/blob/master/Sofa/Component/Controller/src/sofa/component/controller/MechanicalStateController.cpp#L36-L92

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I would recommend to create an issue and cleaning this separately (removing this useless data)

applications/plugins/Sensable/NewOmniDriver.cpp Outdated Show resolved Hide resolved
applications/plugins/Sensable/OmniDriver.cpp Outdated Show resolved Hide resolved
applications/plugins/SensableEmulation/OmniDriverEmu.cpp Outdated Show resolved Hide resolved
applications/plugins/SofaHAPI/SofaHAPIHapticsDevice.cpp Outdated Show resolved Hide resolved
@alxbilger alxbilger force-pushed the 202405_update_data_documentation branch from 208983a to 93cd786 Compare June 4, 2024 15:25
@hugtalbot
Copy link
Contributor Author

[ci-build][with-all-tests]

@bakpaul bakpaul merged commit 459f806 into sofa-framework:master Jun 5, 2024
7 of 11 checks passed
@hugtalbot hugtalbot added pr: status ready Approved a pull-request, ready to be squashed and removed pr: status to review To notify reviewers to review this pull-request labels Jul 31, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
pr: clean Cleaning the code pr: status ready Approved a pull-request, ready to be squashed STC#17 Tasks for STC#17 coding sprint
Projects
Status: No status
Development

Successfully merging this pull request may close these issues.

3 participants