PeterFeicht / cppreference-doc

C++ standard library reference
en.cppreference.com
GNU General Public License v3.0
576 stars 47 forks source link

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

Open carlosgalvezp opened 2 years ago

carlosgalvezp commented 2 years ago

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?

PeterFeicht commented 2 years ago

This sounds like something worth contributing upstream 🤔

PeterFeicht commented 2 weeks ago

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?