"Argument Clinic How-To" misses `generate_global_objects` step

[sobolevn]

Documentation

Right now our How-To Clinic guide does not mention that it is required to run python Tools/scripts/generate_global_objects.py command to generate global objects used by _Py_ID(), like in here:

 #define NUM_KEYWORDS 1
 static struct {
 PyGC_Head _this_is_not_used;
 PyObject_VAR_HEAD
 PyObject *ob_item[NUM_KEYWORDS];
 } _kwtuple = {
 .ob_base = PyVarObject_HEAD_INIT(&PyTuple_Type, NUM_KEYWORDS)
 .ob_item = { &_Py_ID(only_keys), }, // <--- Here!
 };
 #undef NUM_KEYWORDS

With this command the build fails.
I will send a PR to update docs today.

CC @larryhastings :)

[larryhastings]

generate_global_objects.py is new, Argument Clinic is many years older. It sounds like the generate_global_objects.py authors should have added this documentation when they added this new feature.

[sobolevn]

Done! ✅