Improve the deprecation macro

[rruuaanng]

Is your enhancement proposal related to a problem? Please describe.

Currently, we use __deprecated to mark function signatures as deprecated. I believe that improving it to the following approach may better facilitate early planning of the API lifecycle.

Describe the solution you'd like

#define __deprecated __attribute__((deprecated))

To

#define __deprecated(version) __attribute__((deprecated(#version)))

Then, provide an external macro in toolchain.h, which I will refer to as DEPRECATED. I will provide the following code for this:

DEPRECATED(4.3) void foo()
{

}

int main(int argc, char const *argv[])
{
    foo();
    
    return 0;
}

Will throw

test.c:19:5: warning: 'foo' is deprecated: 4.3 [-Wdeprecated-declarations]
   19 |     foo();

As you can see, it also prints the version information. based on practice, they are supported in both Clang and GCC.

Describe alternatives you've considered

Additional context