diff options
author | Matthias Clasen <mclasen@redhat.com> | 2018-06-25 19:21:08 -0400 |
---|---|---|
committer | Matthias Clasen <mclasen@redhat.com> | 2018-06-25 19:55:04 -0400 |
commit | 8755d884f3e5043f355d4c6403e954ea5ff0928f (patch) | |
tree | 36ccc605c99d88687b1af5c6d2897086b3722bda | |
parent | 010f4e90e38fd71967428486fd986e4dfc444c7b (diff) | |
download | gtk+-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.
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, |