summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2018-06-25 19:21:08 -0400
committerMatthias Clasen <mclasen@redhat.com>2018-06-25 19:55:04 -0400
commit8755d884f3e5043f355d4c6403e954ea5ff0928f (patch)
tree36ccc605c99d88687b1af5c6d2897086b3722bda
parent010f4e90e38fd71967428486fd986e4dfc444c7b (diff)
downloadgtk+-8755d884f3e5043f355d4c6403e954ea5ff0928f.tar.gz
Remove a lot of Since annotations
4.0 will represent a clean epoch. We don't want to have lots of noise in the docs about 2.x or 3.x.
-rw-r--r--gdk/gdkdevicetool.h2
-rw-r--r--gdk/gdkdisplay.c2
-rw-r--r--gdk/gdkdnd.h2
-rw-r--r--gdk/gdkevents.c2
-rw-r--r--gdk/gdkevents.h12
-rw-r--r--gdk/gdkeventsprivate.h10
-rw-r--r--gdk/gdkframeclock.h2
-rw-r--r--gdk/gdkmonitor.h2
-rw-r--r--gdk/gdkseat.h4
-rw-r--r--gdk/gdksurface.h26
-rw-r--r--gdk/gdktypes.h44
-rw-r--r--gdk/wayland/gdkdisplay-wayland.c2
-rw-r--r--gsk/gskenums.h6
-rw-r--r--gsk/gskroundedrect.h4
-rw-r--r--gtk/gtkaccelgroup.c2
-rw-r--r--gtk/gtkbbox.h4
-rw-r--r--gtk/gtkcellareacontext.c4
-rw-r--r--gtk/gtkcellrenderer.h4
-rw-r--r--gtk/gtkcellrenderertext.c2
-rw-r--r--gtk/gtkcontainer.c4
-rw-r--r--gtk/gtkcsssection.h2
-rw-r--r--gtk/gtkdialog.h2
-rw-r--r--gtk/gtkentry.c4
-rw-r--r--gtk/gtkenums.h10
-rw-r--r--gtk/gtkeventcontrollerkey.c2
-rw-r--r--gtk/gtkgesturestylus.c2
-rw-r--r--gtk/gtkicontheme.h12
-rw-r--r--gtk/gtklabel.c2
-rw-r--r--gtk/gtkmain.c2
-rw-r--r--gtk/gtkplacessidebar.c2
-rw-r--r--gtk/gtkprinter.h4
-rw-r--r--gtk/gtksearchbar.c4
-rw-r--r--gtk/gtksearchentry.c4
-rw-r--r--gtk/gtkstack.c2
-rw-r--r--gtk/gtktextbuffer.c6
-rw-r--r--gtk/gtkwidget.c2
-rw-r--r--gtk/gtkwindow.c2
-rw-r--r--modules/printbackends/gtkprintercups.c2
38 files changed, 57 insertions, 149 deletions
diff --git a/gdk/gdkdevicetool.h b/gdk/gdkdevicetool.h
index 4954592ea2..66bab7e699 100644
--- a/gdk/gdkdevicetool.h
+++ b/gdk/gdkdevicetool.h
@@ -47,8 +47,6 @@ typedef struct _GdkDeviceTool GdkDeviceTool;
*
* Indicates the specific type of tool being used being a tablet. Such as an
* airbrush, pencil, etc.
- *
- * Since: 3.22
*/
typedef enum {
GDK_DEVICE_TOOL_TYPE_UNKNOWN,
diff --git a/gdk/gdkdisplay.c b/gdk/gdkdisplay.c
index 8485e4f893..3375cb3ebd 100644
--- a/gdk/gdkdisplay.c
+++ b/gdk/gdkdisplay.c
@@ -1288,8 +1288,6 @@ gdk_display_notify_startup_complete (GdkDisplay *display,
* if no ID has been defined.
*
* Returns: the startup notification ID for @display, or %NULL
- *
- * Since: 4.0
*/
const gchar *
gdk_display_get_startup_notification_id (GdkDisplay *display)
diff --git a/gdk/gdkdnd.h b/gdk/gdkdnd.h
index caf79151bb..30e391b1ac 100644
--- a/gdk/gdkdnd.h
+++ b/gdk/gdkdnd.h
@@ -46,8 +46,6 @@ G_BEGIN_DECLS
* @GDK_DRAG_CANCEL_ERROR: Unspecified error.
*
* Used in #GdkDragContext to the reason of a cancelled DND operation.
- *
- * Since: 3.20
*/
typedef enum {
GDK_DRAG_CANCEL_NO_TARGET,
diff --git a/gdk/gdkevents.c b/gdk/gdkevents.c
index 272fe4429f..178bbd3b85 100644
--- a/gdk/gdkevents.c
+++ b/gdk/gdkevents.c
@@ -2504,8 +2504,6 @@ gdk_event_get_axes (GdkEvent *event,
*
* Returns: (transfer container) (element-type GdkTimeCoord) (nullable): a list
* of time and coordinates
- *
- * Since: 3.94
*/
GList *
gdk_event_get_motion_history (const GdkEvent *event)
diff --git a/gdk/gdkevents.h b/gdk/gdkevents.h
index a43e7b4394..e8577af1a1 100644
--- a/gdk/gdkevents.h
+++ b/gdk/gdkevents.h
@@ -67,8 +67,6 @@ G_BEGIN_DECLS
*
* Use this macro as the return value for continuing the propagation of
* an event handler.
- *
- * Since: 3.4
*/
#define GDK_EVENT_PROPAGATE (FALSE)
@@ -77,8 +75,6 @@ G_BEGIN_DECLS
*
* Use this macro as the return value for stopping the propagation of
* an event handler.
- *
- * Since: 3.4
*/
#define GDK_EVENT_STOP (TRUE)
@@ -87,8 +83,6 @@ G_BEGIN_DECLS
*
* The primary button. This is typically the left mouse button, or the
* right button in a left-handed setup.
- *
- * Since: 3.4
*/
#define GDK_BUTTON_PRIMARY (1)
@@ -96,8 +90,6 @@ G_BEGIN_DECLS
* GDK_BUTTON_MIDDLE:
*
* The middle button.
- *
- * Since: 3.4
*/
#define GDK_BUTTON_MIDDLE (2)
@@ -106,8 +98,6 @@ G_BEGIN_DECLS
*
* The secondary button. This is typically the right mouse button, or the
* left button in a left-handed setup.
- *
- * Since: 3.4
*/
#define GDK_BUTTON_SECONDARY (3)
@@ -291,7 +281,7 @@ typedef enum
* @GDK_SCROLL_LEFT: the surface is scrolled to the left.
* @GDK_SCROLL_RIGHT: the surface is scrolled to the right.
* @GDK_SCROLL_SMOOTH: the scrolling is determined by the delta values
- * in scroll events. See gdk_event_get_scroll_deltas(). Since: 3.4
+ * in scroll events. See gdk_event_get_scroll_deltas()
*
* Specifies the direction for scroll events.
*/
diff --git a/gdk/gdkeventsprivate.h b/gdk/gdkeventsprivate.h
index d79beab255..b706c6f383 100644
--- a/gdk/gdkeventsprivate.h
+++ b/gdk/gdkeventsprivate.h
@@ -276,7 +276,7 @@ struct _GdkEventScroll
* @hardware_keycode: the raw code of the key that was pressed or released.
* @group: the keyboard group.
* @is_modifier: a flag that indicates if @hardware_keycode is mapped to a
- * modifier. Since 2.10
+ * modifier
*
* Describes a key press or key release event.
*/
@@ -414,8 +414,6 @@ struct _GdkEventProximity
* is unmapped), or if the same application grabs the pointer or keyboard
* again. Note that implicit grabs (which are initiated by button presses)
* can also cause #GdkEventGrabBroken events.
- *
- * Since: 2.8
*/
struct _GdkEventGrabBroken {
GdkEventAny any;
@@ -536,8 +534,6 @@ struct _GdkEventTouchpadPinch {
* device may have different current modes.
*
* Generated during %GDK_SOURCE_TABLET_PAD button presses and releases.
- *
- * Since: 3.22
*/
struct _GdkEventPadButton {
GdkEventAny any;
@@ -562,8 +558,6 @@ struct _GdkEventPadButton {
* @value: The current value for the given axis.
*
* Generated during %GDK_SOURCE_TABLET_PAD interaction with tactile sensors.
- *
- * Since: 3.22
*/
struct _GdkEventPadAxis {
GdkEventAny any;
@@ -587,8 +581,6 @@ struct _GdkEventPadAxis {
* device may have different current modes.
*
* Generated during %GDK_SOURCE_TABLET_PAD mode switches in a group.
- *
- * Since: 3.22
*/
struct _GdkEventPadGroupMode {
GdkEventAny any;
diff --git a/gdk/gdkframeclock.h b/gdk/gdkframeclock.h
index 801af3793f..d1a91f9c25 100644
--- a/gdk/gdkframeclock.h
+++ b/gdk/gdkframeclock.h
@@ -58,8 +58,6 @@ typedef struct _GdkFrameClockClass GdkFrameClockClass;
* #GdkFrameClockPhase is used to represent the different paint clock
* phases that can be requested. The elements of the enumeration
* correspond to the signals of #GdkFrameClock.
- *
- * Since: 3.8
**/
typedef enum {
GDK_FRAME_CLOCK_PHASE_NONE = 0,
diff --git a/gdk/gdkmonitor.h b/gdk/gdkmonitor.h
index fe6836525e..79fd434660 100644
--- a/gdk/gdkmonitor.h
+++ b/gdk/gdkmonitor.h
@@ -50,8 +50,6 @@ typedef struct _GdkMonitorClass GdkMonitorClass;
*
* This enumeration describes how the red, green and blue components
* of physical pixels on an output device are laid out.
- *
- * Since: 3.22
*/
typedef enum {
GDK_SUBPIXEL_LAYOUT_UNKNOWN,
diff --git a/gdk/gdkseat.h b/gdk/gdkseat.h
index bb0eb069f2..14d7f83a63 100644
--- a/gdk/gdkseat.h
+++ b/gdk/gdkseat.h
@@ -47,8 +47,6 @@ G_BEGIN_DECLS
* @GDK_SEAT_CAPABILITY_ALL: The union of all capabilities
*
* Flags describing the seat capabilities.
- *
- * Since: 3.20
*/
typedef enum {
GDK_SEAT_CAPABILITY_NONE = 0,
@@ -71,8 +69,6 @@ typedef enum {
* grabbed. A typical action would be ensuring the surface is
* visible, although there's room for other initialization
* actions.
- *
- * Since: 3.20
*/
typedef void (* GdkSeatGrabPrepareFunc) (GdkSeat *seat,
GdkSurface *surface,
diff --git a/gdk/gdksurface.h b/gdk/gdksurface.h
index bfb8f5aeff..a1b800b8f4 100644
--- a/gdk/gdksurface.h
+++ b/gdk/gdksurface.h
@@ -47,7 +47,7 @@ typedef struct _GdkGeometry GdkGeometry;
* #GtkMenu)
* @GDK_SURFACE_SUBSURFACE: subsurface; This surface is visually
* tied to a toplevel, and is moved/stacked with it. Currently this window
- * type is only implemented in Wayland. Since 3.14
+ * type is only implemented in Wayland
*
* Describes the kind of surface.
*/
@@ -215,9 +215,6 @@ typedef enum
*
* In general, when multiple flags are set, flipping should take precedence over
* sliding, which should take precedence over resizing.
- *
- * Since: 3.22
- * Stability: Unstable
*/
typedef enum
{
@@ -264,8 +261,6 @@ typedef enum
*
* Indicates which monitor (in a multi-head setup) a surface should span over
* when in fullscreen mode.
- *
- * Since: 3.8
**/
typedef enum
{
@@ -375,16 +370,15 @@ struct _GdkGeometry
* @GDK_SURFACE_STATE_ABOVE: the surface is kept above other surfaces.
* @GDK_SURFACE_STATE_BELOW: the surface is kept below other surfaces.
* @GDK_SURFACE_STATE_FOCUSED: the surface is presented as focused (with active decorations).
- * @GDK_SURFACE_STATE_TILED: the surface is in a tiled state, Since 3.10. Since 3.91.2, this
- * is deprecated in favor of per-edge information.
- * @GDK_SURFACE_STATE_TOP_TILED: whether the top edge is tiled, Since 3.91.2
- * @GDK_SURFACE_STATE_TOP_RESIZABLE: whether the top edge is resizable, Since 3.91.2
- * @GDK_SURFACE_STATE_RIGHT_TILED: whether the right edge is tiled, Since 3.91.2
- * @GDK_SURFACE_STATE_RIGHT_RESIZABLE: whether the right edge is resizable, Since 3.91.2
- * @GDK_SURFACE_STATE_BOTTOM_TILED: whether the bottom edge is tiled, Since 3.91.2
- * @GDK_SURFACE_STATE_BOTTOM_RESIZABLE: whether the bottom edge is resizable, Since 3.91.2
- * @GDK_SURFACE_STATE_LEFT_TILED: whether the left edge is tiled, Since 3.91.2
- * @GDK_SURFACE_STATE_LEFT_RESIZABLE: whether the left edge is resizable, Since 3.91.2
+ * @GDK_SURFACE_STATE_TILED: the surface is in a tiled state. Deprecated
+ * @GDK_SURFACE_STATE_TOP_TILED: whether the top edge is tiled
+ * @GDK_SURFACE_STATE_TOP_RESIZABLE: whether the top edge is resizable
+ * @GDK_SURFACE_STATE_RIGHT_TILED: whether the right edge is tiled
+ * @GDK_SURFACE_STATE_RIGHT_RESIZABLE: whether the right edge is resizable
+ * @GDK_SURFACE_STATE_BOTTOM_TILED: whether the bottom edge is tiled
+ * @GDK_SURFACE_STATE_BOTTOM_RESIZABLE: whether the bottom edge is resizable
+ * @GDK_SURFACE_STATE_LEFT_TILED: whether the left edge is tiled
+ * @GDK_SURFACE_STATE_LEFT_RESIZABLE: whether the left edge is resizable
*
* Specifies the state of a toplevel surface.
*/
diff --git a/gdk/gdktypes.h b/gdk/gdktypes.h
index cdd5808e78..b967ad7259 100644
--- a/gdk/gdktypes.h
+++ b/gdk/gdktypes.h
@@ -196,9 +196,9 @@ typedef enum
* @GDK_MODIFIER_RESERVED_23_MASK: A reserved bit flag; do not use in your own code
* @GDK_MODIFIER_RESERVED_24_MASK: A reserved bit flag; do not use in your own code
* @GDK_MODIFIER_RESERVED_25_MASK: A reserved bit flag; do not use in your own code
- * @GDK_SUPER_MASK: the Super modifier. Since 2.10
- * @GDK_HYPER_MASK: the Hyper modifier. Since 2.10
- * @GDK_META_MASK: the Meta modifier. Since 2.10
+ * @GDK_SUPER_MASK: the Super modifier
+ * @GDK_HYPER_MASK: the Hyper modifier
+ * @GDK_META_MASK: the Meta modifier
* @GDK_MODIFIER_RESERVED_29_MASK: A reserved bit flag; do not use in your own code
* @GDK_RELEASE_MASK: not used in GDK itself. GTK+ uses it to differentiate
* between (keyval, modifiers) pairs from key press and release events.
@@ -210,7 +210,7 @@ typedef enum
*
* Like the X Window System, GDK supports 8 modifier keys and 5 mouse buttons.
*
- * Since 2.10, GDK recognizes which of the Meta, Super or Hyper keys are mapped
+ * GDK recognizes which of the Meta, Super or Hyper keys are mapped
* to Mod2 - Mod5, and indicates this by setting %GDK_SUPER_MASK,
* %GDK_HYPER_MASK or %GDK_META_MASK in the state field of key events.
*
@@ -299,8 +299,6 @@ typedef enum
* invoking menu shortcuts (accelerators), whereas on Apple computers
* it’s the Command key (which correspond to %GDK_CONTROL_MASK and
* %GDK_MOD2_MASK, respectively).
- *
- * Since: 3.4
**/
typedef enum
{
@@ -322,7 +320,7 @@ typedef enum
* @GDK_GRAB_NOT_VIEWABLE: the grab surface or the @confine_to surface are not
* viewable.
* @GDK_GRAB_FROZEN: the resource is frozen by an active grab of another client.
- * @GDK_GRAB_FAILED: the grab failed for some other reason. Since 3.16
+ * @GDK_GRAB_FAILED: the grab failed for some other reason
*
* Returned by gdk_device_grab() to indicate success or the reason for the
* failure of the grab attempt.
@@ -371,13 +369,12 @@ typedef enum
* @GDK_PROPERTY_CHANGE_MASK: receive property change events
* @GDK_PROXIMITY_IN_MASK: receive proximity in events
* @GDK_PROXIMITY_OUT_MASK: receive proximity out events
- * @GDK_SUBSTRUCTURE_MASK: receive events about surface configuration changes of
- * child surfaces
+ * @GDK_SUBSTRUCTURE_MASK: receive events about surface configuration changes of child surfaces
* @GDK_SCROLL_MASK: receive scroll events
- * @GDK_TOUCH_MASK: receive touch events. Since 3.4
- * @GDK_SMOOTH_SCROLL_MASK: receive smooth scrolling events. Since 3.4
- @GDK_TOUCHPAD_GESTURE_MASK: receive touchpad gesture events. Since 3.18
- * @GDK_TABLET_PAD_MASK: receive tablet pad events. Since 3.22
+ * @GDK_TOUCH_MASK: receive touch events
+ * @GDK_SMOOTH_SCROLL_MASK: receive smooth scrolling events
+ @GDK_TOUCHPAD_GESTURE_MASK: receive touchpad gesture events
+ * @GDK_TABLET_PAD_MASK: receive tablet pad events
* @GDK_ALL_EVENTS_MASK: the combination of all the above event masks.
*
* A set of bit-flags to indicate which events a surface is to receive.
@@ -387,11 +384,6 @@ typedef enum
* See the [input handling overview][chap-input-handling] for details of
* [event masks][event-masks] and [event propagation][event-propagation].
*
- * Since GTK 3.8, motion events are already compressed by default, independent
- * of this mechanism. This compression can be disabled with
- * gdk_surface_set_event_compression(). See the documentation of that function
- * for details.
- *
* If %GDK_TOUCH_MASK is enabled, the surface will receive touch events
* from touch-enabled devices. Those will come as sequences of #GdkEventTouch
* with type %GDK_TOUCH_UPDATE, enclosed by two events with
@@ -432,12 +424,10 @@ typedef enum
* @GDK_GL_ERROR_NOT_AVAILABLE: OpenGL support is not available
* @GDK_GL_ERROR_UNSUPPORTED_FORMAT: The requested visual format is not supported
* @GDK_GL_ERROR_UNSUPPORTED_PROFILE: The requested profile is not supported
- * @GDK_GL_ERROR_COMPILATION_FAILED: The shader compilation failed (available since 3.22)
- * @GDK_GL_ERROR_LINK_FAILED: The shader linking failed (available since 3.22)
+ * @GDK_GL_ERROR_COMPILATION_FAILED: The shader compilation failed
+ * @GDK_GL_ERROR_LINK_FAILED: The shader linking failed
*
* Error enumeration for #GdkGLContext.
- *
- * Since: 3.16
*/
typedef enum {
GDK_GL_ERROR_NOT_AVAILABLE,
@@ -454,8 +444,6 @@ typedef enum {
* @GDK_VULKAN_ERROR_NOT_AVAILABLE: Vulkan support is not available on this Surface
*
* Error enumeration for #GdkVulkanContext.
- *
- * Since: 3.90
*/
typedef enum {
GDK_VULKAN_ERROR_UNSUPPORTED,
@@ -519,9 +507,9 @@ typedef enum
* @GDK_AXIS_XTILT: the axis is used for x tilt information.
* @GDK_AXIS_YTILT: the axis is used for y tilt information.
* @GDK_AXIS_WHEEL: the axis is used for wheel information.
- * @GDK_AXIS_DISTANCE: the axis is used for pen/tablet distance information. (Since: 3.22)
- * @GDK_AXIS_ROTATION: the axis is used for pen rotation information. (Since: 3.22)
- * @GDK_AXIS_SLIDER: the axis is used for pen slider information. (Since: 3.22)
+ * @GDK_AXIS_DISTANCE: the axis is used for pen/tablet distance information
+ * @GDK_AXIS_ROTATION: the axis is used for pen rotation information
+ * @GDK_AXIS_SLIDER: the axis is used for pen slider information
* @GDK_AXIS_LAST: a constant equal to the numerically highest axis value.
*
* An enumeration describing the way in which a device
@@ -560,8 +548,6 @@ typedef enum
* @GDK_AXIS_FLAG_SLIDER: Slider axis is present
*
* Flags describing the current capabilities of a device/tool.
- *
- * Since: 3.22
*/
typedef enum
{
diff --git a/gdk/wayland/gdkdisplay-wayland.c b/gdk/wayland/gdkdisplay-wayland.c
index 77b948a1f2..6d00960adf 100644
--- a/gdk/wayland/gdkdisplay-wayland.c
+++ b/gdk/wayland/gdkdisplay-wayland.c
@@ -857,8 +857,6 @@ gdk_wayland_display_get_next_serial (GdkDisplay *display)
* if no ID has been defined.
*
* Returns: the startup notification ID for @display, or %NULL
- *
- * Since: 4.0
*/
const gchar *
gdk_wayland_display_get_startup_notification_id (GdkDisplay *display)
diff --git a/gsk/gskenums.h b/gsk/gskenums.h
index b605509047..4c17675ef3 100644
--- a/gsk/gskenums.h
+++ b/gsk/gskenums.h
@@ -48,8 +48,6 @@
* @GSK_OFFSET_NODE: A node that renders its child after applying a 2D translation
*
* The type of a node determines what the node is rendering.
- *
- * Since: 3.90
**/
typedef enum {
GSK_NOT_A_RENDER_NODE = 0,
@@ -89,8 +87,6 @@ typedef enum {
*
* The actual implementation of each filter is deferred to the
* rendering pipeline.
- *
- * Since: 3.90
*/
typedef enum {
GSK_SCALING_FILTER_LINEAR,
@@ -122,8 +118,6 @@ typedef enum {
*
* The implementation of each blend mode is deferred to the
* rendering pipeline.
- *
- * Since: 3.90
*/
typedef enum {
GSK_BLEND_MODE_DEFAULT = 0,
diff --git a/gsk/gskroundedrect.h b/gsk/gskroundedrect.h
index 28384417e1..378591af4c 100644
--- a/gsk/gskroundedrect.h
+++ b/gsk/gskroundedrect.h
@@ -36,8 +36,6 @@ G_BEGIN_DECLS
*
* Initializes a #GskRoundedRect when declaring it.
* All corner sizes will be initialized to 0.
- *
- * Since: 3.90
*/
#define GSK_ROUNDED_RECT_INIT(_x,_y,_w,_h) (GskRoundedRect) { .bounds = GRAPHENE_RECT_INIT(_x,_y,_w,_h), \
.corner = { \
@@ -60,8 +58,6 @@ G_BEGIN_DECLS
* All functions taking a #GskRoundedRect as an argument will internally operate on
* a normalized copy; all functions returning a #GskRoundedRect will always return
* a normalized one.
- *
- * Since: 3.90
*/
typedef struct _GskRoundedRect GskRoundedRect;
diff --git a/gtk/gtkaccelgroup.c b/gtk/gtkaccelgroup.c
index 18db631212..31f8f92e1f 100644
--- a/gtk/gtkaccelgroup.c
+++ b/gtk/gtkaccelgroup.c
@@ -694,8 +694,6 @@ gtk_accel_group_connect_by_path (GtkAccelGroup *accel_group,
* Removes an accelerator previously installed through
* gtk_accel_group_connect().
*
- * Since 2.20 @closure can be %NULL.
- *
* Returns: %TRUE if the closure was found and got disconnected
*/
gboolean
diff --git a/gtk/gtkbbox.h b/gtk/gtkbbox.h
index c8bcf2e1eb..9b92665bf2 100644
--- a/gtk/gtkbbox.h
+++ b/gtk/gtkbbox.h
@@ -80,11 +80,11 @@ struct _GtkButtonBoxClass
* (on the left for a HBox, or the top for a VBox).
* @GTK_BUTTONBOX_END: Buttons are grouped towards the end of the box,
* (on the right for a HBox, or the bottom for a VBox).
- * @GTK_BUTTONBOX_CENTER: Buttons are centered in the box. Since 2.12.
+ * @GTK_BUTTONBOX_CENTER: Buttons are centered in the box
* @GTK_BUTTONBOX_EXPAND: Buttons expand to fill the box. This entails giving
* buttons a "linked" appearance, making button sizes homogeneous, and
* setting spacing to 0 (same as calling gtk_box_set_homogeneous() and
- * gtk_box_set_spacing() manually). Since 3.12.
+ * gtk_box_set_spacing() manually)
*
* Used to dictate the style that a #GtkButtonBox uses to layout the buttons it
* contains.
diff --git a/gtk/gtkcellareacontext.c b/gtk/gtkcellareacontext.c
index 36691235df..c9ed22063b 100644
--- a/gtk/gtkcellareacontext.c
+++ b/gtk/gtkcellareacontext.c
@@ -356,8 +356,6 @@ gtk_cell_area_context_get_area (GtkCellAreaContext *context)
* in the allocated width necessitates a recalculation
* of all the displayed row heights using
* gtk_cell_area_get_preferred_height_for_width().
- *
- * Since 3.0
*/
void
gtk_cell_area_context_reset (GtkCellAreaContext *context)
@@ -385,8 +383,6 @@ gtk_cell_area_context_reset (GtkCellAreaContext *context)
* and vertical orientations producing a homogeneous effect of the
* rows. This is generally the case for #GtkTreeView when
* #GtkTreeView:fixed-height-mode is enabled.
- *
- * Since 3.0
*/
void
gtk_cell_area_context_allocate (GtkCellAreaContext *context,
diff --git a/gtk/gtkcellrenderer.h b/gtk/gtkcellrenderer.h
index 2b297e1c59..c5d8c55a91 100644
--- a/gtk/gtkcellrenderer.h
+++ b/gtk/gtkcellrenderer.h
@@ -35,8 +35,8 @@ G_BEGIN_DECLS
* @GTK_CELL_RENDERER_INSENSITIVE: The cell is drawn in an insensitive manner
* @GTK_CELL_RENDERER_SORTED: The cell is in a sorted row
* @GTK_CELL_RENDERER_FOCUSED: The cell is in the focus row.
- * @GTK_CELL_RENDERER_EXPANDABLE: The cell is in a row that can be expanded. Since 3.4
- * @GTK_CELL_RENDERER_EXPANDED: The cell is in a row that is expanded. Since 3.4
+ * @GTK_CELL_RENDERER_EXPANDABLE: The cell is in a row that can be expanded
+ * @GTK_CELL_RENDERER_EXPANDED: The cell is in a row that is expanded
*
* Tells how a cell is to be rendered.
*/
diff --git a/gtk/gtkcellrenderertext.c b/gtk/gtkcellrenderertext.c
index 1e46ea0c56..f7ee9aaee2 100644
--- a/gtk/gtkcellrenderertext.c
+++ b/gtk/gtkcellrenderertext.c
@@ -539,8 +539,6 @@ gtk_cell_renderer_text_class_init (GtkCellRendererTextClass *class)
*
* The text that will be displayed in the #GtkCellRenderer if
* #GtkCellRendererText:editable is %TRUE and the cell is empty.
- *
- * Since 3.6
*/
text_cell_renderer_props[PROP_PLACEHOLDER_TEXT] =
g_param_spec_string ("placeholder-text",
diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c
index 9f11262a7c..00427aae05 100644
--- a/gtk/gtkcontainer.c
+++ b/gtk/gtkcontainer.c
@@ -113,11 +113,11 @@
* a <packing> element for children, which can contain multiple <property>
* elements that specify child properties for the child.
*
- * Since 2.16, child properties can also be marked as translatable using
+ * Child properties can also be marked as translatable using
* the same “translatable”, “comments” and “context” attributes that are used
* for regular properties.
*
- * Since 3.16, containers can have a <focus-chain> element containing multiple
+ * Containers can have a <focus-chain> element containing multiple
* <widget> elements, one for each child that should be added to the focus
* chain. The ”name” attribute gives the id of the widget.
*
diff --git a/gtk/gtkcsssection.h b/gtk/gtkcsssection.h
index 8553633fcd..8dc7ac90b5 100644
--- a/gtk/gtkcsssection.h
+++ b/gtk/gtkcsssection.h
@@ -41,7 +41,7 @@ G_BEGIN_DECLS
* a CSS variable.
* @GTK_CSS_SECTION_VALUE: The section defines the value of a CSS declaration.
* @GTK_CSS_SECTION_KEYFRAMES: The section defines keyframes. See [CSS
- * Animations](http://dev.w3.org/csswg/css3-animations/#keyframes) for details. Since 3.6
+ * Animations](http://dev.w3.org/csswg/css3-animations/#keyframes) for details
*
* The different types of sections indicate parts of a CSS document as
* parsed by GTK’s CSS parser. They are oriented towards the
diff --git a/gtk/gtkdialog.h b/gtk/gtkdialog.h
index 377a155f5f..68ae23126e 100644
--- a/gtk/gtkdialog.h
+++ b/gtk/gtkdialog.h
@@ -40,7 +40,7 @@ G_BEGIN_DECLS
* @GTK_DIALOG_DESTROY_WITH_PARENT: Destroy the dialog when its
* parent is destroyed, see gtk_window_set_destroy_with_parent()
* @GTK_DIALOG_USE_HEADER_BAR: Create dialog with actions in header
- * bar instead of action area. Since 3.12.
+ * bar instead of action area
*
* Flags used to influence dialog construction.
*/
diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index 5f64a75f14..105bd935ca 100644
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -99,12 +99,12 @@
* In this mode, entered text is displayed using a “invisible” character.
* By default, GTK+ picks the best invisible character that is available
* in the current font, but it can be changed with
- * gtk_entry_set_invisible_char(). Since 2.16, GTK+ displays a warning
+ * gtk_entry_set_invisible_char(). GTK+ displays a warning
* when Caps Lock or input methods might interfere with entering text in
* a password entry. The warning can be turned off with the
* #GtkEntry:caps-lock-warning property.
*
- * Since 2.16, GtkEntry has the ability to display progress or activity
+ * GtkEntry has the ability to display progress or activity
* information behind the text. To make an entry display such information,
* use gtk_entry_set_progress_fraction() or gtk_entry_set_progress_pulse_step().
*
diff --git a/gtk/gtkenums.h b/gtk/gtkenums.h
index 2fd2739998..57ac101e5f 100644
--- a/gtk/gtkenums.h
+++ b/gtk/gtkenums.h
@@ -51,7 +51,7 @@ G_BEGIN_DECLS
* or top
* @GTK_ALIGN_CENTER: center natural width of widget inside the
* allocation
- * @GTK_ALIGN_BASELINE: align the widget according to the baseline. Since 3.10.
+ * @GTK_ALIGN_BASELINE: align the widget according to the baseline
*
* Controls how a widget deals with extra space in a single (x or y)
* dimension.
@@ -85,7 +85,7 @@ typedef enum
* @GTK_ARROW_DOWN: Represents a downward pointing arrow.
* @GTK_ARROW_LEFT: Represents a left pointing arrow.
* @GTK_ARROW_RIGHT: Represents a right pointing arrow.
- * @GTK_ARROW_NONE: No arrow. Since 2.10.
+ * @GTK_ARROW_NONE: No arrow.
*
* Used to indicate the direction in which an arrow should point.
*/
@@ -912,9 +912,9 @@ typedef enum
* first word of each sentence
* @GTK_INPUT_HINT_INHIBIT_OSK: Suggest to not show an onscreen keyboard
* (e.g for a calculator that already has all the keys).
- * @GTK_INPUT_HINT_VERTICAL_WRITING: The text is vertical. Since 3.18
- * @GTK_INPUT_HINT_EMOJI: Suggest offering Emoji support. Since 3.22.20
- * @GTK_INPUT_HINT_NO_EMOJI: Suggest not offering Emoji support. Since 3.22.20
+ * @GTK_INPUT_HINT_VERTICAL_WRITING: The text is vertical
+ * @GTK_INPUT_HINT_EMOJI: Suggest offering Emoji support
+ * @GTK_INPUT_HINT_NO_EMOJI: Suggest not offering Emoji support
*
* Describes hints that might be taken into account by input methods
* or applications. Note that input methods may already tailor their
diff --git a/gtk/gtkeventcontrollerkey.c b/gtk/gtkeventcontrollerkey.c
index a998a0af89..ecac19478b 100644
--- a/gtk/gtkeventcontrollerkey.c
+++ b/gtk/gtkeventcontrollerkey.c
@@ -231,8 +231,6 @@ gtk_event_controller_key_set_im_context (GtkEventControllerKey *controller,
* Gets the IM context of a key controller.
*
* Returns: (transfer none): the IM context
- *
- * Since: 3.94
**/
GtkIMContext *
gtk_event_controller_key_get_im_context (GtkEventControllerKey *controller)
diff --git a/gtk/gtkgesturestylus.c b/gtk/gtkgesturestylus.c
index 294fa293a3..8c011c3501 100644
--- a/gtk/gtkgesturestylus.c
+++ b/gtk/gtkgesturestylus.c
@@ -135,8 +135,6 @@ gtk_gesture_stylus_init (GtkGestureStylus *gesture)
* Creates a new #GtkGestureStylus.
*
* Returns: a newly created stylus gesture
- *
- * Since: 3.94
**/
GtkGesture *
gtk_gesture_stylus_new (void)
diff --git a/gtk/gtkicontheme.h b/gtk/gtkicontheme.h
index b618ffec0d..057d2fe6f3 100644
--- a/gtk/gtkicontheme.h
+++ b/gtk/gtkicontheme.h
@@ -112,17 +112,17 @@ struct _GtkIconThemeClass
* @GTK_ICON_LOOKUP_GENERIC_FALLBACK: Try to shorten icon name at '-'
* characters before looking at inherited themes. This flag is only
* supported in functions that take a single icon name. For more general
- * fallback, see gtk_icon_theme_choose_icon(). Since 2.12.
+ * fallback, see gtk_icon_theme_choose_icon()
* @GTK_ICON_LOOKUP_FORCE_SIZE: Always get the icon scaled to the
- * requested size. Since 2.14.
+ * requested size
* @GTK_ICON_LOOKUP_FORCE_REGULAR: Try to always load regular icons, even
- * when symbolic icon names are given. Since 3.14.
+ * when symbolic icon names are given
* @GTK_ICON_LOOKUP_FORCE_SYMBOLIC: Try to always load symbolic icons, even
- * when regular icon names are given. Since 3.14.
+ * when regular icon names are given
* @GTK_ICON_LOOKUP_DIR_LTR: Try to load a variant of the icon for left-to-right
- * text direction. Since 3.14.
+ * text direction
* @GTK_ICON_LOOKUP_DIR_RTL: Try to load a variant of the icon for right-to-left
- * text direction. Since 3.14.
+ * text direction
*
* Used to specify options for gtk_icon_theme_lookup_icon()
*/
diff --git a/gtk/gtklabel.c b/gtk/gtklabel.c
index e361b1ba36..f007fecf37 100644
--- a/gtk/gtklabel.c
+++ b/gtk/gtklabel.c
@@ -228,7 +228,7 @@
*
* # Links
*
- * Since 2.18, GTK+ supports markup for clickable hyperlinks in addition
+ * GTK+ supports markup for clickable hyperlinks in addition
* to regular Pango markup. The markup for links is borrowed from HTML,
* using the `<a>` with “href“, “title“ and “class“ attributes. GTK+ renders links
* similar to the way they appear in web browsers, with colored, underlined
diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c
index b285c517b6..3377ee3742 100644
--- a/gtk/gtkmain.c
+++ b/gtk/gtkmain.c
@@ -809,7 +809,7 @@ gtk_init_check (void)
* your program to fall back to a textual interface you want to
* call gtk_init_check() instead.
*
- * Since 2.18, GTK+ calls `signal (SIGPIPE, SIG_IGN)`
+ * GTK+ calls `signal (SIGPIPE, SIG_IGN)`
* during initialization, to ignore SIGPIPE signals, since these are
* almost never wanted in graphical applications. If you do need to
* handle SIGPIPE for some reason, reset the handler after gtk_init(),
diff --git a/gtk/gtkplacessidebar.c b/gtk/gtkplacessidebar.c
index e883cb0686..95683c6622 100644
--- a/gtk/gtkplacessidebar.c
+++ b/gtk/gtkplacessidebar.c
@@ -4448,7 +4448,7 @@ gtk_places_sidebar_class_init (GtkPlacesSidebarClass *class)
* emitted) every time the user activates the contextual menu.
*
* Before 3.18, the @container always was a #GtkMenu, and you were expected
- * to add your items as #GtkMenuItems. Since 3.18, the popup may be implemented
+ * to add your items as #GtkMenuItems. The popup may be implemented
* as a #GtkPopover, in which case @container will be something else, e.g. a
* #GtkBox, to which you may add #GtkModelButtons or other widgets, such as
* #GtkEntries, #GtkSpinButtons, etc. If your application can deal with this
diff --git a/gtk/gtkprinter.h b/gtk/gtkprinter.h
index a3e3eb54a3..205d04fb65 100644
--- a/gtk/gtkprinter.h
+++ b/gtk/gtkprinter.h
@@ -45,9 +45,9 @@ G_BEGIN_DECLS
* the printer in Postscript format
* @GTK_PRINT_CAPABILITY_PREVIEW: Print dialog will offer a preview
* @GTK_PRINT_CAPABILITY_NUMBER_UP: Print dialog will offer printing multiple
- * pages per sheet. Since 2.12
+ * pages per sheet
* @GTK_PRINT_CAPABILITY_NUMBER_UP_LAYOUT: Print dialog will allow to rearrange
- * pages when printing multiple pages per sheet. Since 2.14
+ * pages when printing multiple pages per sheet
*
* An enum for specifying which features the print dialog should offer.
* If neither %GTK_PRINT_CAPABILITY_GENERATE_PDF nor
diff --git a/gtk/gtksearchbar.c b/gtk/gtksearchbar.c
index 8f26e8ecf4..68bd94de3c 100644
--- a/gtk/gtksearchbar.c
+++ b/gtk/gtksearchbar.c
@@ -710,8 +710,6 @@ capture_widget_key_handled (GtkEventControllerKey *controller,
*
* If key events are handled by the search bar, the bar will
* be shown, and the entry populated with the entered text.
- *
- * Since: 3.94
**/
void
gtk_search_bar_set_key_capture_widget (GtkSearchBar *bar,
@@ -758,8 +756,6 @@ gtk_search_bar_set_key_capture_widget (GtkSearchBar *bar,
* Gets the widget that @bar is capturing key events from.
*
* Returns: (transfer none): The key capture widget.
- *
- * Since: 3.94
**/
GtkWidget *
gtk_search_bar_get_key_capture_widget (GtkSearchBar *bar)
diff --git a/gtk/gtksearchentry.c b/gtk/gtksearchentry.c
index 7e50642f17..693fe6d485 100644
--- a/gtk/gtksearchentry.c
+++ b/gtk/gtksearchentry.c
@@ -490,8 +490,6 @@ capture_widget_key_handled (GtkEventControllerKey *controller,
* If the entry is part of a #GtkSearchBar, it is preferable
* to call gtk_search_bar_set_key_capture_widget() instead, which
* will reveal the entry in addition to triggering the search entry.
- *
- * Since: 3.94
**/
void
gtk_search_entry_set_key_capture_widget (GtkSearchEntry *entry,
@@ -535,8 +533,6 @@ gtk_search_entry_set_key_capture_widget (GtkSearchEntry *entry,
* Gets the widget that @entry is capturing key events from.
*
* Returns: (transfer none): The key capture widget.
- *
- * Since: 3.94
**/
GtkWidget *
gtk_search_entry_get_key_capture_widget (GtkSearchEntry *entry)
diff --git a/gtk/gtkstack.c b/gtk/gtkstack.c
index 05cf9e785d..a3d36a8603 100644
--- a/gtk/gtkstack.c
+++ b/gtk/gtkstack.c
@@ -1252,7 +1252,7 @@ gtk_stack_get_child_by_name (GtkStack *stack,
* size for all its children. If it isn't, the stack
* may change size when a different child becomes visible.
*
- * Since 3.16, homogeneity can be controlled separately
+ * Homogeneity can be controlled separately
* for horizontal and vertical size, with the
* #GtkStack:hhomogeneous and #GtkStack:vhomogeneous.
*/
diff --git a/gtk/gtktextbuffer.c b/gtk/gtktextbuffer.c
index e6c1a6c62f..31d4bc9911 100644
--- a/gtk/gtktextbuffer.c
+++ b/gtk/gtktextbuffer.c
@@ -3054,7 +3054,7 @@ gtk_text_buffer_remove_all_tags (GtkTextBuffer *buffer,
*
* Before the 3.20 version, it was not allowed to pass an invalid location.
*
- * Since the 3.20 version, if @line_number is greater than the number of lines
+ * If @line_number is greater than the number of lines
* in the @buffer, the end iterator is returned. And if @char_offset is off the
* end of the line, the iterator at the end of the line is returned.
**/
@@ -3098,9 +3098,7 @@ gtk_text_buffer_get_iter_at_line_offset (GtkTextBuffer *buffer,
* @byte_index must be the start of a UTF-8 character. Note bytes, not
* characters; UTF-8 may encode one character as multiple bytes.
*
- * Before the 3.20 version, it was not allowed to pass an invalid location.
- *
- * Since the 3.20 version, if @line_number is greater than the number of lines
+ * If @line_number is greater than the number of lines
* in the @buffer, the end iterator is returned. And if @byte_index is off the
* end of the line, the iterator at the end of the line is returned.
**/
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 6f324522c2..234c1302dd 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -231,7 +231,7 @@
* Otherwise, you would not properly consider widget margins,
* #GtkSizeGroup, and so forth.
*
- * Since 3.10 GTK+ also supports baseline vertical alignment of widgets. This
+ * GTK+ also supports baseline vertical alignment of widgets. This
* means that widgets are positioned such that the typographical baseline of
* widgets in the same row are aligned. This happens if a widget supports baselines,
* has a vertical alignment of %GTK_ALIGN_BASELINE, and is inside a widget
diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index 29ecb22eb0..012f4efa58 100644
--- a/gtk/gtkwindow.c
+++ b/gtk/gtkwindow.c
@@ -9934,8 +9934,6 @@ gtk_window_get_group (GtkWindow *window)
* Returns whether @window has an explicit window group.
*
* Returns: %TRUE if @window has an explicit window group.
- *
- * Since 2.22
**/
gboolean
gtk_window_has_group (GtkWindow *window)
diff --git a/modules/printbackends/gtkprintercups.c b/modules/printbackends/gtkprintercups.c
index 525382aa8a..b97da61805 100644
--- a/modules/printbackends/gtkprintercups.c
+++ b/modules/printbackends/gtkprintercups.c
@@ -576,8 +576,6 @@ colord_printer_details_aquired_cb (GtkPrinterCups *printer,
* Creates a new #GtkPrinterCups.
*
* Returns: a new #GtkPrinterCups
- *
- * Since: 2.10
**/
GtkPrinterCups *
gtk_printer_cups_new (const char *name,