deprecate rclcpp::spin_some and rclcpp::spin_all

[alsora]

Description

Deprecate rclcpp::spin_some and rclcpp::spin_all.
These functions can lead to very poor performance for developers who are not aware that calling them will:

• create an executor
• add the node to the executor
• do the spin
• destroy the executor

If called in a loop, you are wasting a lot of CPU cycles repeating those operations every time.
This instead is a lot more efficient because only the spin operation is repeated as expected.

SingleThreadedExecutor executor;
executor.add_node(node);
while (should_spin)
{
    executor.spin_some();
}

Adding and removing nodes from executors are expensive operations that shouldn't be done at "steady state" of the system.

IMPORTANT
In this PR I'm also re-ordering the events-executor constructor arguments so that this becomes possible:

MyExecutorType executor(options);

Now all executors take the executor options as first argument.

Is this user-facing behavior change?

Yes, deprecating some functions and modifying a constructor (although it's in the experimental namespace)

Did you use Generative AI?

No

closes #2675

[fujitatomoya]

@Mergifyio rebase

[mergify]

rebase

✅ Branch has been successfully rebased

[fujitatomoya]

Pulls: #2848
Gist: https://gist.githubusercontent.com/fujitatomoya/fa4647ec68c1811cf6576850ed1d022a/raw/3ac4860bbd88f8c2ba1df0e0962127021685089d/ros2.repos
BUILD args: --packages-above-and-dependencies rclcpp rclcpp_action rclcpp_lifecycle
TEST args: --packages-above rclcpp rclcpp_action rclcpp_lifecycle
ROS Distro: rolling
Job: ci_launcher
ci_launcher ran: https://ci.ros2.org/job/ci_launcher/16595

• Linux
• Linux-aarch64
• Linux-rhel
• Windows