Actually, don't define

include/SFML/Audio/Export.hpp

@@ -31,7 +31,7 @@
 
 
 ////////////////////////////////////////////////////////////
-// Define portable import / export macros
+// Portable import / export macros
 ////////////////////////////////////////////////////////////
 #if defined(SFML_AUDIO_EXPORTS)
 

include/SFML/Audio/Music.hpp

@@ -63,7 +63,7 @@ public:
         T length{}; //!< The length of the time range
     };
 
-    // Define the relevant Span types
+    // Associated `Span` type
     using TimeSpan = Span<Time>;
 
     ////////////////////////////////////////////////////////////

include/SFML/Config.hpp

@@ -26,7 +26,7 @@
 
 
 ////////////////////////////////////////////////////////////
-// Define the SFML version
+// SFML version
 ////////////////////////////////////////////////////////////
 #define SFML_VERSION_MAJOR      3
 #define SFML_VERSION_MINOR      0
@@ -112,7 +112,7 @@
 
 
 ////////////////////////////////////////////////////////////
-// Define a portable debug macro
+// Portable debug macro
 ////////////////////////////////////////////////////////////
 #if !defined(NDEBUG)
 
@@ -122,7 +122,7 @@
 
 
 ////////////////////////////////////////////////////////////
-// Define helpers to create portable import / export macros for each module
+// Helpers to create portable import / export macros for each module
 ////////////////////////////////////////////////////////////
 #if !defined(SFML_STATIC)
 

include/SFML/Graphics/Export.hpp

@@ -31,7 +31,7 @@
 
 
 ////////////////////////////////////////////////////////////
-// Define portable import / export macros
+// Portable import / export macros
 ////////////////////////////////////////////////////////////
 #if defined(SFML_GRAPHICS_EXPORTS)
 

include/SFML/Graphics/Transform.hpp

@@ -41,7 +41,7 @@ namespace sf
 class Angle;
 
 ////////////////////////////////////////////////////////////
-/// \brief Define a 3x3 transform matrix
+/// \brief 3x3 transform matrix
 ///
 ////////////////////////////////////////////////////////////
 class Transform

include/SFML/Graphics/Vertex.hpp

@@ -35,7 +35,7 @@
 namespace sf
 {
 ////////////////////////////////////////////////////////////
-/// \brief Define a point with color and texture coordinates
+/// \brief Point with color and texture coordinates
 ///
 /// By default, the vertex color is white and texture coordinates are (0, 0).
 ///

include/SFML/Graphics/VertexArray.hpp

@@ -45,7 +45,7 @@ namespace sf
 class RenderTarget;
 
 ////////////////////////////////////////////////////////////
-/// \brief Define a set of one or more 2D primitives
+/// \brief Set of one or more 2D primitives
 ///
 ////////////////////////////////////////////////////////////
 class SFML_GRAPHICS_API VertexArray : public Drawable

include/SFML/Network/Export.hpp

@@ -31,7 +31,7 @@
 
 
 ////////////////////////////////////////////////////////////
-// Define portable import / export macros
+// Portable import / export macros
 ////////////////////////////////////////////////////////////
 #if defined(SFML_NETWORK_EXPORTS)
 

include/SFML/Network/Ftp.hpp

@@ -61,7 +61,7 @@ public:
     };
 
     ////////////////////////////////////////////////////////////
-    /// \brief Define a FTP response
+    /// \brief FTP response
     ///
     ////////////////////////////////////////////////////////////
     class SFML_NETWORK_API Response

include/SFML/Network/Http.hpp

@@ -50,7 +50,7 @@ class SFML_NETWORK_API Http
 {
 public:
     ////////////////////////////////////////////////////////////
-    /// \brief Define a HTTP request
+    /// \brief HTTP request
     ///
     ////////////////////////////////////////////////////////////
     class SFML_NETWORK_API Request
@@ -187,7 +187,7 @@ public:
     };
 
     ////////////////////////////////////////////////////////////
-    /// \brief Define a HTTP response
+    /// \brief HTTP response
     ///
     ////////////////////////////////////////////////////////////
     class SFML_NETWORK_API Response

include/SFML/Network/SocketHandle.hpp

@@ -37,8 +37,7 @@
 namespace sf
 {
 ////////////////////////////////////////////////////////////
-// Define the low-level socket handle type, specific to
+// Low-level socket handle type, specific to each platform
-// each platform
 ////////////////////////////////////////////////////////////
 #if defined(SFML_SYSTEM_WINDOWS)
 

include/SFML/System/Export.hpp

@@ -31,7 +31,7 @@
 
 
 ////////////////////////////////////////////////////////////
-// Define portable import / export macros
+// Portable import / export macros
 ////////////////////////////////////////////////////////////
 #if defined(SFML_SYSTEM_EXPORTS)
 

include/SFML/System/Vector3.hpp

@@ -308,7 +308,7 @@ template <typename T>
 template <typename T>
 [[nodiscard]] constexpr bool operator!=(const Vector3<T>& left, const Vector3<T>& right);
 
-// Define the most common types
+// Aliases for the most common types
 using Vector3i = Vector3<int>;
 using Vector3f = Vector3<float>;
 

include/SFML/Window/Export.hpp

@@ -31,7 +31,7 @@
 
 
 ////////////////////////////////////////////////////////////
-// Define portable import / export macros
+// Portable import / export macros
 ////////////////////////////////////////////////////////////
 #if defined(SFML_WINDOW_EXPORTS)
 

include/SFML/Window/WindowHandle.hpp

@@ -76,8 +76,7 @@ using WindowHandle = "platform-specific";
 /// \typedef sf::WindowHandle
 /// \ingroup window
 ///
-/// Define a low-level window handle type, specific to
+/// Low-level window handle type, specific to each platform.
-/// each platform.
 ///
 /// Platform        | Type
 /// ----------------|------------------------------------------------------------

src/SFML/Graphics/GLCheck.hpp

@@ -53,7 +53,7 @@ namespace sf::priv
 bool glCheckError(const std::filesystem::path& file, unsigned int line, std::string_view expression);
 
 ////////////////////////////////////////////////////////////
-/// Define a macro to quickly check every OpenGL API call
+/// Macro to quickly check every OpenGL API call
 ////////////////////////////////////////////////////////////
 #ifdef SFML_DEBUG
 // In debug mode, perform a test on every OpenGL call

src/SFML/Network/TcpSocket.cpp

@@ -45,7 +45,7 @@
 
 namespace
 {
-// Define the low-level send/receive flags, which depend on the OS
+// Low-level send/receive flags (OS-dependent)
 #ifdef SFML_SYSTEM_LINUX
 const int flags = MSG_NOSIGNAL;
 #else

src/SFML/Window/EGLCheck.hpp

@@ -53,7 +53,7 @@ namespace sf::priv
 bool eglCheckError(const std::filesystem::path& file, unsigned int line, std::string_view expression);
 
 ////////////////////////////////////////////////////////////
-/// Define a macro to quickly check every EGL API call
+/// Macro to quickly check every EGL API call
 ////////////////////////////////////////////////////////////
 #ifdef SFML_DEBUG