Skip to content

Library index is missing many enumerators #3731

Open
@AlisdairM

Description

@AlisdairM
Contributor

May be related to #2972 but I think that is only about the main index.

The library contains a variety of enumerations, or bitfield/mask types that provide names like an enumeration. However, many of the enumerator names, while essentially reserved for use in such library contexts (users cannot name macros the same, etc.), are not listed in the library index.

My search is far from exhaustive, but I started from Annex D code_cvt mode enumerators, and then noticed most/all of the bitfields and bit masks in ios_base are missing, and then filed this ticket.

If we do add these names, how should we describe/index them? As members of their enumerator/surrounding class? Under their own name with an ref back to their host?

Given late filing and potential scale, this issue probably should not be considered before C++23 work starts.

Activity

added this to the C++23 milestone on Mar 10, 2020
added
decision-requiredA decision of the editorial group (or the Project Editor) is required.
on May 29, 2020
jensmaurer

jensmaurer commented on May 29, 2020

@jensmaurer
Member

I would say we should index them as if the enumeration were a class and the enumerators were class members. However, some/all enumerations are members of some class, and the non-scoped enumeration names often don't actually show up in source code (because they are transparent).

jensmaurer

jensmaurer commented on May 28, 2021

@jensmaurer
Member

Editorial meeting: Index enumerators as members of the enumeration "class".

removed
decision-requiredA decision of the editorial group (or the Project Editor) is required.
on May 28, 2021
AlisdairM

AlisdairM commented on Feb 21, 2023

@AlisdairM
ContributorAuthor

Sorry, just picking this up again now.
I expect there are enough enumerations scattered through the standard that we should pick this up as an early piece of C++26 work, but shout if you want me to file PRs after all the C++23 papers have landed. (I do not have any PRs in waiting)

AlisdairM

AlisdairM commented on Mar 28, 2023

@AlisdairM
ContributorAuthor

Ping!

This issue is still marked as C++23. Should I plan to file PRs over the weekend (April 1/2) or should we update the tag to C++26?

tkoeppe

tkoeppe commented on Mar 28, 2023

@tkoeppe
Contributor

I don't feel strongly. If you have time, go ahead and make the PRs, and chances are we can apply them for 23.

modified the milestones: C++23, C++26 on Oct 23, 2023
AlisdairM

AlisdairM commented on Oct 20, 2024

@AlisdairM
ContributorAuthor

Jens got started ahead of me: #7327

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

      Development

      No branches or pull requests

        Participants

        @AlisdairM@tkoeppe@jensmaurer

        Issue actions

          Library index is missing many enumerators · Issue #3731 · cplusplus/draft