Improve documentation wording

include/SFML/Audio/Listener.hpp

@@ -215,8 +215,8 @@ SFML_AUDIO_API void setUpVector(const Vector3f& upVector);
 /// `sf::Listener` are their ears (by the way, they are often linked
 /// together -- same position, orientation, etc.).
 ///
-/// `sf::Listener` is a simple interface, which allows to setup the
+/// `sf::Listener` is a simple interface, which allows for setting up
-/// listener in the 3D audio environment (position, direction and
+/// the listener in the 3D audio environment (position, direction and
 /// up vector), and to adjust the global volume.
 ///
 /// Usage example:

include/SFML/Audio/SoundBufferRecorder.hpp

@@ -108,7 +108,7 @@ private:
 /// \class sf::SoundBufferRecorder
 /// \ingroup audio
 ///
-/// `sf::SoundBufferRecorder` allows to access a recorded sound
+/// `sf::SoundBufferRecorder` allows for accessing a recorded sound
 /// through a `sf::SoundBuffer`, so that it can be played, saved
 /// to a file, etc.
 ///

include/SFML/Audio/SoundStream.hpp

@@ -311,7 +311,7 @@ private:
 /// Unlike audio buffers (see `sf::SoundBuffer`), audio streams
 /// are never completely loaded in memory. Instead, the audio
 /// data is acquired continuously while the stream is playing.
-/// This behavior allows to play a sound with no loading delay,
+/// This behavior allows for playing a sound with no loading delay,
 /// and keeps the memory consumption very low.
 ///
 /// Sound sources that need to be streamed are usually big files

include/SFML/Graphics/Shape.hpp

@@ -328,8 +328,8 @@ private:
 /// \class sf::Shape
 /// \ingroup graphics
 ///
-/// `sf::Shape` is a drawable class that allows to define and
+/// `sf::Shape` is a drawable class that allows for defining and
-/// display a custom convex shape on a render target.
+/// displaying a custom convex shape on a render target.
 /// It's only an abstract base, it needs to be specialized for
 /// concrete types of shapes (circle, rectangle, convex polygon,
 /// star, ...).

include/SFML/Graphics/Sprite.hpp

@@ -231,7 +231,7 @@ private:
 /// \class sf::Sprite
 /// \ingroup graphics
 ///
-/// `sf::Sprite` is a drawable class that allows to easily display
+/// `sf::Sprite` is a drawable class that allows for easily displaying
 /// a texture (or a part of it) on a render target.
 ///
 /// It inherits all the functions from `sf::Transformable`:

include/SFML/Graphics/Text.hpp

@@ -435,7 +435,7 @@ private:
 /// \class sf::Text
 /// \ingroup graphics
 ///
-/// `sf::Text` is a drawable class that allows to easily display
+/// `sf::Text` is a drawable class that allows for easily displaying
 /// some text with custom style and color on a render target.
 ///
 /// It inherits all the functions from `sf::Transformable`:

include/SFML/Graphics/View.hpp

@@ -286,7 +286,7 @@ private:
 /// which defines where the contents of the source rectangle
 /// will be displayed on the render target (window or texture).
 ///
-/// The viewport allows to map the scene to a custom part
+/// The viewport allows for mapping the scene to a custom part
 /// of the render target, and can be used for split-screen
 /// or for displaying a minimap, for example. If the source
 /// rectangle doesn't have the same size as the viewport, its

include/SFML/Network/Packet.hpp

@@ -165,7 +165,7 @@ public:
     ////////////////////////////////////////////////////////////
     /// \brief Test the validity of the packet, for reading
     ///
-    /// This operator allows to test the packet as a boolean
+    /// This operator allows for testing the packet as a boolean
     /// variable, to check if a reading operation was successful.
     ///
     /// A packet will be in an invalid state if it has no more
@@ -513,7 +513,7 @@ private:
 /// }
 /// \endcode
 ///
-/// Packets also provide an extra feature that allows to apply
+/// Packets also provide an extra feature that allows for applying
 /// custom transformations to the data before it is sent,
 /// and after it is received. This is typically used to
 /// handle automatic compression or encryption of the data.

include/SFML/Network/SocketSelector.hpp

@@ -39,7 +39,7 @@ namespace sf
 class Socket;
 
 ////////////////////////////////////////////////////////////
-/// \brief Multiplexer that allows to read from multiple sockets
+/// \brief Multiplexer that allows for reading from multiple sockets
 ///
 ////////////////////////////////////////////////////////////
 class SFML_NETWORK_API SocketSelector

include/SFML/System/FileInputStream.hpp

@@ -186,7 +186,7 @@ private:
 /// reads from a file on disk.
 ///
 /// It wraps a file in the common `InputStream` interface
-/// and therefore allows to use generic classes or functions
+/// and therefore allows for using generic classes or functions
 /// that accept such a stream, with a file on disk as the data
 /// source.
 ///

include/SFML/System/MemoryInputStream.hpp

@@ -115,7 +115,7 @@ private:
 /// reads from data in memory.
 ///
 /// It wraps a memory chunk in the common `InputStream` interface
-/// and therefore allows to use generic classes or functions
+/// and therefore allows for using generic classes or functions
 /// that accept such a stream, with content already loaded in memory.
 ///
 /// In addition to the virtual functions inherited from

include/SFML/System/Time.hpp

@@ -452,7 +452,7 @@ constexpr Time& operator%=(Time& left, Time right);
 /// \ingroup system
 ///
 /// `sf::Time` encapsulates a time value in a flexible way.
-/// It allows to define a time value either as a number of
+/// It allows for defining a time value either as a number of
 /// seconds, milliseconds or microseconds. It also works the
 /// other way round: you can read a time value as either
 /// a number of seconds, milliseconds or microseconds. It

include/SFML/Window/ContextSettings.hpp

@@ -68,7 +68,7 @@ struct ContextSettings
 /// \class sf::ContextSettings
 /// \ingroup window
 ///
-/// ContextSettings allows to define several advanced settings
+/// ContextSettings allows for defining several advanced settings
 /// of the OpenGL context attached to a window. All these
 /// settings with the exception of the compatibility flag
 /// and anti-aliasing level have no impact on the regular

include/SFML/Window/VideoMode.hpp

@@ -201,7 +201,7 @@ public:
 ///
 /// Additionally, `sf::VideoMode` provides a static function
 /// to get the mode currently used by the desktop: `getDesktopMode()`.
-/// This allows to build windows with the same size or pixel
+/// This allows for building windows with the same size or pixel
 /// depth as the current resolution.
 ///
 /// Usage example:

src/SFML/Window/macOS/SFWindow.h

@@ -35,7 +35,7 @@
 @interface SFWindow : NSWindow
 
 ////////////////////////////////////////////////////////////
-/// \brief Allow to grab fullscreen events
+/// \brief Allow for grabbing fullscreen events
 ///
 /// acceptsFirstResponder and canBecomeKeyWindow messages must
 /// return YES to grab fullscreen events.
@@ -48,7 +48,7 @@
 - (BOOL)acceptsFirstResponder;
 
 ////////////////////////////////////////////////////////////
-/// \brief Allow to grab fullscreen events
+/// \brief Allow for grabbing fullscreen events
 ///
 /// See acceptsFirstResponder documentation above.
 ///