rticonnextdds-examples icon indicating copy to clipboard operation
rticonnextdds-examples copied to clipboard

[ENH] Tutorial has incomplete resources/instructions

Open wcneill opened this issue 9 months ago • 1 comments

Enhancement description

Related to #559

I am attempting to build the second optional application in the tutorial found here: https://community.rti.com/static/documentation/developers/learn/publish-subscribe.html

This optional exercise instructs the reader to build with CMake but does not provide a CMakeLists.txt.

So, I followed the link in the tutorial to the repository, and copied/pasted the CMakeLists.txt that is provided there. However, building with this file results in the following:

CMake Error at CMakeLists.txt:18 (include):
  include could not find requested file:

    ConnextDdsConfigureCmakeUtils


CMake Error at CMakeLists.txt:19 (connextdds_configure_cmake_utils):
  Unknown CMake command "connextdds_configure_cmake_utils".

Moderators/developers commenting on Issue #559 state that this missing file is an unnecessary utility.

It is my suggestion that, if you want tutorial readers build the example with CMake, you provide them with a working CMakeLists.txt.

wcneill avatar May 01 '25 17:05 wcneill

After removing the "unnecessary" include and corresponding function call, the build errors out on the next include which it also cannot find.

I'd say this issue should have been filed under bug, not enhancement.

wcneill avatar May 01 '25 17:05 wcneill