◐ Shell
clean mode source ↗

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

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 :)