Re: Which newsgroup for json parsing?

On Tue, 28 May 2024 14:45:09 +0300, Michael S wrote:

And despite that you can very easily have too much (or too many?)
comments.

My rule with comments is that they should explain *why* the code is doing
what it’s doing, not simply repeat *what* the code is doing (which would
be obvious to anyone who knows the language, APIs etc).

E.g.

    const ssize_t allocation_step = 10;
      /* something convenient to reduce nr of tuple resize operations */
    ...
    PyTuple_SET_ITEM(factorelt, 0, factorobj);
    PyTuple_SET_ITEM(factorelt, 1, powerobj);
    factorobj = powerobj = NULL; /* ownership has passed to factorelt */
    if (nr_used == nr_allocated)
      {
      /* need more room in result tuple */
        nr_allocated += allocation_step;
        if (_PyTuple_Resize(&tempresult, nr_allocated) != 0)
            break;
      } /*if*/