Deprecate builder ctrl gates that are not specification compliant

[anthony-santana]

Description

With (PR #876), we are now enforcing the use of cudaq::ctrl when a programmer intends to run a control gate. This behavior must be matched in the kernel builder to remain specification compliant.

As is, this deprecates the old functions with a stern warning, and replaces them with new templated versions. Depending on when this PR is merged, the deprecated functions should be removed for the following release cycle.

Note: this has no impact on the Python API, only the C++ kernel builder.

Old behavior that will now show a deprecation notice:

auto [kernel, value] = cudaq::make_kernel<float>();
std::vector<cudaq::QuakeValue> ctrls{kernel.qalloc(), kernel.qalloc()};
auto target = kernel.qalloc();

// Now deprecated:
kernel.x(ctrls, target);
kernel.x(value, ctrls, target);
kernel.rx(3.14, ctrls, target);

The preferred method moving forward is

kernel.x<cudaq::ctrl>(ctrls, target);
kernel.x<cudaq::ctrl>(value, ctrls, target);
kernel.rx<cudaq::ctrl>(3.14, ctrls, target);

[copy-pr-bot]

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

[anthony-santana]

/ok to test

Command Bot: Processing...

[schweitzpgi]

🙌

[anthony-santana]

/ok to test

Command Bot: Processing...