From 7a382db5f699db9e5491661e648ebb19b3d5bacc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vladim=C3=ADr=20Vondru=C5=A1?= Date: Mon, 23 May 2022 15:04:07 +0200 Subject: [PATCH] DebugTools: thanks, Doxygen, for brightening up my MONDAY. --- src/Magnum/DebugTools/BufferData.h | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/src/Magnum/DebugTools/BufferData.h b/src/Magnum/DebugTools/BufferData.h index 70508bfc5..99f588d6c 100644 --- a/src/Magnum/DebugTools/BufferData.h +++ b/src/Magnum/DebugTools/BufferData.h @@ -87,7 +87,13 @@ MAGNUM_DEBUGTOOLS_EXPORT Containers::Array bufferSubData(GL::Buffer& buffe 2.0. @requires_gles Buffer mapping is not available in WebGL. */ -template CORRADE_DEPRECATED("use non-templated bufferSubData() and Containers::arrayCast() instead") Containers::Array inline bufferSubData(GL::Buffer& buffer, GLintptr offset, GLsizeiptr size) { +template CORRADE_DEPRECATED("use non-templated bufferSubData() and Containers::arrayCast() instead") Containers::Array inline bufferSubData(GL::Buffer& buffer, GLintptr offset, GLsizeiptr size + #ifdef DOXYGEN_GENERATING_OUTPUT + /* HELLO FUCKING CRAP TOOL, WHY CAN'T YOU DISTINGUISH A TEMPLATED FUNCTION + FROM A NON-TEMPLATE, SMASHING THE DOCUMENTATION TOGETHER??! */ + , void* doxygenIsCrapAtOverloadResolution = nullptr + #endif +) { /* Yes, this should have NoInit, but let's preserve the deprecated API in its original form */ Containers::Array data{std::size_t(size)}; @@ -126,7 +132,13 @@ MAGNUM_DEBUGTOOLS_EXPORT Containers::Array bufferData(GL::Buffer& buffer); 2.0. @requires_gles Buffer mapping is not available in WebGL. */ -template CORRADE_DEPRECATED("use non-templated bufferData() and Containers::arrayCast() instead") Containers::Array inline bufferData(GL::Buffer& buffer) { +template CORRADE_DEPRECATED("use non-templated bufferData() and Containers::arrayCast() instead") Containers::Array inline bufferData(GL::Buffer& buffer + #ifdef DOXYGEN_GENERATING_OUTPUT + /* HELLO FUCKING CRAP TOOL, WHY CAN'T YOU DISTINGUISH A TEMPLATED FUNCTION + FROM A NON-TEMPLATE, SMASHING THE DOCUMENTATION TOGETHER??! */ + , void* doxygenIsCrapAtOverloadResolution = nullptr + #endif +) { const Int bufferSize = buffer.size(); /* Yes, the assert prefix is wrong, but let's preserve the deprecated API in its original form */