Fix up comments

Author: markshannon

Include/cpython/code.h

@@ -35,8 +35,9 @@ typedef struct {
 } _PyCoCached;
 
 /* Ancillary data structure used for instrumentation.
-   Line instrumentation creates an array of
-   these. One entry per code unit.*/
+   Line instrumentation creates this with sufficient
+   space for one entry per code unit. The total size
+   of the data will be `bytes_per_entry * Py_SIZE(code)` */
 typedef struct {
     uint8_t bytes_per_entry;
     uint8_t data[1];

Python/instrumentation.c

@@ -1528,7 +1528,7 @@ initialize_lines(PyCodeObject *code, int bytes_per_entry)
             case POP_ITER:
                     /* END_FOR cannot start a line, as it is skipped by FOR_ITER
                     * END_SEND cannot start a line, as it is skipped by SEND
-                 * RESUME and POP_ITER must not be instrumented with INSTRUMENT_LINE */
+                    * RESUME and POP_ITER must not be instrumented with INSTRUMENTED_LINE */
                     set_original_opcode(line_data, i, 0);
                     break;
                 default: