Skip to content

Conversation

@christophebedard
Copy link
Member

Description

This corresponds to changes in launch frontends: ros2/launch#848. This does not affect Python launch files.

This PR updates some launch XML/YAML examples to use let under include tags.
It also updates the migration guide: (1) migrating from ROS 1's arg and (2) new let tag in ROS 2.

Did you use Generative AI?

Additional Information

@christophebedard christophebedard added the backport-all backport at reviewers discretion; from rolling to all versions label Oct 6, 2025
See example of ``push_ros_namespace`` tag for a workaround.
* ``arg`` tags nested in an ``include`` tag don't support conditionals (``if``, ``unless``) or the ``description`` attribute.
* ``arg`` tag nested in an ``include`` tag is now ``let``.
However, ``arg`` is still supported for now.
Copy link
Member Author

@christophebedard christophebedard Oct 6, 2025

Choose a reason for hiding this comment

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

The original change (ros2/launch#848) was backported to Kilted/Jazzy/Humble, so arg is still supported under include alongside let, but we should still mention this change to people using older distros. If/once arg under include is deprecated, we can remove this line for distros going forward.

@christophebedard christophebedard force-pushed the christophebedard/launch-xml-yaml-include-switch-from-arg-to-let branch from c236206 to 94a37c5 Compare October 6, 2025 22:56
@github-actions
Copy link

github-actions bot commented Oct 6, 2025

HTML artifacts: https://github.com/ros2/ros2_documentation/actions/runs/18296698859/artifacts/4198011490.

To view the resulting site:

  1. Click on the above link to download the artifacts archive
  2. Extract it
  3. Open html-artifacts-5923/index.html in your favorite browser

@ahcorde ahcorde merged commit 51e6598 into rolling Oct 7, 2025
5 checks passed
@ahcorde ahcorde deleted the christophebedard/launch-xml-yaml-include-switch-from-arg-to-let branch October 7, 2025 08:13
mergify bot pushed a commit that referenced this pull request Oct 7, 2025
Signed-off-by: Christophe Bedard <[email protected]>
(cherry picked from commit 51e6598)
mergify bot pushed a commit that referenced this pull request Oct 7, 2025
Signed-off-by: Christophe Bedard <[email protected]>
(cherry picked from commit 51e6598)
mergify bot pushed a commit that referenced this pull request Oct 7, 2025
Signed-off-by: Christophe Bedard <[email protected]>
(cherry picked from commit 51e6598)
mergify bot pushed a commit that referenced this pull request Oct 7, 2025
Signed-off-by: Christophe Bedard <[email protected]>
(cherry picked from commit 51e6598)
mergify bot pushed a commit that referenced this pull request Oct 7, 2025
Signed-off-by: Christophe Bedard <[email protected]>
(cherry picked from commit 51e6598)
mergify bot pushed a commit that referenced this pull request Oct 7, 2025
Signed-off-by: Christophe Bedard <[email protected]>
(cherry picked from commit 51e6598)
ahcorde pushed a commit that referenced this pull request Oct 7, 2025
)

(cherry picked from commit 51e6598)

Signed-off-by: Christophe Bedard <[email protected]>
Co-authored-by: Christophe Bedard <[email protected]>
ahcorde pushed a commit that referenced this pull request Oct 7, 2025
)

(cherry picked from commit 51e6598)

Signed-off-by: Christophe Bedard <[email protected]>
Co-authored-by: Christophe Bedard <[email protected]>
ahcorde pushed a commit that referenced this pull request Oct 7, 2025
)

(cherry picked from commit 51e6598)

Signed-off-by: Christophe Bedard <[email protected]>
Co-authored-by: Christophe Bedard <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport-all backport at reviewers discretion; from rolling to all versions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants