Revert "update layout comment per pr suggestion"

This reverts commit 27b3fa0.

Author: clintonsteiner

Include/internal/pycore_dict.h

@@ -171,9 +171,7 @@ typedef enum {
     DICT_KEYS_SPLIT = 2
 } DictKeysKind;
 
-/* See dictobject.c for the full DictKeysObject memory layout.
- * A PyDictKeysObject* points to the fixed-size header below.
- */
+/* See dictobject.c for actual layout of DictKeysObject */
 struct _dictkeysobject {
     Py_ssize_t dk_refcnt;
 
@@ -213,8 +211,7 @@ struct _dictkeysobject {
        - 4 bytes if dk_size <= 0xffffffff (int32_t*)
        - 8 bytes otherwise (int64_t*)
 
-       Dynamically sized. This is the start of the variable-sized tail that
-       immediately follows the fixed-size header. */
+       Dynamically sized, SIZEOF_VOID_P is minimum. */
     char dk_indices[];  /* char is required to avoid strict aliasing. */
 
     /* "PyDictKeyEntry or PyDictUnicodeEntry dk_entries[USABLE_FRACTION(DK_SIZE(dk))];" array follows:

Objects/dictobject.c

@@ -17,7 +17,6 @@ As of Python 3.6, this is compact and ordered. Basic idea is described here:
 layout:
 
 +---------------------+
-| struct _dictkeysobj |
 | dk_refcnt           |
 | dk_log2_size        |
 | dk_log2_index_bytes |
@@ -26,17 +25,13 @@ As of Python 3.6, this is compact and ordered. Basic idea is described here:
 | dk_usable           |
 | dk_nentries         |
 +---------------------+
-| dk_indices[]        |  <-- starts at &dk->dk_indices[0]
+| dk_indices[]        |
 |                     |
 +---------------------+
-| dk_entries[]        |  <-- starts at DK_ENTRIES(dk)
+| dk_entries[]        |
 |                     |
 +---------------------+
 
-A PyDictKeysObject* points to the start of the fixed-size header.
-The variable-sized part begins at dk_indices and is followed immediately by
-the entry array.
-
 dk_indices is actual hashtable.  It holds index in entries, or DKIX_EMPTY(-1)
 or DKIX_DUMMY(-2).
 Size of indices is dk_size.  Type of each index in indices varies with dk_size: