ROS Resources: Documentation | Support | Discussion Forum | Index | Service Status | ros @ Robotics Stack Exchange
Ask Your Question

purpose of roslaunch_add_file_check()?

asked 2015-01-03 22:37:22 -0600

Sam Bishop gravatar image

updated 2015-12-17 04:36:51 -0600

130s gravatar image

After working through most of the ROS tutorials, I have started studying some of the code for the robots listed on the wiki. I am trying to become a "fluent" ROS developer. To that end, I am trying to figure out what "roslaunch_add_file_check(launch)" does in this CMakeLists.txt file: . (Google seems to indicate that roslaunch_add_file_check() is related to testing, but that package does not have any tests.) What does that line do, and what is its purpose?

Also, is there a general way to find out about ROS-specific CMake functions like that one? I am sure I will have other questions like this in the future. Thank you!

edit retag flag offensive close merge delete

1 Answer

Sort by ยป oldest newest most voted

answered 2015-01-04 00:01:16 -0600

William gravatar image

Unfortunately this was never documented, but the documentation for rosbuild_add_roslaunch_check is close:

The function you are inquiring about is the "rosbuild-less" equivalent function and in the case you are asking about it is operating on the entire launch folder, which I presume contains one or more .launch files. Even the rosbuild version's documentation does not clearly state what exactly it checks:

This macro declares as a unit test a parse check of one or more roslaunch files. The parser (roslaunch/scripts/roslaunch-check) checks a number of aspects of launch files, in a manner similar to roswtf.

Another thing to do is to look at the script it seems to invoke for the test:

There should probably be something about that script documented here:

And some mention of the CMake commands provided by roslaunch here:

It seems the reason that documentation doesn't exist in those places is that the function used to be provided by rosbuild but is now provided by roslaunch and that never got documented and at the same time the CMake function was added where roslaunch previously had no documented CMake API either.

Adding this to the wiki would be a great contribution, assuming you have the time and figure out more about what the check actually checks.

edit flag offensive delete link more


Thank you very much! I will certainly look at modifying the wiki.

Sam Bishop gravatar image Sam Bishop  ( 2015-01-04 21:12:24 -0600 )edit

I've modified the wiki, but only the main roslaunch page. There are a few things about roslaunch-check that makes me think it wasn't intended to be used directly, so I didn't add it to the tools page. (It's not added to PATH, for instance.) You're welcome to make further changes. And thanks again!

Sam Bishop gravatar image Sam Bishop  ( 2015-01-11 23:52:18 -0600 )edit

Looks fine to me, thanks for your help!

William gravatar image William  ( 2015-01-12 15:25:15 -0600 )edit

Question Tools

1 follower


Asked: 2015-01-03 22:37:22 -0600

Seen: 2,103 times

Last updated: Jan 04 '15