Extra subfolders in header include paths (and their impact on linting)
I'm running Ubuntu 22.04, with kernel 5.15.0. I want to be able to run an automatic linter in the background on my C++ code for ROS2 in either Sublime Text (https://github.com/SublimeLinter/Subl...) or VS Code (https://code.visualstudio.com/docs/cp...). This requires me to configure my linter with the proper include paths to ROS2 headers (e.g., rclcpp.hpp).
Previously, with a binary installation of ROS2 Foxy on Ubuntu 20.04, I could do this by adding the folder /opt/ros/foxy/include to the -I option in SublimeLinter. Then, in my C++ file foo.cpp, I could write #include "rclcpp/rclcpp.hpp", and the linter would recognize the various objects in foo.cpp that came from this header file. However, now in ROS2 Humble on Ubuntu 22.04, all of these header files are located one folder deeper -- for example, rclcpp.hpp is located at /opt/ros/humble/include/rclcpp/rclcpp/rclcpp.hpp, where the extra folder named rclcpp is not a typo and only contains the single subfolder also named rclcpp. Now, to get correct linting when writing things like #include "rclcpp/rclcpp.hpp", I would need to manually include all of these subfolders rather than just the single subfolder /opt/ros/humble/include. It's not obvious to me why these extra subfolder levels are used in ROS2.
A similar problem occurs in linting when trying to include headers from other installed packages in a multi-package workspace. For example, consider the MWE at https://github.com/spenrich/ros2-exam... (based on the ROS2 tutorials). Building the packages in this workspace with ROS2 Rolling on Ubuntu 20.04 allows me to use the path $WORKSPACE_PATH/install/tutorial_interfaces/include in my linter settings to correctly handle when I write #include "tutorial_interfaces/msg/num.hpp". However, if I build using ROS2 Humble/Rolling on Ubuntu 22.04, I have to use the include path $WORKSPACE_PATH/install/tutorial_interfaces/include/tutorial_interfaces -- another instance of an extra sub-folder for no obvious reason.
TL;DR -- has anyone had success configuring their linter in Sublime Text (i.e., using https://github.com/SublimeLinter/Subl...) or VS Code (i.e., using https://code.visualstudio.com/docs/cp...) to work well with ROS2 Humble?
