Skip to content

Functions are not labelled with the std:: prefix #25

Open

Description

@carlosgalvezp

Hi!

We are using XML tag file integrated with Doxygen so we can do things like:

/// @see std::vector

This works great for classes and structs, but not for functions, because in the XML tag file the <name> section does not include the std:: prefix, so we need to write:

/// @see begin

Instead of:

/// @see std::begin

Why is that? Would it be possible to add the std:: prefix to all symbols?

Activity

  1. PeterFeicht commented on Apr 28, 2022

    @PeterFeicht
    Owner

    This sounds like something worth contributing upstream 🤔

  2. changed the title [-]Functions are now labelled with the `std::` prefix[/-] [+]Functions are not labelled with the `std::` prefix[/+] on Jul 19, 2022
  3. PeterFeicht commented on Nov 10, 2024

    @PeterFeicht
    Owner

    I just took a look at this and unfortunately I don't know enough about Doxygen tag files to tell if that change would cause any problems (e.g. with IDEs). Since you can use std::begin also via ADL (begin(someVector) rather than std::begin(someVector)), I guess an IDE might have trouble mapping the former to std::begin.

    Member functions use an unqualified name too, how do you reference those?

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

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions