bd92523bc5
Put Doxygen grouping constructs ("@{" and "@}") in Doxygen comments
rather than plain C++ ones to make them actually take effect. Some old
Doxygen versions (~1.8.5) did recognize them even in plain comments, but
the currently uses 1.9.1 one does not and @addtogroup didn't have any
effect as the result.
This fixes the problem with the "Functions by Category" pages being
empty in the resulting HTML documentation.
See #22572.
60 lines
1.6 KiB
C
60 lines
1.6 KiB
C
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: cpp.h
|
|
// Purpose: interface of global functions
|
|
// Author: wxWidgets team
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
/** @addtogroup group_funcmacro_misc */
|
|
///@{
|
|
/**
|
|
This macro returns the concatenation of the arguments passed. Unlike when
|
|
using the preprocessor operator, the arguments undergo macro expansion
|
|
before being concatenated.
|
|
|
|
@header{wx/cpp.h}
|
|
*/
|
|
#define wxCONCAT(x1, x2)
|
|
#define wxCONCAT3(x1, x2, x3)
|
|
#define wxCONCAT4(x1, x2, x3, x4)
|
|
#define wxCONCAT5(x1, x2, x3, x4, x5)
|
|
///@}
|
|
|
|
/** @addtogroup group_funcmacro_misc */
|
|
///@{
|
|
|
|
/**
|
|
Returns the string representation of the given symbol which can be either a
|
|
literal or a macro (hence the advantage of using this macro instead of the
|
|
standard preprocessor @c # operator which doesn't work with macros).
|
|
|
|
Notice that this macro always produces a @c char string, use
|
|
wxSTRINGIZE_T() to build a wide string Unicode build.
|
|
|
|
@see wxCONCAT()
|
|
|
|
@header{wx/cpp.h}
|
|
*/
|
|
#define wxSTRINGIZE(x)
|
|
|
|
/**
|
|
Returns the string representation of the given symbol as either an ASCII or
|
|
Unicode string, depending on the current build. This is the
|
|
Unicode-friendly equivalent of wxSTRINGIZE().
|
|
|
|
@header{wx/cpp.h}
|
|
*/
|
|
#define wxSTRINGIZE_T(x)
|
|
|
|
/**
|
|
This macro expands to the name of the current function if the compiler
|
|
supports any of @c \__FUNCTION__, @c \__func__ or equivalent variables or
|
|
macros or to @NULL if none of them is available.
|
|
|
|
@header{wx/cpp.h}
|
|
*/
|
|
#define __WXFUNCTION__
|
|
|
|
///@}
|
|
|