when we deprecate a function add deprecate marking function description block #1093
Description
Problem
Some of us are trying to implement the ABI standard using mechanisms that leverage the MPI standard's existing python framework for generating latex based off of templated entries for MPI functions (not constants yet) to generate a correct mpi.h.
To do so, the json file emitted by the framework needs to be accurate.
It is not currently accurate for deprecated functions. They end up being marked as not deprecated in the json file. So, if one is leveraging the code in https://github.com/mpi-forum/pympistandard it ends up generating prototypes for these deprecated functions in outputed mpi.h even if one adds filtering for the deprecated value in the json file.
Proposal
PR to be opened soon
Changes to the Text
only annotations to be picked up by the python bindings generator - not visible in the generated pdf itself.
Impact on Implementations
Helps those trying to use an ABI compliant mpi.h using json data from the standard.
Impact on Users
Accurate mpi.h for those testing the ABI.