Making an issue based on some discussion in #2270.

Any macros that only serve to shorten/obscure straightforward code should be marked as deprecated in the API/comments and eventually removed. This does not include macros which help prevent unexpected pitfalls like foreach_document which checks that the document is valid.

Remaining useful macros should also be deprecated but then redirected to UPPERCASE named versions of them.

—
You are receiving this because you are subscribed to this thread.
Reply to this email directly, view it on GitHub, or mute the thread.