Skip to content

doc: Added warning to not instantiate Clock directly with RCL_ROS_TIME#2768

Merged
christophebedard merged 2 commits intoros2:rollingfrom
cellumation:clock_doc_improvement
Mar 14, 2025
Merged

doc: Added warning to not instantiate Clock directly with RCL_ROS_TIME#2768
christophebedard merged 2 commits intoros2:rollingfrom
cellumation:clock_doc_improvement

Conversation

@jmachowinski
Copy link
Copy Markdown
Collaborator

If one instantiates a clock with RCL_ROS_TIME one needs to make sure, to attach a valid time source, or the clock will fall back to system time, which is highly unexpected for users of the clock.

If one instantiates a clock with RCL_ROS_TIME one needs to make sure,
to attach a valid time source, or the clock will fall back to system
time, which is highly unexpected for users of the clock.

Signed-off-by: Janosch Machowinski <J.Machowinski@cellumation.com>
@jmachowinski
Copy link
Copy Markdown
Collaborator Author

@tfoote @fujitatomoya @alsora A short review please ;-)

Copy link
Copy Markdown
Collaborator

@fujitatomoya fujitatomoya left a comment

Choose a reason for hiding this comment

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

i am okay to have this warning in doc section.

Co-authored-by: Tomoya Fujita <Tomoya.Fujita@sony.com>
Signed-off-by: Janosch Machowinski <jmachowinski@users.noreply.github.com>
@fujitatomoya
Copy link
Copy Markdown
Collaborator

Pulls: #2768
Gist: https://gist.githubusercontent.com/fujitatomoya/da0de1fcc08b88343f4a6f7ec831f1ea/raw/33fa5cde242f3bb58325bdb7e4003538e31203c4/ros2.repos
BUILD args: --packages-up-to rclcpp
TEST args: --packages-select rclcpp
ROS Distro: rolling
Job: ci_launcher
ci_launcher ran: https://ci.ros2.org/job/ci_launcher/15394

  • Linux Build Status
  • Linux-aarch64 Build Status
  • Linux-rhel Build Status
  • Windows Build Status

@fujitatomoya
Copy link
Copy Markdown
Collaborator

fujitatomoya commented Mar 14, 2025

Note

backport to jazzy and humble required.

Copy link
Copy Markdown
Contributor

@tfoote tfoote left a comment

Choose a reason for hiding this comment

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

Thanks for adding this warning that will hopefully help others not get caught.

@christophebedard christophebedard merged commit 30e61c9 into ros2:rolling Mar 14, 2025
2 checks passed
@christophebedard
Copy link
Copy Markdown
Member

@Mergifyio backport jazzy humble

@mergify
Copy link
Copy Markdown
Contributor

mergify bot commented Mar 14, 2025

backport jazzy humble

✅ Backports have been created

Details

mergify bot pushed a commit that referenced this pull request Mar 14, 2025
#2768)

Signed-off-by: Janosch Machowinski <J.Machowinski@cellumation.com>
Signed-off-by: Janosch Machowinski <jmachowinski@users.noreply.github.com>
Co-authored-by: Janosch Machowinski <J.Machowinski@cellumation.com>
Co-authored-by: Tomoya Fujita <Tomoya.Fujita@sony.com>
(cherry picked from commit 30e61c9)
mergify bot pushed a commit that referenced this pull request Mar 14, 2025
#2768)

Signed-off-by: Janosch Machowinski <J.Machowinski@cellumation.com>
Signed-off-by: Janosch Machowinski <jmachowinski@users.noreply.github.com>
Co-authored-by: Janosch Machowinski <J.Machowinski@cellumation.com>
Co-authored-by: Tomoya Fujita <Tomoya.Fujita@sony.com>
(cherry picked from commit 30e61c9)
christophebedard pushed a commit that referenced this pull request Mar 15, 2025
#2768) (#2769)

Signed-off-by: Janosch Machowinski <J.Machowinski@cellumation.com>
Signed-off-by: Janosch Machowinski <jmachowinski@users.noreply.github.com>
Co-authored-by: Janosch Machowinski <J.Machowinski@cellumation.com>
Co-authored-by: Tomoya Fujita <Tomoya.Fujita@sony.com>
(cherry picked from commit 30e61c9)

Co-authored-by: Janosch Machowinski <jmachowinski@users.noreply.github.com>
christophebedard pushed a commit that referenced this pull request Mar 15, 2025
#2768) (#2770)

Signed-off-by: Janosch Machowinski <J.Machowinski@cellumation.com>
Signed-off-by: Janosch Machowinski <jmachowinski@users.noreply.github.com>
Co-authored-by: Janosch Machowinski <J.Machowinski@cellumation.com>
Co-authored-by: Tomoya Fujita <Tomoya.Fujita@sony.com>
(cherry picked from commit 30e61c9)

Co-authored-by: Janosch Machowinski <jmachowinski@users.noreply.github.com>
jplapp pushed a commit to pixel-robotics/rclcpp that referenced this pull request Apr 9, 2025
ros2#2768) (ros2#2769)

Signed-off-by: Janosch Machowinski <J.Machowinski@cellumation.com>
Signed-off-by: Janosch Machowinski <jmachowinski@users.noreply.github.com>
Co-authored-by: Janosch Machowinski <J.Machowinski@cellumation.com>
Co-authored-by: Tomoya Fujita <Tomoya.Fujita@sony.com>
(cherry picked from commit 30e61c9)

Co-authored-by: Janosch Machowinski <jmachowinski@users.noreply.github.com>
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.

5 participants