gosu 1.3.0 → 1.4.0

data/include/Gosu/Graphics.hpp

@@ -1,6 +1,3 @@
-//! \file Graphics.hpp
-//! Interface of the Graphics class.
-
 #pragma once
 
 #include <Gosu/Fwd.hpp>
@@ -12,19 +9,17 @@
 namespace Gosu
 {
     struct DrawOp;
-    
-    //! Returns the maximum size of an texture that will be allocated
-    //! internally by Gosu.
-    //! Useful when extending Gosu using OpenGL.
+
+    /// Returns the maximum size of an texture that will be allocated internally by Gosu.
+    /// Useful when extending Gosu using OpenGL.
     const unsigned MAX_TEXTURE_SIZE = 1024;
-    
-    //! Serves as the target of all drawing and provides primitive drawing
-    //! functionality.
-    //! Usually created internally by Gosu::Window.
+
+    /// Serves as the target of all drawing and provides primitive drawing functionality.
+    /// Usually created internally by Gosu::Window.
     class Graphics
     {
         struct Impl;
-        std::unique_ptr<Impl> pimpl;
+        std::unique_ptr<Impl> m_impl;
 
     public:
         Graphics(unsigned physical_width, unsigned physical_height);
@@ -32,80 +27,72 @@ namespace Gosu
 
         void set_resolution(unsigned logical_width, unsigned logical_height,
                             double black_bar_width = 0, double black_bar_height = 0);
-        
+
         unsigned width() const;
         unsigned height() const;
 
-        //! Prepares the graphics object for drawing and then runs the rendering code in f.
-        //! Nothing must be drawn outside of frame() and record().
-        void frame(const std::function<void ()>& f);
-        
-        //! Flushes the Z queue to the screen and starts a new one.
-        //! This can be useful to separate the Z queues of two parts of the game, e.g. the two
-        //! halves of a game that runs in split-screen mode.
+        /// Prepares the graphics object for drawing and then runs the rendering code in f.
+        /// Nothing must be drawn outside of frame() and record().
+        void frame(const std::function<void()>& f);
+
+        /// Flushes the Z queue to the screen and starts a new one.
+        /// This can be useful to separate the Z queues of two parts of the game, e.g. the two
+        /// halves of a game that runs in split-screen mode.
         static void flush();
-        
-        //! Finishes all pending Gosu drawing operations and executes the code in f in a clean
-        //! OpenGL environment.
-        static void gl(const std::function<void ()>& f);
-
-        //! Schedules a custom GL functor to be executed at a certain Z level.
-        //! The functor f is run in a clean GL context.
-        //! Note: You may not call any Gosu rendering functions from within the
-        //! functor.
-        static void gl(ZPos z, const std::function<void ()>& f);
-        
-        //! Renders everything drawn in f clipped to a rectangle on the screen.
+
+        /// Finishes all pending Gosu drawing operations and executes the code in f in a clean
+        /// OpenGL environment.
+        static void gl(const std::function<void()>& f);
+
+        /// Schedules a custom GL functor to be executed at a certain Z level.
+        /// The functor f is run in a clean GL context.
+        /// Note: You may not call any Gosu rendering functions from within the functor.
+        static void gl(ZPos z, const std::function<void()>& f);
+
+        /// Renders everything drawn in f clipped to a rectangle on the screen.
         static void clip_to(double x, double y, double width, double height,
-                            const std::function<void ()>& f);
-        
-        //! Renders everything drawn in f onto a new Image of size (width, height).
-        //! \param image_flags Pass Gosu::IF_RETRO if you do not want the resulting image to use
-        //! interpolation when it is scaled or rotated.
-        static Gosu::Image render(int width, int height, const std::function<void ()>& f,
+                            const std::function<void()>& f);
+
+        /// Renders everything drawn in f onto a new Image of size (width, height).
+        /// @param image_flags Pass Gosu::IF_RETRO if you do not want the resulting image to use
+        /// interpolation when it is scaled or rotated.
+        static Gosu::Image render(int width, int height, const std::function<void()>& f,
                                   unsigned image_flags = 0);
-        
-        //! Records a macro and returns it as an Image.
-        static Gosu::Image record(int width, int height, const std::function<void ()>& f);
-        
-        //! Pushes one transformation onto the transformation stack.
-        static void transform(const Transform& transform,
-                              const std::function<void ()>& f);
-
-        //! Draws a line from one point to another (last pixel exclusive).
-        //! Note: OpenGL lines are not reliable at all and may have a missing pixel at the start
-        //! or end point. Please only use this for debugging purposes. Otherwise, use a quad or
-        //! image to simulate lines, or contribute a better draw_line to Gosu.
-        static void draw_line(double x1, double y1, Color c1,
-                              double x2, double y2, Color c2,
+
+        /// Records a macro and returns it as an Image.
+        static Gosu::Image record(int width, int height, const std::function<void()>& f);
+
+        /// Pushes one transformation onto the transformation stack.
+        static void transform(const Transform& transform, const std::function<void()>& f);
+
+        /// Draws a line from one point to another (last pixel exclusive).
+        /// Note: OpenGL lines are not reliable at all and may have a missing pixel at the start
+        /// or end point. Please only use this for debugging purposes. Otherwise, use a quad or
+        /// image to simulate lines, or contribute a better draw_line to Gosu.
+        static void draw_line(double x1, double y1, Color c1, double x2, double y2, Color c2,
                               ZPos z, BlendMode mode = BM_DEFAULT);
 
-        static void draw_triangle(double x1, double y1, Color c1,
-                                  double x2, double y2, Color c2,
-                                  double x3, double y3, Color c3,
-                                  ZPos z,
-                                  BlendMode mode = BM_DEFAULT);
+        static void draw_triangle(double x1, double y1, Color c1, //
+                                  double x2, double y2, Color c2, //
+                                  double x3, double y3, Color c3, //
+                                  ZPos z, BlendMode mode = BM_DEFAULT);
 
-        static void draw_quad(double x1, double y1, Color c1,
-                              double x2, double y2, Color c2,
-                              double x3, double y3, Color c3,
-                              double x4, double y4, Color c4,
+        static void draw_quad(double x1, double y1, Color c1, double x2, double y2, Color c2,
+                              double x3, double y3, Color c3, double x4, double y4, Color c4,
                               ZPos z, BlendMode mode = BM_DEFAULT);
-        
-        static void draw_rect(double x, double y, double width, double height,
-                              Color c, ZPos z,
+
+        static void draw_rect(double x, double y, double width, double height, Color c, ZPos z,
                               BlendMode mode = BM_DEFAULT);
 
-        //! For internal use only.
+        /// For internal use only.
         void set_physical_resolution(unsigned physical_width, unsigned physical_height);
 
-        //! For internal use only.
+        /// For internal use only.
         static void schedule_draw_op(const DrawOp& op);
 
-        //! Turns a portion of a bitmap into something that can be drawn on a Graphics object.
-        static std::unique_ptr<ImageData> create_image(const Bitmap& src,
-                                                       unsigned src_x,     unsigned src_y,
-                                                       unsigned src_width, unsigned src_height,
-                                                       unsigned image_flags);
+        /// Turns a portion of a bitmap into something that can be drawn on a Graphics object.
+        static std::unique_ptr<ImageData> create_image(const Bitmap& src, unsigned src_x,
+                                                       unsigned src_y, unsigned src_width,
+                                                       unsigned src_height, unsigned image_flags);
     };
 }

data/include/Gosu/GraphicsBase.hpp

@@ -1,6 +1,3 @@
-//! \file GraphicsBase.hpp
-//! Contains general typedefs and enums related to graphics.
-
 #pragma once
 
 #include <Gosu/Platform.hpp>
@@ -8,35 +5,32 @@
 
 namespace Gosu
 {
-    //! Represents the Z position of something drawn with Gosu's graphics
-    //! system. Draw calls with higher ZPos values will cover those with a
-    //! lower ZPos value.
+    /// Represents the Z position of something drawn with Gosu's graphics system.
+    /// Draw calls with higher ZPos values will cover those with a lower ZPos value.
     typedef double ZPos;
-    
-    //! Determines the way colors are combined when one is drawn onto
-    //! another.
+
+    /// Determines the way pixel colors are combined when images overlap.
     enum BlendMode
     {
         BM_DEFAULT,
-        //! The color's channels will be interpolated. The alpha channel
-        //! specifies the opacity of the new color, 255 is full opacity.
+        /// The color's channels will be interpolated. The alpha channel specifies the opacity of
+        /// the new color, 255 is full opacity.
         BM_INTERPOLATE = BM_DEFAULT,
-        //! The colors' channels will be added. The alpha channel specifies
-        //! the percentage of the new color's channels that will be added
-        //! to the old color's channels.
+        /// The colors' channels will be added. The alpha channel specifies the percentage of the
+        /// new color's channels that will be added to the old color's channels.
         BM_ADD,
-        //! The color's channels will be multiplied with each other.
+        /// The color's channels will be multiplied with each other.
         BM_MULTIPLY
     };
-    
+
     enum FontFlags
     {
-        FF_BOLD         = 1,
-        FF_ITALIC       = 2,
-        FF_UNDERLINE    = 4,
+        FF_BOLD = 1,
+        FF_ITALIC = 2,
+        FF_UNDERLINE = 4,
         FF_COMBINATIONS = 8
     };
-    
+
     enum Alignment
     {
         AL_LEFT,
@@ -44,26 +38,25 @@ namespace Gosu
         AL_CENTER,
         AL_JUSTIFY
     };
-    
-    //! Flags that affect the tileability or interpolation of an image.
+
+    /// Flags that affect the tileability or interpolation of an image.
     enum ImageFlags
     {
         IF_SMOOTH = 0,
-        
+
         // Note: No constant for '1', but Gosu treats '1' as IF_TILEABLE for
         // backward compatibility reasons (this parameter used to be a bool).
-        
-        IF_TILEABLE_LEFT   = 1 << 1,
-        IF_TILEABLE_TOP    = 1 << 2,
-        IF_TILEABLE_RIGHT  = 1 << 3,
+
+        IF_TILEABLE_LEFT = 1 << 1,
+        IF_TILEABLE_TOP = 1 << 2,
+        IF_TILEABLE_RIGHT = 1 << 3,
         IF_TILEABLE_BOTTOM = 1 << 4,
-        IF_TILEABLE        = IF_TILEABLE_LEFT | IF_TILEABLE_TOP | IF_TILEABLE_RIGHT | IF_TILEABLE_BOTTOM,
-        
-        //! Apply nearest-neighbor interpolation when scaling this image up or
-        //! down.
-        IF_RETRO           = 1 << 5
+        IF_TILEABLE = IF_TILEABLE_LEFT | IF_TILEABLE_TOP | IF_TILEABLE_RIGHT | IF_TILEABLE_BOTTOM,
+
+        /// Apply nearest-neighbor interpolation when scaling this image up or down.
+        IF_RETRO = 1 << 5
     };
-    
+
     typedef std::array<double, 16> Transform;
     Transform translate(double x, double y);
     Transform rotate(double angle, double around_x = 0, double around_y = 0);

data/include/Gosu/Image.hpp

@@ -1,6 +1,3 @@
-//! \file Image.hpp
-//! Interface of the Image class and helper functions.
-
 #pragma once
 
 #include <Gosu/Fwd.hpp>
@@ -12,80 +9,77 @@
 
 namespace Gosu
 {
-    //! Provides functionality for drawing rectangular images.
+    /// Provides functionality for drawing rectangular images.
     class Image
     {
-        std::shared_ptr<ImageData> data_;
+        std::shared_ptr<ImageData> m_data;
 
     public:
-        //! Creates an empty image. It will have a width and height of 0, and not contain anything.
+        /// Creates an empty image. It will have a width and height of 0, and not contain anything.
         Image();
-        
-        //! Loads an image from a given filename.
-        //!
-        //! A color key of #ff00ff is automatically applied to BMP image files.
-        //! For more flexibility, use the corresponding constructor that uses a Bitmap object.
+
+        /// Loads an image from a given filename.
+        ///
+        /// A color key of #ff00ff is automatically applied to BMP image files.
+        /// For more flexibility, use the corresponding constructor that uses a Bitmap object.
         explicit Image(const std::string& filename, unsigned image_flags = IF_SMOOTH);
-        
+
         //! Loads a portion of the the image at the given filename..
-        //!
-        //! A color key of #ff00ff is automatically applied to BMP image files.
-        //! For more flexibility, use the corresponding constructor that uses a Bitmap object.
-        Image(const std::string& filename, int src_x, int src_y,
-            int src_width, int src_height, unsigned image_flags = IF_SMOOTH);
-        
-        //! Converts the given bitmap into an image.
+        ///
+        /// A color key of #ff00ff is automatically applied to BMP image files.
+        /// For more flexibility, use the corresponding constructor that uses a Bitmap object.
+        Image(const std::string& filename, int src_x, int src_y, int src_width, int src_height,
+              unsigned image_flags = IF_SMOOTH);
+
+        /// Converts the given bitmap into an image.
         explicit Image(const Bitmap& source, unsigned image_flags = IF_SMOOTH);
-        
-        //! Converts a portion of the given bitmap into an image.
-        Image(const Bitmap& source, int src_x, int src_y, int src_width,
-              int src_height, unsigned image_flags = IF_SMOOTH);
-        
-        //! Creates an Image from a user-supplied instance of the ImageData interface.
+
+        /// Converts a portion of the given bitmap into an image.
+        Image(const Bitmap& source, int src_x, int src_y, int src_width, int src_height,
+              unsigned image_flags = IF_SMOOTH);
+
+        /// Creates an Image from a user-supplied instance of the ImageData interface.
         explicit Image(std::unique_ptr<ImageData>&& data);
 
         unsigned width() const;
         unsigned height() const;
 
-        //! Draws the image so its upper left corner is at (x; y).
+        /// Draws the image so its upper left corner is at (x; y).
         void draw(double x, double y, ZPos z = 0, double scale_x = 1, double scale_y = 1,
-            Color c = Color::WHITE, BlendMode mode = BM_DEFAULT) const;
-        //! Like draw(), but with modulation colors for all four corners.
-        void draw_mod(double x, double y, ZPos z, double scale_x, double scale_y,
-            Color c1, Color c2, Color c3, Color c4, BlendMode mode = BM_DEFAULT) const;
+                  Color c = Color::WHITE, BlendMode mode = BM_DEFAULT) const;
+        /// Like draw(), but with modulation colors for all four corners.
+        void draw_mod(double x, double y, ZPos z, double scale_x, double scale_y, Color c1,
+                      Color c2, Color c3, Color c4, BlendMode mode = BM_DEFAULT) const;
+
+        /// Draws the image rotated by the given angle so that its rotation center is at (x; y).
+        /// Note that this is different from how all the other drawing functions work!
+        /// @param angle See Math.hpp for an explanation of how Gosu interprets angles.
+        /// @param center_x Relative horizontal position of the rotation center on the image.
+        /// 0 is the left border, 1 is the right border, 0.5 is the center (and default).
+        /// @param center_y See center_x.
+        void draw_rot(double x, double y, ZPos z = 0, double angle = 0, double center_x = 0.5,
+                      double center_y = 0.5, double scale_x = 1, double scale_y = 1,
+                      Color c = Color::WHITE, BlendMode mode = BM_DEFAULT) const;
 
-        //! Draws the image rotated by the given angle so that its rotation
-        //! center is at (x; y). Note that this is different from how all the
-        //! other drawing functions work!
-        //! \param angle See Math.hpp for an explanation of how Gosu interprets
-        //! angles.
-        //! \param center_x Relative horizontal position of the rotation center
-        //! on the image. 0 is the left border, 1 is the right border, 0.5 is
-        //! the center (and default).
-        //! \param center_y See center_x.
-        void draw_rot(double x, double y, ZPos z = 0, double angle = 0,
-            double center_x = 0.5, double center_y = 0.5, double scale_x = 1, double scale_y = 1,
-            Color c = Color::WHITE, BlendMode mode = BM_DEFAULT) const;
-        
-        #ifndef SWIG
-        //! Provides access to the underlying image data object.
+#ifndef SWIG
+        /// Provides access to the underlying image data object.
         ImageData& data() const;
-        #endif
+#endif
     };
-    
-    #ifndef SWIG
-    //! Convenience function that slices an image file into a grid and creates images from them.
-    //! \param tile_width If positive, specifies the width of one tile in pixels.
-    //! If negative, the bitmap is divided into -tile_width rows.
-    //! \param tile_height See tile_width.
-    std::vector<Gosu::Image> load_tiles(const Bitmap& bmp,
-        int tile_width, int tile_height, unsigned image_flags = IF_SMOOTH);
-    
-    //! Convenience function that slices a bitmap into a grid and creates images from them.
-    //! \param tile_width If positive, specifies the width of one tile in pixels.
-    //! If negative, the bitmap is divided into -tile_width rows.
-    //! \param tile_height See tile_width.
-    std::vector<Gosu::Image> load_tiles(const std::string& filename,
-        int tile_width, int tile_height, unsigned image_flags = IF_SMOOTH);
-    #endif
+
+#ifndef SWIG
+    /// Convenience function that slices an image file into a grid and creates images from them.
+    /// @param tile_width If positive, specifies the width of one tile in pixels.
+    /// If negative, the bitmap is divided into -tile_width rows.
+    /// @param tile_height See tile_width.
+    std::vector<Gosu::Image> load_tiles(const Bitmap& bmp, int tile_width, int tile_height,
+                                        unsigned image_flags = IF_SMOOTH);
+
+    /// Convenience function that slices a bitmap into a grid and creates images from them.
+    /// @param tile_width If positive, specifies the width of one tile in pixels.
+    /// If negative, the bitmap is divided into -tile_width rows.
+    /// @param tile_height See tile_width.
+    std::vector<Gosu::Image> load_tiles(const std::string& filename, int tile_width,
+                                        int tile_height, unsigned image_flags = IF_SMOOTH);
+#endif
 }

data/include/Gosu/ImageData.hpp

@@ -1,6 +1,3 @@
-//! \file ImageData.hpp
-//! Interface of the ImageData class.
-
 #pragma once
 
 #include <Gosu/Fwd.hpp>
@@ -11,47 +8,46 @@
 
 namespace Gosu
 {
-    //! Contains information about the underlying OpenGL texture and the
-    //! u/v space used for image data. Can be retrieved from some images
-    //! to use them in OpenGL operations.
+    /// Contains information about the underlying OpenGL texture and the u/v space used for image
+    /// data. Can be retrieved from some images to use them in OpenGL operations.
     struct GLTexInfo
     {
         int tex_name;
         double left, right, top, bottom;
     };
 
-    //! The ImageData class is an abstract base class for drawable images.
-    //! Instances of classes derived by ImageData are usually returned by
-    //! Graphics::create_image and usually only used to implement drawing
-    //! primitives like Image, which then provide a more specialized and
-    //! intuitive drawing interface.
+    /// The ImageData class is an abstract base class for drawable images.
+    /// Instances of classes derived by ImageData are usually returned by Graphics::create_image and
+    /// usually only used to implement drawing primitives like Image, which then provide a more
+    /// specialized and intuitive drawing interface.
     class ImageData
     {
-        // Non-copyable
-        ImageData(const ImageData&);
-        ImageData& operator=(const ImageData&);
-        
     public:
-        ImageData() {}
-        
-        virtual ~ImageData() {}
+        // Classes inside a hierarchy should not be copyable to avoid slicing.
+        ImageData(const ImageData&) = delete;
+        ImageData(ImageData&&) = delete;
+        ImageData& operator=(const ImageData&) = delete;
+        ImageData& operator=(ImageData&&) = delete;
+
+        ImageData() = default;
+        virtual ~ImageData() = default;
 
         virtual int width() const = 0;
-        
+
         virtual int height() const = 0;
 
-        virtual void draw(double x1, double y1, Color c1,
-            double x2, double y2, Color c2,
-            double x3, double y3, Color c3,
-            double x4, double y4, Color c4,
-            ZPos z, BlendMode mode) const = 0;
+        virtual void draw(double x1, double y1, Color c1, //
+                          double x2, double y2, Color c2, //
+                          double x3, double y3, Color c3, //
+                          double x4, double y4, Color c4, //
+                          ZPos z, BlendMode mode) const = 0;
 
         virtual const GLTexInfo* gl_tex_info() const = 0;
-        
+
         virtual Bitmap to_bitmap() const = 0;
-        
+
         virtual std::unique_ptr<ImageData> subimage(int x, int y, int width, int height) const = 0;
-        
+
         virtual void insert(const Bitmap& bitmap, int x, int y) = 0;
     };
 }

data/include/Gosu/Inspection.hpp

@@ -1,10 +1,7 @@
-//! \file Inspection.hpp
-//! A special set of functions designed for tuning Gosu games.
-
 #pragma once
 
 namespace Gosu
 {
-    //! Returns the current framerate.
+    /// Returns the current framerate.
     int fps();
 }

data/include/Gosu/TextInput.hpp

@@ -1,6 +1,3 @@
-//! \file TextInput.hpp
-//! Interface of the TextInput class.
-
 #pragma once
 
 #include <Gosu/Fwd.hpp>
@@ -10,67 +7,64 @@
 
 namespace Gosu
 {
-    //! TextInput instances are invisible objects that build a text string from input,
-    //! using the current operating system's keyboard layout.
-    //! At its most basic form, you only need to create a new TextInput instance and
-    //! pass it to your window via set_text_input. Until you call this function again,
-    //! passing nullptr, the TextInput object will build a text that can be accessed via
-    //! TextInput::text().
-    //! A TextInput object is purely abstract. It is up to you to actually draw a text field.
-    //! TextInput only provides a portable base for your own GUI to build upon.
+    /// TextInput instances are invisible objects that build a text string from input, using the
+    /// current operating system's keyboard layout or input method editor (IME).
+    /// To start processing keyboard text input, you need to create a new TextInput instance and
+    /// pass it to your window's Input object via set_text_input.
+    /// Until you call this function again with a nullptr value, the TextInput object will then
+    /// build a text that can be accessed via TextInput::text().
+    /// A TextInput object has no built-in UI. It is up to you to actually draw a text field.
+    /// TextInput only provides a portable base for your own GUI to build upon.
     class TextInput
     {
         struct Impl;
         // Non-movable (const) to avoid dangling references to TextInput instances.
-        const std::unique_ptr<Impl> pimpl;
-        
+        const std::unique_ptr<Impl> m_impl;
+
     public:
         TextInput();
         virtual ~TextInput();
 
         std::string text() const;
 
-        //! Replaces the current text by the given string and positions the cursor
-        //! at the end of the text, with an empty selection.
+        /// Replaces the current text by the given string and positions the cursor at the end of the
+        /// text, with an empty selection.
         void set_text(const std::string& text);
 
-        //! Index of the character that comes after the caret. When the text is empty, this is
-        //! always 0. For ease of use in C++, this counts bytes, not codepoints in the UTF-8 encoded
-        //! string.
+        /// Index of the character that comes after the caret. When the text is empty, this is
+        /// always 0. For ease of use in C++, this counts bytes, not codepoints, in the UTF-8
+        /// encoded string.
         unsigned caret_pos() const;
-        //! Sets the caret position as returned by caret_pos.
-        //! You usually also want to use set_selection_start.
+        /// Sets the caret position as returned by caret_pos.
+        /// You usually also want to use set_selection_start.
         void set_caret_pos(unsigned pos);
 
-        //! If there is a selection, the selection_start() member yields its beginning,
-        //! using the same indexing scheme as caret_pos. If there is no selection,
-        //! selection_start() is equal to caret_pos().
+        /// If there is a selection, the selection_start() member yields its beginning, using the
+        /// same indexing scheme as caret_pos. If there is no selection, selection_start() is equal
+        /// to caret_pos().
         unsigned selection_start() const;
-        //! Sets the start of the selection as returned by selection_start.
+        /// Sets the start of the selection as returned by selection_start.
         void set_selection_start(unsigned pos);
-        
+
 #ifndef GOSU_IS_IPHONE
         // Platform-specific communication with Gosu::Input.
         bool feed_sdl_event(void* event);
 #endif
 
-        //! Overridable filter that is applied to all new text that is entered.
-        //! Allows for context-sensitive filtering/extending/... of new characters.
-        //! The return value will be inserted at caret_pos.
-        virtual std::string filter(std::string text) const
-        {
-            return text;
-        }
-        
-        //! Replaces the current selection (if any) and inserts the given string at the current
-        //! caret position.
-        //! The filter method will not be applied before appending the string.
+        /// Overridable filter that is applied to all new text that is entered.
+        /// Allows for context-sensitive filtering/extending/... of new characters.
+        /// The return value will be inserted at caret_pos.
+        virtual std::string filter(std::string text) const { return text; }
+
+        /// Replaces the current selection (if any) and inserts the given string at the current
+        /// caret position.
+        /// The filter method will not be applied before appending the string.
         void insert_text(std::string text);
-        
-        //! Deletes the current selection, if any, or the next character.
+
+        /// Deletes the current selection, if any, or the next character.
         void delete_forward();
-        
-        //! Deletes the current selection, if any, or the previous character.
+
+        /// Deletes the current selection, if any, or the previous character.
         void delete_backward();
     };
 }

data/include/Gosu/Version.hpp

@@ -3,7 +3,7 @@
 #include <string>
 
 #define GOSU_MAJOR_VERSION 1
-#define GOSU_MINOR_VERSION 3
+#define GOSU_MINOR_VERSION 4
 #define GOSU_POINT_VERSION 0
 
 namespace Gosu