Enum members manually added to header categories do not appear in those categories

[Susko3]

• Originally reported in Add [CategoryPen] to pen related events #691 (comment)

Enum members, like SDL_EVENT_PEN_BUTTON_DOWN can be manually added to categories, e.g. by adding CategoryPen to the page.

These enum members unfortunately won't show up on the category page. I think this is because they are tagged as CategoryAPIEnumerators, which doesn't appear in the auto-generated category page (closest is CategoryAPIEnum).

To fix this, you could change enum members to be in the CategoryAPIEnum, or, better yet, add a new section on the category page just for enum members, re-using the existing CategoryAPIEnumerators.

---

Please note that I'm not asking to automatically add enum members to categories based on their header files, that might produce too much noise on the category pages, especially for enums with lost of members (but perhaps an exhaustive list is what you want).

[icculus]

This was intentional, so the list of enums on the category pages would only be typedefs (SDL_Keycode listed, its 251 subitems not listed). But if a separate section for these on the category pages is desirable, we could do it. I'm not certain it is desirable, though, as these pages were only generated so the symbols had a wiki page at all.

[Susko3]

I originally wanted to improve the CategoryPen page by including the relevant events. Right now, there's only a dead link to SDL_EVENT_PEN_*, I thought a list of the pen events would be useful, and adding them to the category made sense.

Maybe it's easier to add this list manually, or say it in prose "simply handle SDL_EVENT_PEN_* events". The SDL_EventType page is not the easiest to navigate, but it leads to the correct place and is not a dead link.