[21114] Check suprocess return codes on RDT generation (backport #795)

[mergify]

Description

This PR makes the RDT generation to fail if either of the doxygen or swig commands fails. Not checking them was causing the documentation to build with API reference errors.

@Mergifyio backport 2.14.x 2.13.x 2.10.x 2.6.x

Related implementation PR:

• [21144] Fix Doxygen errors for Doxygen versions prior to 1.8.19 Fast-DDS#4896

NOTE: As RTD build is not ready to take the appropriate Fast DDS branch and will choose master, the build will failed until eProsima/Fast-DDS#4896 is merged. I've verified on a Ubuntu 20.04 docker that the doxygen is generated without errors with that Fast DDS PR.

Contributor Checklist

• Commit messages follow the project guidelines.
• N/A: Code snippets related to the added documentation have been provided.
• Documentation tests pass locally.
• Applicable backports have been included in the description.

Reviewer Checklist

• The PR has a milestone assigned.
• The title and description correctly express the PR's purpose.
• Check contributor checklist is correct.
• CI passes without warnings or errors.

---

This is an automatic backport of pull request #795 done by [Mergify](https://mergify.com).

[Mario-DL]

@richiprosima please test docs

[EduPonz]

This shall include changes similar to those introduced in:

• [21114] Check suprocess return codes on RDT generation (backport #795) #796