gh-141004: Reorganize and reword the 'Useful macros' section (GH-144471)

- Group the macros
- Roughly order them to put the most important ones first
- Add expansions where it makes sense; especially if there's
  an equivalent in modern C or a common compiler
(cherry picked from commit f85e1170d2b22d2ee42cd568144e0c9f57b0db67)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>

Author: 3 people