[gtkmm] Use parametric Doxygen alias @since{m,n}
- From: Daniel Elstner <daniel src gnome org>
- To: svn-commits-list gnome org
- Cc:
- Subject: [gtkmm] Use parametric Doxygen alias @since{m,n}
- Date: Tue, 18 Aug 2009 16:14:19 +0000 (UTC)
commit a8f9d225b45c5550a33040135902518188d297ad
Author: Daniel Elstner <danielk openismus com>
Date: Tue Aug 18 18:13:48 2009 +0200
Use parametric Doxygen alias @since{m,n}
* docs/reference/Doxyfile.in (ALIASES): Define a parametrized alias
@since{major,minor} to replace the old @newin?p?* aliases which had
to be defined manually for every version number used.
* g[dt]k/src/*.hg, g[dt]k/g[dt]kmm/*.h: Change all occurrences of
@newin?p?* to @since{m,n}.
ChangeLog | 10 ++++++++++
docs/reference/Doxyfile.in | 10 +---------
gdk/gdkmm/general.h | 20 ++++++++++----------
gdk/src/color.hg | 2 +-
gdk/src/display.hg | 8 ++++----
gdk/src/displaymanager.hg | 2 +-
gdk/src/drawable.hg | 2 +-
gdk/src/pixbuf.hg | 12 ++++++------
gdk/src/pixbufanimationiter.hg | 2 +-
gdk/src/window.hg | 2 +-
gtk/gtkmm/accelmap.h | 8 ++++----
gtk/gtkmm/listviewtext.h | 2 +-
gtk/src/activatable.hg | 2 +-
gtk/src/assistant.hg | 2 +-
gtk/src/builder.hg | 30 +++++++++++++++---------------
gtk/src/calendar.hg | 4 ++--
gtk/src/cellrenderer.hg | 2 +-
gtk/src/cellrendereraccel.hg | 2 +-
gtk/src/cellrendererprogress.hg | 2 +-
gtk/src/cellrendererspin.hg | 2 +-
gtk/src/cellview.hg | 2 +-
gtk/src/clipboard.hg | 6 +++---
gtk/src/colorbutton.hg | 6 +++---
gtk/src/combobox.hg | 2 +-
gtk/src/comboboxentry.hg | 2 +-
gtk/src/entrycompletion.hg | 6 +++---
gtk/src/enums.hg | 2 +-
gtk/src/expander.hg | 4 ++--
gtk/src/filechooserwidget.hg | 2 +-
gtk/src/icontheme.hg | 2 +-
gtk/src/iconview.hg | 32 ++++++++++++++++----------------
gtk/src/image.hg | 4 ++--
gtk/src/infobar.hg | 2 +-
gtk/src/linkbutton.hg | 6 +++---
gtk/src/menu.hg | 2 +-
gtk/src/messagedialog.hg | 2 +-
gtk/src/orientable.hg | 2 +-
gtk/src/pagesetup.hg | 14 +++++++-------
gtk/src/pagesetupunixdialog.hg | 2 +-
gtk/src/papersize.hg | 6 +++---
gtk/src/printcontext.hg | 2 +-
gtk/src/printer.hg | 2 +-
gtk/src/printjob.hg | 2 +-
gtk/src/printoperation.hg | 2 +-
gtk/src/printoperationpreview.hg | 2 +-
gtk/src/printsettings.hg | 14 +++++++-------
gtk/src/printunixdialog.hg | 2 +-
gtk/src/radiotoolbutton.hg | 8 ++++----
gtk/src/rc.hg | 2 +-
gtk/src/recentaction.hg | 2 +-
gtk/src/recentchooser.hg | 2 +-
gtk/src/recentchooserdialog.hg | 2 +-
gtk/src/recentchoosermenu.hg | 2 +-
gtk/src/recentchooserwidget.hg | 2 +-
gtk/src/recentfilter.hg | 2 +-
gtk/src/recentinfo.hg | 2 +-
gtk/src/recentmanager.hg | 2 +-
gtk/src/scalebutton.hg | 2 +-
gtk/src/selectiondata.hg | 2 +-
gtk/src/statusicon.hg | 8 ++++----
gtk/src/style.hg | 2 +-
gtk/src/textbuffer.hg | 2 +-
gtk/src/textmark.hg | 8 ++++----
gtk/src/toolshell.hg | 2 +-
gtk/src/tooltip.hg | 2 +-
gtk/src/treemodel.hg | 2 +-
gtk/src/treepath.hg | 2 +-
gtk/src/treeview.hg | 8 ++++----
gtk/src/uimanager.hg | 6 +++---
gtk/src/volumebutton.hg | 2 +-
gtk/src/widget.hg | 4 ++--
71 files changed, 169 insertions(+), 167 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 74c277d..7919ddb 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2009-08-18 Daniel Elstner <danielk openismus com>
+
+ Use parametric Doxygen alias @since{m,n}
+
+ * docs/reference/Doxyfile.in (ALIASES): Define a parametrized alias
+ @since{major,minor} to replace the old @newin?p?* aliases which had
+ to be defined manually for every version number used.
+ * g[dt]k/src/*.hg, g[dt]k/g[dt]kmm/*.h: Change all occurrences of
+ @newin?p?* to @since{m,n}.
+
2009-08-17 Daniel Elstner <danielk openismus com>
Define {ATK,GDK,GTK}MM_BUILD macros
diff --git a/docs/reference/Doxyfile.in b/docs/reference/Doxyfile.in
index 246adc1..56cac73 100644
--- a/docs/reference/Doxyfile.in
+++ b/docs/reference/Doxyfile.in
@@ -39,15 +39,7 @@ MULTILINE_CPP_IS_BRIEF = NO
INHERIT_DOCS = YES
SEPARATE_MEMBER_PAGES = NO
TAB_SIZE = 8
-ALIASES = "newin2p2=\xrefitem newin2p2s \"Since gtkmm 2.2\" \"New API in gtkmm 2.2\" \n" \
- "newin2p4=\xrefitem newin2p4s \"Since gtkmm 2.4\" \"New API in gtkmm 2.4\" \n" \
- "newin2p6=\xrefitem newin2p6s \"Since gtkmm 2.6\" \"New API in gtkmm 2.6\" \n" \
- "newin2p8=\xrefitem newin2p8s \"Since gtkmm 2.8\" \"New API in gtkmm 2.8\" \n" \
- "newin2p10=\xrefitem newin2p10s \"Since gtkmm 2.10\" \"New API in gtkmm 2.10\" \n" \
- "newin2p12=\xrefitem newin2p12s \"Since gtkmm 2.12\" \"New API in gtkmm 2.12\" \n" \
- "newin2p14=\xrefitem newin2p14s \"Since gtkmm 2.14\" \"New API in gtkmm 2.14\" \n" \
- "newin2p16=\xrefitem newin2p16s \"Since gtkmm 2.16\" \"New API in gtkmm 2.16\" \n" \
- "newin2p18=\xrefitem newin2p18s \"Since gtkmm 2.18\" \"New API in gtkmm 2.18\" \n"
+ALIASES = "since{2}=\xrefitem since_\1_\2 \"Since @PACKAGE_NAME@ \1.\2\" \"New API in @PACKAGE_NAME@ \1.\2\""
OPTIMIZE_OUTPUT_FOR_C = NO
OPTIMIZE_OUTPUT_JAVA = NO
OPTIMIZE_FOR_FORTRAN = NO
diff --git a/gdk/gdkmm/general.h b/gdk/gdkmm/general.h
index 00d57d8..b78f24e 100644
--- a/gdk/gdkmm/general.h
+++ b/gdk/gdkmm/general.h
@@ -45,7 +45,7 @@ namespace Cairo
* @deprecated Use the overloaded function that takes a const RefPtr
* reference.
*
- * @newin2p10
+ * @since{2,10}
*/
void set_source_color(::Cairo::RefPtr< ::Cairo::Context >& context, const Gdk::Color& color);
#endif
@@ -54,7 +54,7 @@ void set_source_color(::Cairo::RefPtr< ::Cairo::Context >& context, const Gdk::C
* @param @context The cairo context.
* @param color The color to use as the source color.
*
- * @newin2p12
+ * @since{2,12}
*/
void set_source_color(const ::Cairo::RefPtr< ::Cairo::Context >& context, const Gdk::Color& color);
@@ -68,7 +68,7 @@ void set_source_color(const ::Cairo::RefPtr< ::Cairo::Context >& context, const
* @deprecated Use the overloaded function that takes a const RefPtr
* reference.
*
- * @newin2p10
+ * @since{2,10}
*/
void set_source_pixbuf(::Cairo::RefPtr< ::Cairo::Context >& context, const Glib::RefPtr<Gdk::Pixbuf>& pixbuf, double pixbuf_x, double pixbuf_y);
#endif
@@ -79,7 +79,7 @@ void set_source_pixbuf(::Cairo::RefPtr< ::Cairo::Context >& context, const Glib:
* @param pixbuf_x X coordinate of location to place upper left corner of pixbuf.
* @param pixbuf_y Y coordinate of location to place upper left corner of pixbuf.
*
- * @newin2p12
+ * @since{2,12}
*/
void set_source_pixbuf(const ::Cairo::RefPtr< ::Cairo::Context >& context, const Glib::RefPtr<Gdk::Pixbuf>& pixbuf, double pixbuf_x, double pixbuf_y);
@@ -93,7 +93,7 @@ void set_source_pixbuf(const ::Cairo::RefPtr< ::Cairo::Context >& context, const
* @deprecated Use the overloaded function that takes a const RefPtr
* reference.
*
- * @newin2p10
+ * @since{2,10}
*/
void set_source_pixmap(::Cairo::RefPtr< ::Cairo::Context >& context, const Glib::RefPtr<Gdk::Pixmap>& pixmap, double pixmap_x, double pixmap_y);
#endif
@@ -104,7 +104,7 @@ void set_source_pixmap(::Cairo::RefPtr< ::Cairo::Context >& context, const Glib:
* @param pixmap_x X coordinate of location to place upper left corner of pixmap.
* @param pixmap_y Y coordinate of location to place upper left corner of pixmap.
*
- * @newin2p12
+ * @since{2,12}
*/
void set_source_pixmap(const ::Cairo::RefPtr< ::Cairo::Context >& context, const Glib::RefPtr<Gdk::Pixmap>& pixmap, double pixmap_x, double pixmap_y);
@@ -117,7 +117,7 @@ void set_source_pixmap(const ::Cairo::RefPtr< ::Cairo::Context >& context, const
* @deprecated Use add_rectangle_to_path() instead
* reference.
*
- * @newin2p10
+ * @since{2,10}
*/
void rectangle(::Cairo::RefPtr< ::Cairo::Context >& context, const Gdk::Rectangle& rectangle);
#endif
@@ -127,7 +127,7 @@ void rectangle(::Cairo::RefPtr< ::Cairo::Context >& context, const Gdk::Rectangl
* @param context A cairo context.
* @param rectangle A rectangle to add to the path of the context.
*
- * @newin2p12
+ * @since{2,12}
*/
void add_rectangle_to_path(const ::Cairo::RefPtr< ::Cairo::Context >& context, const Gdk::Rectangle& rectangle);
@@ -139,7 +139,7 @@ void add_rectangle_to_path(const ::Cairo::RefPtr< ::Cairo::Context >& context, c
*
* @deprecated Use add_region_to_path() instead
*
- * @newin2p10
+ * @since{2,10}
*/
void region(::Cairo::RefPtr< ::Cairo::Context >& context, const Gdk::Region& region);
#endif
@@ -149,7 +149,7 @@ void region(::Cairo::RefPtr< ::Cairo::Context >& context, const Gdk::Region& reg
* @param context A cairo context.
* @param region A region to add to the path of the context.
*
- * @newin2p12
+ * @since{2,12}
*/
void add_region_to_path(const ::Cairo::RefPtr< ::Cairo::Context >& context, const Gdk::Region& region);
diff --git a/gdk/src/color.hg b/gdk/src/color.hg
index 5c98d8a..221b0ee 100644
--- a/gdk/src/color.hg
+++ b/gdk/src/color.hg
@@ -163,7 +163,7 @@ public:
*
* @result The string representation.
*
- * @newin2p14
+ * @since{2,14}
*/
Glib::ustring to_string() const;
diff --git a/gdk/src/display.hg b/gdk/src/display.hg
index a93020f..bbd4ce6 100644
--- a/gdk/src/display.hg
+++ b/gdk/src/display.hg
@@ -143,7 +143,7 @@ public:
#ifdef G_OS_WIN32
/** Finds out the DND protocol supported by a window.
*
- * @newin2p2
+ * @since{2,2}
* @deprecated
* @param xid The X id of the destination window.
* @param protocol Location where the supported DND protocol is returned.
@@ -169,7 +169,7 @@ public:
#ifdef G_OS_WIN32
/** Send a response to SelectionRequest event.
*
- * @newin2p2
+ * @since{2,2}
* @param requestor Window to which to deliver response.
* @param selection Selection that was requested.
* @param target Target that was selected.
@@ -186,7 +186,7 @@ public:
/** Send a response to SelectionRequest event.
*
- * @newin2p2
+ * @since{2,2}
* @param requestor Window to which to deliver response.
* @param selection Selection that was requested.
* @param target Target that was selected.
@@ -220,7 +220,7 @@ public:
* saving all available targets.
* On X11, this is a special program that works according to the freedesktop clipboard specification,
* available at http://www.freedesktop.org/Standards/clipboard-manager-spec.
- * @newin2p6
+ * @since{2,6}
*
* @param clipboard_window A Gdk::Window belonging to the clipboard owner.
* @param time_ A timestamp.
diff --git a/gdk/src/displaymanager.hg b/gdk/src/displaymanager.hg
index de0df6c..c365088 100644
--- a/gdk/src/displaymanager.hg
+++ b/gdk/src/displaymanager.hg
@@ -54,7 +54,7 @@ public:
/** The display_opened signal is emitted when a display is opened.
*
- * @newin2p2
+ * @since{2,2}
*
* @param display the opened display
*/
diff --git a/gdk/src/drawable.hg b/gdk/src/drawable.hg
index 1b43441..2564de1 100644
--- a/gdk/src/drawable.hg
+++ b/gdk/src/drawable.hg
@@ -126,7 +126,7 @@ public:
* support can be turned off by setting the GDK_DISABLE_MEDIALIB environment
* variable.
*
- * @newin2p16
+ * @since{2,16}
* @param pixbuf A Gdk::Pixbuf.
* @param src_x Source X coordinate within pixbuf.
* @param src_y Source Y coordinates within pixbuf.
diff --git a/gdk/src/pixbuf.hg b/gdk/src/pixbuf.hg
index 46bb19d..51b7d55 100644
--- a/gdk/src/pixbuf.hg
+++ b/gdk/src/pixbuf.hg
@@ -116,7 +116,7 @@ protected:
* @param width Width in pixels of region to get.
* @param height Height in pixels of region to get.
*
- * @newin2p12
+ * @since{2,12}
*/
Pixbuf(const Glib::RefPtr<Drawable>& src, const Glib::RefPtr<Colormap>& cmap,
int src_x, int src_y, int width, int height);
@@ -129,7 +129,7 @@ protected:
* @param width Width in pixels of region to get.
* @param height Height in pixels of region to get.
*
- * @newin2p12
+ * @since{2,12}
*/
Pixbuf(const Glib::RefPtr<Drawable>& src,
int src_x, int src_y, int width, int height);
@@ -149,7 +149,7 @@ protected:
* @param width Width in pixels of region to get.
* @param height Height in pixels of region to get.
*
- * @newin2p12
+ * @since{2,12}
*/
Pixbuf(const Glib::RefPtr<Image>& src, const Glib::RefPtr<Colormap>& cmap,
int src_x, int src_y, int width, int height);
@@ -240,7 +240,7 @@ public:
* @param width Width in pixels of region to get.
* @param height Height in pixels of region to get.
*
- * @newin2p12
+ * @since{2,12}
*/
_WRAP_CREATE(const Glib::RefPtr<Drawable>& src, const Glib::RefPtr<Colormap>& cmap,
int src_x, int src_y, int width, int height)
@@ -253,7 +253,7 @@ public:
* @param width Width in pixels of region to get.
* @param height Height in pixels of region to get.
*
- * @newin2p12
+ * @since{2,12}
*/
_WRAP_CREATE(const Glib::RefPtr<Drawable>& src,
int src_x, int src_y, int width, int height)
@@ -267,7 +267,7 @@ public:
* @param width Width in pixels of region to get.
* @param height Height in pixels of region to get.
*
- * @newin2p12
+ * @since{2,12}
*/
_WRAP_CREATE(const Glib::RefPtr<Image>& src, const Glib::RefPtr<Colormap>& cmap,
int src_x, int src_y, int width, int height)
diff --git a/gdk/src/pixbufanimationiter.hg b/gdk/src/pixbufanimationiter.hg
index f0c2373..827721b 100644
--- a/gdk/src/pixbufanimationiter.hg
+++ b/gdk/src/pixbufanimationiter.hg
@@ -56,7 +56,7 @@ protected:
* if true, you need to call get_pixbuf() and update the
* display with the new pixbuf.
*
- * @newin2p14
+ * @since{2,14}
*
* @return true if the image may need updating.
*/
diff --git a/gdk/src/window.hg b/gdk/src/window.hg
index 12d6b2a..94d6efc 100644
--- a/gdk/src/window.hg
+++ b/gdk/src/window.hg
@@ -142,7 +142,7 @@ public:
* the display.
*
* @see set_back_pixmap().
- * @newin2p14
+ * @since{2,14}
*/
void unset_back_pixmap();
diff --git a/gtk/gtkmm/accelmap.h b/gtk/gtkmm/accelmap.h
index 1b3c16e..e1bd610 100644
--- a/gtk/gtkmm/accelmap.h
+++ b/gtk/gtkmm/accelmap.h
@@ -108,7 +108,7 @@ void save(const std::string& filename);
*
* @param accel_path a valid accelerator path
*
- * @newin2p4
+ * @since{2,4}
*/
void lock_path(const std::string& accel_path);
@@ -117,7 +117,7 @@ void lock_path(const std::string& accel_path);
*
* @param accel_path a valid accelerator path
*
- * @newin2p4
+ * @since{2,4}
*/
void unlock_path(const std::string& accel_path);
@@ -125,7 +125,7 @@ void unlock_path(const std::string& accel_path);
* @param accel_path A valid accelerator path.
* @result true if accel_path is known, false otherwise
*
- * @newin2p10
+ * @since{2,10}
*/
bool lookup_entry (const Glib::ustring& accel_path);
@@ -134,7 +134,7 @@ bool lookup_entry (const Glib::ustring& accel_path);
* @param key The accelerator key to be filled in.
* @result true if accel_path is known, false otherwise
*
- * @newin2p10
+ * @since{2,10}
*/
bool lookup_entry (const Glib::ustring& accel_path, Gtk::AccelKey& key);
diff --git a/gtk/gtkmm/listviewtext.h b/gtk/gtkmm/listviewtext.h
index 09d2c95..513dc43 100644
--- a/gtk/gtkmm/listviewtext.h
+++ b/gtk/gtkmm/listviewtext.h
@@ -36,7 +36,7 @@ namespace Gtk
* @ingroup Containers
* @ingroup TreeView
*
- * @newin2p10
+ * @since{2,10}
*/
class ListViewText : public Gtk::TreeView
{
diff --git a/gtk/src/activatable.hg b/gtk/src/activatable.hg
index fa00836..fcc5c76 100644
--- a/gtk/src/activatable.hg
+++ b/gtk/src/activatable.hg
@@ -31,7 +31,7 @@ namespace Gtk
* of the action. An Activatable can also provide feedback through its action,
* as it is responsible for activating the related action.
*
- * @newin2p16
+ * @since{2,16}
*/
class Activatable : public Glib::Interface
{
diff --git a/gtk/src/assistant.hg b/gtk/src/assistant.hg
index 5623698..51b9710 100644
--- a/gtk/src/assistant.hg
+++ b/gtk/src/assistant.hg
@@ -36,7 +36,7 @@ _WRAP_ENUM(AssistantPageType, GtkAssistantPageType)
* operation split into several steps, guiding the user through its
* pages and controlling the page flow to collect the necessary data.
*
- * @newin2p10
+ * @since{2,10}
* @ingroup Dialogs
*/
class Assistant : public Window
diff --git a/gtk/src/builder.hg b/gtk/src/builder.hg
index 1533d20..0dbd153 100644
--- a/gtk/src/builder.hg
+++ b/gtk/src/builder.hg
@@ -37,7 +37,7 @@ _WRAP_GERROR(BuilderError,GtkBuilderError,GTK_BUILDER_ERROR)
* is created. The Gtk::Builder object then provides an interface for accessing the
* widgets in the interface by the names assigned to them inside the UI description.
*
- * @newin2p12
+ * @since{2,12}
*/
class Builder : public Glib::Object
{
@@ -58,7 +58,7 @@ public:
* @result A new Builder object, or a null pointer if an error occurred.
* @throws Glib::FileError, Glib::MarkupError
*
- * @newin2p12
+ * @since{2,12}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
static Glib::RefPtr<Builder> create_from_file(const std::string& filename);
@@ -78,7 +78,7 @@ public:
* @result A new Builder object, or a null pointer if an error occurred.
* @throws Glib::FileError, Glib::MarkupError
*
- * @newin2p14
+ * @since{2,14}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
static Glib::RefPtr<Builder> create_from_file(const std::string& filename, const Glib::ustring& object_id);
@@ -98,7 +98,7 @@ public:
* @result A new Builder object, or a null pointer if an error occurred.
* @throws Glib::FileError, Glib::MarkupError
*
- * @newin2p16
+ * @since{2,16}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
static Glib::RefPtr<Builder> create_from_file(const std::string& filename, const char* object_id);
@@ -116,7 +116,7 @@ public:
* @result A new Builder object, or a null pointer if an error occurred.
* @throws Glib::FileError, Glib::MarkupError
*
- * @newin2p14
+ * @since{2,14}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
static Glib::RefPtr<Builder> create_from_file(const std::string& filename, const Glib::StringArrayHandle& object_ids);
@@ -130,7 +130,7 @@ public:
* @result A new Builder object, or a null pointer if an error occurred.
* @throws Glib::MarkupError
*
- * @newin2p12
+ * @since{2,12}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
static Glib::RefPtr<Builder> create_from_string(const Glib::ustring& buffer);
@@ -147,7 +147,7 @@ public:
* @result A new Builder object, or a null pointer if an error occurred.
* @throws Glib::MarkupError
*
- * @newin2p16
+ * @since{2,16}
*/
static Glib::RefPtr<Builder> create_from_string(const Glib::ustring& buffer, const char* object_id);
@@ -158,7 +158,7 @@ public:
* @result A new Builder object, or a null pointer if an error occurred.
* @throws Glib::MarkupError
*
- * @newin2p14
+ * @since{2,14}
*/
static Glib::RefPtr<Builder> create_from_string(const Glib::ustring& buffer, const Glib::ustring& object_id);
@@ -173,7 +173,7 @@ public:
* @result A new Builder object, or a null pointer if an error occurred.
* @throws Glib::MarkupError
*
- * @newin2p14
+ * @since{2,14}
*/
static Glib::RefPtr<Builder> create_from_string(const Glib::ustring& buffer, const Glib::StringArrayHandle& object_ids);
_IGNORE(gtk_builder_add_objects_from_file)
@@ -195,7 +195,7 @@ public:
* @result true on success or false if an error occurred.
* @throws Glib::MarkupError
*
- * @newin2p16
+ * @since{2,16}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
bool add_from_file(const std::string& filename, const char* object_id);
@@ -216,7 +216,7 @@ public:
* @result true on success or false if an error occurred.
* @throws Glib::MarkupError
*
- * @newin2p14
+ * @since{2,14}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
bool add_from_file(const std::string& filename, const Glib::ustring& object_id);
@@ -236,7 +236,7 @@ public:
* @result true on success or false if an error occurred.
* @throws Glib::MarkupError
*
- * @newin2p12
+ * @since{2,12}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
bool add_from_string(const Glib::ustring& buffer);
@@ -253,7 +253,7 @@ public:
* @result true on success or false if an error occurred.
* @throws Glib::MarkupError
*
- * @newin2p16
+ * @since{2,16}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
bool add_from_string(const Glib::ustring& buffer, const char* object_id);
@@ -270,7 +270,7 @@ public:
* @result true on success or false if an error occurred.
* @throws Glib::MarkupError
*
- * @newin2p14
+ * @since{2,14}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
bool add_from_string(const Glib::ustring& buffer, const Glib::ustring& object_id);
@@ -287,7 +287,7 @@ public:
* @result true on success or false if an error occurred.
* @throws Glib::MarkupError
*
- * @newin2p14
+ * @since{2,14}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
bool add_from_string(const Glib::ustring& buffer, const Glib::StringArrayHandle& object_ids);
diff --git a/gtk/src/calendar.hg b/gtk/src/calendar.hg
index 065ecfb..c9b2da9 100644
--- a/gtk/src/calendar.hg
+++ b/gtk/src/calendar.hg
@@ -92,7 +92,7 @@ public:
* specified day. Examples for such details are holidays or appointments. The
* function should return an empty string when no information is available.
*
- * @newin2p14
+ * @since{2,14}
*/
typedef sigc::slot<Glib::ustring, guint, guint, guint> SlotDetails;
@@ -109,7 +109,7 @@ public:
*
* @param slot A callback function providing details for each day.
*
- * @newin2p14
+ * @since{2,14}
*/
void set_detail_func(const SlotDetails& slot);
_IGNORE(gtk_calendar_set_detail_func)
diff --git a/gtk/src/cellrenderer.hg b/gtk/src/cellrenderer.hg
index b0d4efc..d2373e5 100644
--- a/gtk/src/cellrenderer.hg
+++ b/gtk/src/cellrenderer.hg
@@ -130,7 +130,7 @@ public:
* Note that this signal does not work yet in gtkmm.
* See http://bugzilla.gnome.org/show_bug.cgi?id=301597
*
- * @newin2p6
+ * @since{2,6}
*
* @param editable the CellEditable.
* @param path the path identifying the edited cell.
diff --git a/gtk/src/cellrendereraccel.hg b/gtk/src/cellrendereraccel.hg
index abf88db..89cea71 100644
--- a/gtk/src/cellrendereraccel.hg
+++ b/gtk/src/cellrendereraccel.hg
@@ -38,7 +38,7 @@ namespace Gtk
* simply typing the new combination.
*
* @ingroup TreeView
- * @newin2p10
+ * @since{2,10}
*/
class CellRendererAccel : public CellRendererText
{
diff --git a/gtk/src/cellrendererprogress.hg b/gtk/src/cellrendererprogress.hg
index 338a100..dcf1937 100644
--- a/gtk/src/cellrendererprogress.hg
+++ b/gtk/src/cellrendererprogress.hg
@@ -28,7 +28,7 @@ namespace Gtk
/** Renders numbers as progress bars.
*
* @ingroup TreeView
- * @newin2p6
+ * @since{2,6}
*/
class CellRendererProgress : public CellRenderer
{
diff --git a/gtk/src/cellrendererspin.hg b/gtk/src/cellrendererspin.hg
index b5cb876..522ad55 100644
--- a/gtk/src/cellrendererspin.hg
+++ b/gtk/src/cellrendererspin.hg
@@ -40,7 +40,7 @@ namespace Gtk
* signal.
*
* @ingroup TreeView
- * @newin2p12
+ * @since{2,12}
*/
class CellRendererSpin : public CellRendererText
{
diff --git a/gtk/src/cellview.hg b/gtk/src/cellview.hg
index 9f04358..90d1579 100644
--- a/gtk/src/cellview.hg
+++ b/gtk/src/cellview.hg
@@ -76,7 +76,7 @@ public:
*
* @see set_model().
*
- * @newin2p16
+ * @since{2,16}
*/
void unset_model();
diff --git a/gtk/src/clipboard.hg b/gtk/src/clipboard.hg
index 7a26b90..de9f452 100644
--- a/gtk/src/clipboard.hg
+++ b/gtk/src/clipboard.hg
@@ -189,7 +189,7 @@ public:
*
* @param slot A slot to call when the URIs are received, or the retrieval fails. (It will always be called one way or the other.)
*
- * @newin2p14
+ * @since{2,14}
*/
void request_uris(const SlotUrisReceived& slot);
_IGNORE(gtk_clipboard_request_uris)
@@ -231,7 +231,7 @@ public:
* is an intermediate type, so you should convert it to a
* standard C++ container.
*
- * @newin2p4
+ * @since{2,4}
*/
void request_targets(const SlotTargetsReceived& slot);
_IGNORE(gtk_clipboard_request_targets)
@@ -268,7 +268,7 @@ public:
*
* @result targets: The targets.
*
- * @newin2p4
+ * @since{2,4}
*/
Glib::StringArrayHandle wait_for_targets() const;
_IGNORE(gtk_clipboard_wait_for_targets)
diff --git a/gtk/src/colorbutton.hg b/gtk/src/colorbutton.hg
index a3777be..d287f50 100644
--- a/gtk/src/colorbutton.hg
+++ b/gtk/src/colorbutton.hg
@@ -51,7 +51,7 @@ public:
* open, allowing the user to select a color. The swatch will be updated to reflect the
* new color when the user finishes.
*
- * @newin2p4
+ * @since{2,4}
*/
_CTOR_DEFAULT()
_IGNORE(gtk_color_button_new)
@@ -64,7 +64,7 @@ public:
*
* @param color A Gdk::Color to set the current color with.
*
- * @newin2p4
+ * @since{2,4}
*/
_WRAP_CTOR(ColorButton(const Gdk::Color& color), gtk_color_button_new_with_color)
@@ -77,7 +77,7 @@ public:
*
* @return A Gdk::Color representing the current internal color of the Gtk::ColorButton.
*
- * @newin2p4
+ * @since{2,4}
*/
Gdk::Color get_color() const;
_IGNORE(gtk_color_button_get_color)
diff --git a/gtk/src/combobox.hg b/gtk/src/combobox.hg
index 3a02680..bbb97ab 100644
--- a/gtk/src/combobox.hg
+++ b/gtk/src/combobox.hg
@@ -116,7 +116,7 @@ public:
*
* @see set_model().
*
- * @newin2p16
+ * @since{2,16}
*/
void unset_model();
diff --git a/gtk/src/comboboxentry.hg b/gtk/src/comboboxentry.hg
index 76f53b0..8b6d4b7 100644
--- a/gtk/src/comboboxentry.hg
+++ b/gtk/src/comboboxentry.hg
@@ -85,7 +85,7 @@ public:
/** Returns the currently active string.
* @result The currently active text.
*
- * @newin2p14
+ * @since{2,14}
*/
Glib::ustring get_active_text() const;
diff --git a/gtk/src/entrycompletion.hg b/gtk/src/entrycompletion.hg
index 4029077..4495305 100644
--- a/gtk/src/entrycompletion.hg
+++ b/gtk/src/entrycompletion.hg
@@ -80,7 +80,7 @@ public:
*
* @see set_model().
*
- * @newin2p16
+ * @since{2,16}
*/
void unset_model();
@@ -179,7 +179,7 @@ public:
* @par Prototype:
* <tt>bool %on_cursor_on_match(const TreeModel::iterator& iter)</tt>
*
- * @newin2p12
+ * @since{2,12}
*/
Glib::SignalProxy1< bool, const TreeModel::iterator& > signal_cursor_on_match();
@@ -209,7 +209,7 @@ dnl
* the FileChooser inserts only the part of the prefix up to the
* next '/'.
*
- * @newin2p6
+ * @since{2,6}
*
* @param prefix The common prefix of all possible completions.
* @result true if the signal has been handled
diff --git a/gtk/src/enums.hg b/gtk/src/enums.hg
index 3f4e4a0..88ca7e3 100644
--- a/gtk/src/enums.hg
+++ b/gtk/src/enums.hg
@@ -168,7 +168,7 @@ public:
* @param settings A Gtk::Settings object, used to determine which set of user preferences to used.
* @result true if size was a valid size.
*
- * @newin2p14
+ * @since{2,14}
*/
static bool lookup(IconSize size, int& width, int& height, const Glib::RefPtr<Gtk::Settings>& settings);
diff --git a/gtk/src/expander.hg b/gtk/src/expander.hg
index 5f3768a..6a0f756 100644
--- a/gtk/src/expander.hg
+++ b/gtk/src/expander.hg
@@ -62,7 +62,7 @@ public:
*
* The Expander has an empty label.
*
- * @newin2p4
+ * @since{2,4}
*/
_CTOR_DEFAULT;
@@ -77,7 +77,7 @@ public:
* @param label The string for the label describing the Expander.
* @param mnemonic Wether the label may contain underscores to set up accelerators.
- * @newin2p4
+ * @since{2,4}
*/
explicit Expander(const Glib::ustring& label, bool mnemonic = false);
_IGNORE(gtk_expander_new, gkt_expander_new_with_mnemonic)
diff --git a/gtk/src/filechooserwidget.hg b/gtk/src/filechooserwidget.hg
index 53c9e97..a502311 100644
--- a/gtk/src/filechooserwidget.hg
+++ b/gtk/src/filechooserwidget.hg
@@ -54,7 +54,7 @@ public:
*
* @param action Open or save mode for the widget
*
- * @newin2p4
+ * @since{2,4}
*/
_WRAP_CTOR(FileChooserWidget(FileChooserAction action), gtk_file_chooser_widget_new)
_WRAP_CTOR(FileChooserWidget(FileChooserAction action, const Glib::ustring& backend), gtk_file_chooser_widget_new_with_backend)
diff --git a/gtk/src/icontheme.hg b/gtk/src/icontheme.hg
index 2a30a46..55765f3 100644
--- a/gtk/src/icontheme.hg
+++ b/gtk/src/icontheme.hg
@@ -74,7 +74,7 @@ public:
* @return A list holding the names of all the
* icons in the theme.
*
- * @newin2p10.
+ * @since{2,10}.
*/
Glib::ListHandle<Glib::ustring> list_icons() const;
diff --git a/gtk/src/iconview.hg b/gtk/src/iconview.hg
index 156fec1..bfa735a 100644
--- a/gtk/src/iconview.hg
+++ b/gtk/src/iconview.hg
@@ -62,7 +62,7 @@ public:
*
* @see set_model().
*
- * @newin2p16
+ * @since{2,16}
*/
void unset_model();
@@ -105,7 +105,7 @@ public:
*
* @result true if an item exists at the specified position.
*
- * @newin2p6
+ * @since{2,6}
*/
bool get_item_at_pos(int x, int y, TreeModel::Path& path, CellRenderer*& cell) const;
@@ -117,7 +117,7 @@ public:
*
* @result true if an item exists at the specified position.
*
- * @newin2p6
+ * @since{2,6}
*/
bool get_item_at_pos(int x, int y, TreeModel::Path& path) const;
@@ -129,7 +129,7 @@ public:
*
* @result true if an item exists at the specified position.
*
- * @newin2p6
+ * @since{2,6}
*/
bool get_item_at_pos(int x, int y, CellRenderer*& cell) const;
_IGNORE(gtk_icon_view_get_item_at_pos)
@@ -194,7 +194,7 @@ public:
* @param cell The current focus cell.
* @result true if the cursor is set.
*
- * @newin2p8
+ * @since{2,8}
*/
bool get_cursor(TreeModel::Path& path, CellRenderer*& cell) const;
@@ -205,7 +205,7 @@ public:
* @param path The current cursor path.
* @result true if the cursor is set.
*
- * @newin2p8
+ * @since{2,8}
*/
bool get_cursor(TreeModel::Path& path) const;
@@ -216,7 +216,7 @@ public:
* @param cell The current focus cell.
* @result true if the cursor is set.
*
- * @newin2p8
+ * @since{2,8}
*/
bool get_cursor(CellRenderer*& cell) const;
_IGNORE(gtk_icon_view_get_cursor)
@@ -260,7 +260,7 @@ public:
* @param path The highlighted item.
* @pos The drop position.
*
- * @newin2p10
+ * @since{2,10}
*/
void get_drag_dest_item(TreeModel::Path& path, IconViewDropPosition& pos) const;
@@ -268,7 +268,7 @@ public:
*
* @param path The highlighted item.
*
- * @newin2p10
+ * @since{2,10}
*/
void get_drag_dest_item(TreeModel::Path& path) const;
@@ -276,7 +276,7 @@ public:
*
* @pos The drop position.
*
- * @newin2p10
+ * @since{2,10}
*/
void get_drag_dest_item(IconViewDropPosition& pos) const;
_IGNORE(gtk_icon_view_get_drag_dest_item)
@@ -289,7 +289,7 @@ public:
* @param pos: The drop position.
* @result whether there is an item at the given position.
*
- * @newin2p10
+ * @since{2,10}
*/
bool get_dest_item_at_pos(int drag_x, int drag_y, TreeModel::Path& path, IconViewDropPosition& pos) const;
@@ -300,7 +300,7 @@ public:
* @param path The path of the item.
* @result whether there is an item at the given position.
*
- * @newin2p10
+ * @since{2,10}
*/
bool get_dest_item_at_pos(int drag_x, int drag_y, TreeModel::Path& path) const;
@@ -311,7 +311,7 @@ public:
* @param pos: The drop position.
* @result whether there is an item at the given position.
*
- * @newin2p10
+ * @since{2,10}
*/
bool get_dest_item_at_pos(int drag_x, int drag_y, IconViewDropPosition& pos) const;
_IGNORE(gtk_icon_view_get_dest_item_at_pos)
@@ -326,7 +326,7 @@ public:
/** Sets the tip area of @a tooltip to the area occupied by
* the item pointed to by @a path. See also Tooltip::set_tip_area().
*
- * @newin2p12
+ * @since{2,12}
* @param tooltip A Gtk::Tooltip.
* @param path A Gtk::TreePath.
*/
@@ -354,7 +354,7 @@ public:
*
* Return value: whether or not the given tooltip context points to a item.
*
- * @newin2p12
+ * @since{2,12}
*/
bool get_tooltip_context_path(int& x, int& y,
bool keyboard_tip,
@@ -380,7 +380,7 @@ public:
*
* Return value: whether or not the given tooltip context points to a item.
*
- * @newin2p12
+ * @since{2,12}
*/
bool get_tooltip_context_iter(int& x, int& y,
bool keyboard_tip,
diff --git a/gtk/src/image.hg b/gtk/src/image.hg
index ec3ba53..5bfdb3b 100644
--- a/gtk/src/image.hg
+++ b/gtk/src/image.hg
@@ -144,7 +144,7 @@ public:
*
* @param icon_size A place to store an icon size.
*
- * @newin2p14
+ * @since{2,14}
*/
Glib::RefPtr<Gio::Icon> get_gicon(Gtk::IconSize& icon_size);
@@ -154,7 +154,7 @@ public:
*
* @param icon_size A place to store an icon size.
*
- * @newin2p14
+ * @since{2,14}
*/
Glib::RefPtr<const Gio::Icon> get_gicon(Gtk::IconSize& icon_size) const;
_IGNORE(gtk_image_get_gicon)
diff --git a/gtk/src/infobar.hg b/gtk/src/infobar.hg
index ca9fbab..45ec4c0 100644
--- a/gtk/src/infobar.hg
+++ b/gtk/src/infobar.hg
@@ -32,7 +32,7 @@ namespace Gtk
*
* The InfoBar widget looks like this: TODO
*
- * @newin2p18
+ * @since{2,18}
*
* @ingroup Widgets
*/
diff --git a/gtk/src/linkbutton.hg b/gtk/src/linkbutton.hg
index 1ebe346..44e8c0d 100644
--- a/gtk/src/linkbutton.hg
+++ b/gtk/src/linkbutton.hg
@@ -40,7 +40,7 @@ namespace Gtk
* The LinkButton widget looks like this:
* @image html linkbutton1.png
*
- * @newin2p10
+ * @since{2,10}
* @ingroup Widgets
*/
class LinkButton : public Button
@@ -69,14 +69,14 @@ public:
* This function is called before every signal handler registered for the "clicked" signal.
*
* @param slot A function called each time a LinkButton is clicked.
- * @newin2p12
+ * @since{2,12}
*/
static void set_uri_hook(const SlotUri& slot);
_IGNORE(gtk_link_button_set_uri_hook)
/** Unsets any previously set slot as the function that should be invoked every time a user clicks a LinkButton.
* @see set_uri_hook().
- * @newin2p12
+ * @since{2,12}
*/
static void unset_uri_hook();
diff --git a/gtk/src/menu.hg b/gtk/src/menu.hg
index f989937..db6de67 100644
--- a/gtk/src/menu.hg
+++ b/gtk/src/menu.hg
@@ -139,7 +139,7 @@ protected:
*
* param @attach_widget: the Widget that the menu will be attached to.
*
- * @newin2p10
+ * @since{2,10}
*/
void attach_to_widget(Widget& attach_widget);
};
diff --git a/gtk/src/messagedialog.hg b/gtk/src/messagedialog.hg
index 2d4094c..7bf4eda 100644
--- a/gtk/src/messagedialog.hg
+++ b/gtk/src/messagedialog.hg
@@ -71,7 +71,7 @@ public:
/** Sets the secondary text of the message dialog.
* Note that setting a secondary text makes the primary text become bold, unless you have provided explicit markup.
*
- * @newin2p6.
+ * @since{2,6}.
*
* @param text The message.
* @param use_markup Whether @a message contains pango markup.
diff --git a/gtk/src/orientable.hg b/gtk/src/orientable.hg
index e8c1843..16f9b29 100644
--- a/gtk/src/orientable.hg
+++ b/gtk/src/orientable.hg
@@ -33,7 +33,7 @@ namespace Gtk
* GtkScale/GtkHScale/GtkVScale). GtkOrientable is more flexible in that it
* allows the orientation to be changed at runtime, allowing the widgets to 'flip'.
*
- * @newin2p16
+ * @since{2,16}
*/
class Orientable : public Glib::Interface
{
diff --git a/gtk/src/pagesetup.hg b/gtk/src/pagesetup.hg
index e0ccf05..6270d2e 100644
--- a/gtk/src/pagesetup.hg
+++ b/gtk/src/pagesetup.hg
@@ -36,7 +36,7 @@ namespace Gtk
* To obtain a PageSetup use PageSetup::create() to get the defaults, or use run_page_setup_dialog() to show the page
* setup dialog and receive the resulting page setup.
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup Printing
*/
@@ -58,7 +58,7 @@ public:
*
* @throws KeyFileError
*
- * @newin2p14
+ * @since{2,14}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
static Glib::RefPtr<PageSetup> create_from_key_file(const Glib::KeyFile& key_file);
@@ -76,7 +76,7 @@ public:
*
* @throws KeyFileError
*
- * @newin2p14
+ * @since{2,14}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
static Glib::RefPtr<PageSetup> create_from_key_file(const Glib::KeyFile& key_file, const Glib::ustring& group_name);
@@ -92,7 +92,7 @@ public:
* @param file_name The filename to read the page setup from.
* @result The restored PageSetup
*
- * @newin2p14
+ * @since{2,14}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
static Glib::RefPtr<PageSetup> create_from_file(const std::string& file_name);
@@ -116,7 +116,7 @@ public:
*
* @throws KeyFileError
*
- * @newin2p14
+ * @since{2,14}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
bool load_from_key_file(const Glib::KeyFile& key_file);
@@ -163,7 +163,7 @@ public:
/** This function adds the page setup from @a setup to @a key_file,
* in the group "Page Setup"
*
- * @newin2p12
+ * @since{2,12}
* @param key_file The G::KeyFile to save the page setup to.
*
* @deprecated Use the const version.
@@ -174,7 +174,7 @@ public:
/** This function adds the page setup from @a setup to @a key_file,
* in the group "Page Setup"
*
- * @newin2p12
+ * @since{2,12}
* @param key_file The G::KeyFile to save the page setup to.
*/
void save_to_key_file(Glib::KeyFile& key_file) const;
diff --git a/gtk/src/pagesetupunixdialog.hg b/gtk/src/pagesetupunixdialog.hg
index 4c1ab88..c77a9ad 100644
--- a/gtk/src/pagesetupunixdialog.hg
+++ b/gtk/src/pagesetupunixdialog.hg
@@ -31,7 +31,7 @@ namespace Gtk
* the portability offered by the high-level printing API exposed
* through PrintOperation.
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup Printing
*/
diff --git a/gtk/src/papersize.hg b/gtk/src/papersize.hg
index ba2d0be..e772b94 100644
--- a/gtk/src/papersize.hg
+++ b/gtk/src/papersize.hg
@@ -40,7 +40,7 @@ _WRAP_ENUM(Unit, GtkUnit)
* The PaperSize object stores not only the dimensions (width and height) of a paper size and its name, it also provides
* default print margins.
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup Printing
*/
@@ -62,7 +62,7 @@ public:
bool equal(const PaperSize& other) const;
/** Returns true if the PaperSize is a valid object.
- * @newin2p12
+ * @since{2,12}
*/
operator bool() const;
@@ -91,7 +91,7 @@ public:
/** This function adds the paper size to @a key_file in the first group.
*
- * @newin2p12
+ * @since{2,12}
* @param key_file The Glib::KeyFile to save the paper size to.
*/
void save_to_key_file(Glib::KeyFile& key_file);
diff --git a/gtk/src/printcontext.hg b/gtk/src/printcontext.hg
index 74f23fc..a204ed7 100644
--- a/gtk/src/printcontext.hg
+++ b/gtk/src/printcontext.hg
@@ -40,7 +40,7 @@ namespace Gtk
* PrintContext objects gets passed to the begin-print, end-print,
* request-page-setup and draw-page signals on the PrintOperation.
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup Printing
*/
diff --git a/gtk/src/printer.hg b/gtk/src/printer.hg
index dd49953..9b6d8b3 100644
--- a/gtk/src/printer.hg
+++ b/gtk/src/printer.hg
@@ -32,7 +32,7 @@ _WRAP_ENUM(PrintCapabilities, GtkPrintCapabilities)
* the number of queued jobs, etc. Most importantly, a Printer object can be used to create a PrintJob object,
* which lets you print to the printer.
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup Printing
*/
diff --git a/gtk/src/printjob.hg b/gtk/src/printjob.hg
index 1e78c23..699790f 100644
--- a/gtk/src/printjob.hg
+++ b/gtk/src/printjob.hg
@@ -35,7 +35,7 @@ namespace Gtk
* Use send() to send the finished job to the printer.If you don't use cairo then
* PrintJob also supports printing of manually generated postscript, via set_source_file().
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup Printing
*/
diff --git a/gtk/src/printoperation.hg b/gtk/src/printoperation.hg
index 4ff2d32..ec974c1 100644
--- a/gtk/src/printoperation.hg
+++ b/gtk/src/printoperation.hg
@@ -52,7 +52,7 @@ _WRAP_GERROR(PrintError, GtkPrintError, GTK_PRINT_ERROR)
* emitted by the PrintOperation for you to handle, the main one being draw_page. You should then
* render the page on the provided PrintContext using Cairo.
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup Printing
*/
diff --git a/gtk/src/printoperationpreview.hg b/gtk/src/printoperationpreview.hg
index 183673e..e452e70 100644
--- a/gtk/src/printoperationpreview.hg
+++ b/gtk/src/printoperationpreview.hg
@@ -31,7 +31,7 @@ namespace Gtk
//TODO: There is no GtkPrintOperationPreview documentation either.
// See http://bugzilla.gnome.org/show_bug.cgi?id=575538
/**
- * @newin2p10
+ * @since{2,10}
*
* @ingroup Printing
*/
diff --git a/gtk/src/printsettings.hg b/gtk/src/printsettings.hg
index 60eb354..29339d1 100644
--- a/gtk/src/printsettings.hg
+++ b/gtk/src/printsettings.hg
@@ -40,7 +40,7 @@ _WRAP_ENUM(NumberUpLayout, GtkNumberUpLayout)
* next time your app runs, or even store them in a document. The predefined keys try to use shared
* values as much as possible so that moving such a document between systems still works.
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup Printing
*/
@@ -63,7 +63,7 @@ protected:
*
* @throws KeyFileError
*
- * @newin2p14
+ * @since{2,14}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
static Glib::RefPtr<PrintSettings> create_from_key_file(const Glib::KeyFile& key_file);
@@ -82,7 +82,7 @@ protected:
*
* @throws KeyFileError
*
- * @newin2p14
+ * @since{2,14}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
static Glib::RefPtr<PrintSettings> create_from_key_file(const Glib::KeyFile& key_file, const Glib::ustring& group_name);
@@ -100,7 +100,7 @@ protected:
*
* @throws KeyFileError
*
- * @newin2p14
+ * @since{2,14}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
static Glib::RefPtr<PrintSettings> create_from_file(const std::string& file_name);
@@ -164,7 +164,7 @@ public:
*
* @throws KeyFileError
*
- * @newin2p14
+ * @since{2,14}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
bool load_from_key_file(const Glib::KeyFile& key_file);
@@ -183,7 +183,7 @@ public:
/** This function adds the print settings from @a settings to @a key_file,
* in the "Print Settings" group.
*
- * @newin2p12
+ * @since{2,12}
* @param key_file The Glib::KeyFile to save the print settings to.
*
* @deprecated Use the const version.
@@ -194,7 +194,7 @@ public:
/** This function adds the print settings from @a settings to @a key_file,
* in the "Print Settings" group.
*
- * @newin2p12
+ * @since{2,12}
* @param key_file The Glib::KeyFile to save the print settings to.
*/
void save_to_key_file(Glib::KeyFile& key_file) const;
diff --git a/gtk/src/printunixdialog.hg b/gtk/src/printunixdialog.hg
index 8a127c1..caf1da0 100644
--- a/gtk/src/printunixdialog.hg
+++ b/gtk/src/printunixdialog.hg
@@ -42,7 +42,7 @@ namespace Gtk
* - RESPONSE_APPLY for the "Preview" button
* - RESPONSE_CANCEL for the "Cancel" button
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup Printing
*/
diff --git a/gtk/src/radiotoolbutton.hg b/gtk/src/radiotoolbutton.hg
index 8f82dd3..6e410c8 100644
--- a/gtk/src/radiotoolbutton.hg
+++ b/gtk/src/radiotoolbutton.hg
@@ -48,7 +48,7 @@ public:
* Use get_group() to retrieve this group and pass it to other radio buttons to assign
* them to this group.
*
- * @newin2p4
+ * @since{2,4}
*/
_CTOR_DEFAULT()
@@ -60,7 +60,7 @@ public:
* @param group The existing group which will be used for this RadioButton.
* @param label The string used to display the label for this RadioToolButton.
*
- * @newin2p4
+ * @since{2,4}
*/
explicit RadioToolButton(Group& group, const Glib::ustring& label = Glib::ustring());
_IGNORE(gtk_radio_tool_button_new)
@@ -73,7 +73,7 @@ public:
* @param group The existing group which will be used for this RadioButton.
* @param stock_id The StockID which determines the look of the RadioToolButton.
*
- * @newin2p4
+ * @since{2,4}
*/
RadioToolButton(Group& group, const Gtk::StockID& stock_id);
_IGNORE(gtk_radio_tool_button_new_from_stock)
@@ -94,7 +94,7 @@ public:
* @param icon_widget The widget placed as the RadioToolButton's icon.
* @param label The string used to display the label for this RadioToolButton.
*
- * @newin2p4
+ * @since{2,4}
*/
explicit RadioToolButton(Widget& icon_widget, const Glib::ustring& label = Glib::ustring());
diff --git a/gtk/src/rc.hg b/gtk/src/rc.hg
index dccffd1..e8e95cf 100644
--- a/gtk/src/rc.hg
+++ b/gtk/src/rc.hg
@@ -160,7 +160,7 @@ public:
*
* @param settings a Gtk::Settings
*
- * @newin2p4
+ * @since{2,4}
*/
static void reset_styles(const Glib::RefPtr<Settings>& settings);
diff --git a/gtk/src/recentaction.hg b/gtk/src/recentaction.hg
index d7d1f60..891814f 100644
--- a/gtk/src/recentaction.hg
+++ b/gtk/src/recentaction.hg
@@ -41,7 +41,7 @@ namespace Gtk
*
* See also the methods in the RecentChooser base class.
*
- * @newin2p12
+ * @since{2,12}
*
* @ingroup RecentFiles
*/
diff --git a/gtk/src/recentchooser.hg b/gtk/src/recentchooser.hg
index 235c32e..e9dd11a 100644
--- a/gtk/src/recentchooser.hg
+++ b/gtk/src/recentchooser.hg
@@ -38,7 +38,7 @@ _WRAP_GERROR(RecentChooserError,GtkRecentChooserError,GTK_RECENT_CHOOSER_ERROR)
* that implement this interface are RecentChooserWidget, RecentChooserDialog
* and RecentChooserMenu.
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup RecentFiles
*/
diff --git a/gtk/src/recentchooserdialog.hg b/gtk/src/recentchooserdialog.hg
index 5d06ebe..48c111b 100644
--- a/gtk/src/recentchooserdialog.hg
+++ b/gtk/src/recentchooserdialog.hg
@@ -38,7 +38,7 @@ namespace Gtk
* A RecentChooserDialog looks like this:
* @image html recentchooserdialog1.png
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup RecentFiles
*/
diff --git a/gtk/src/recentchoosermenu.hg b/gtk/src/recentchoosermenu.hg
index 9abfe44..fdbac64 100644
--- a/gtk/src/recentchoosermenu.hg
+++ b/gtk/src/recentchoosermenu.hg
@@ -35,7 +35,7 @@ namespace Gtk
* Note that RecentChooserMenu does not have any methods of its own. Instead,
* you should use the functions that work on a RecentChooser.
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup RecentFiles
*/
diff --git a/gtk/src/recentchooserwidget.hg b/gtk/src/recentchooserwidget.hg
index 980f9fe..74428f4 100644
--- a/gtk/src/recentchooserwidget.hg
+++ b/gtk/src/recentchooserwidget.hg
@@ -32,7 +32,7 @@ namespace Gtk
* Note that RecentChooserWidget does not have any methods of its own.
* Instead, you should use the functions that work on a RecentChooser.
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup RecentFiles
*/
diff --git a/gtk/src/recentfilter.hg b/gtk/src/recentfilter.hg
index 4e3cfa7..b38dbc5 100644
--- a/gtk/src/recentfilter.hg
+++ b/gtk/src/recentfilter.hg
@@ -42,7 +42,7 @@ _WRAP_ENUM(RecentFilterFlags, GtkRecentFilterFlags)
* see RecentChooser::add_filter(), but it is also possible to
* manually use a filter on a file with filter().
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup RecentFiles
*/
diff --git a/gtk/src/recentinfo.hg b/gtk/src/recentinfo.hg
index bd43fe1..cf25c09 100644
--- a/gtk/src/recentinfo.hg
+++ b/gtk/src/recentinfo.hg
@@ -32,7 +32,7 @@ namespace Gtk
/** Contains informations found when looking up an entry of the
* recently used files list.
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup RecentFiles
*/
diff --git a/gtk/src/recentmanager.hg b/gtk/src/recentmanager.hg
index 96f4be5..8b89116 100644
--- a/gtk/src/recentmanager.hg
+++ b/gtk/src/recentmanager.hg
@@ -54,7 +54,7 @@ _WRAP_GERROR(RecentManagerError, GtkRecentManagerError, GTK_RECENT_MANAGER_ERROR
* get_for_screen() and it will contain information about current
* recent manager for that screen.
*
- * @newin2p10
+ * @since{2,10}
*
* @ingroup RecentFiles
*/
diff --git a/gtk/src/scalebutton.hg b/gtk/src/scalebutton.hg
index 6bf78f4..796e404 100644
--- a/gtk/src/scalebutton.hg
+++ b/gtk/src/scalebutton.hg
@@ -38,7 +38,7 @@ namespace Gtk
* for this use case.
*
* @ingroup Widgets
- * @newin2p12
+ * @since{2,12}
*/
class ScaleButton : public Button
{
diff --git a/gtk/src/selectiondata.hg b/gtk/src/selectiondata.hg
index 4cf3111..9f0b6fd 100644
--- a/gtk/src/selectiondata.hg
+++ b/gtk/src/selectiondata.hg
@@ -96,7 +96,7 @@ public:
/** Retrieves the target of the selection.
*
- * @newin2p14
+ * @since{2,14}
**/
std::string get_target() const;
_IGNORE(gtk_selection_data_get_target)
diff --git a/gtk/src/statusicon.hg b/gtk/src/statusicon.hg
index 1f048e3..1e39385 100644
--- a/gtk/src/statusicon.hg
+++ b/gtk/src/statusicon.hg
@@ -47,7 +47,7 @@ namespace Gtk
* Implementations of the "tray" side of this specification can be found e.g. in the GNOME and KDE
* panel applications.
*
- * @newin2p10
+ * @since{2,10}
*/
class StatusIcon : public Glib::Object
{
@@ -75,7 +75,7 @@ public:
* @param filename A filename.
* @result A new StatusIcon
*
- * @newin2p10
+ * @since{2,10}
*/
static Glib::RefPtr<StatusIcon> create_from_file(const std::string& filename);
_IGNORE(gtk_status_icon_new_from_file)
@@ -124,7 +124,7 @@ public:
* @param button The mouse button which was pressed to initiate the event.
* @param activate_time The time at which the activation event occurred.
*
- * @newin2p12
+ * @since{2,12}
*/
void popup_menu_at_position(Menu& menu, guint button, guint32 activate_time);
_IGNORE(gtk_status_icon_position_menu)
@@ -151,7 +151,7 @@ public:
* at the top or bottom of the screen is horizontal, a panel at the left or right is vertical.
* @result true if the location information has been filled in.
*
- * @newin2p10
+ * @since{2,10}
*/
bool get_geometry(Glib::RefPtr<Gdk::Screen>& screen, Gdk::Rectangle& area, Orientation& orientation);
_IGNORE(gtk_status_icon_get_geometry)
diff --git a/gtk/src/style.hg b/gtk/src/style.hg
index f78ecdf..9d4ac6f 100644
--- a/gtk/src/style.hg
+++ b/gtk/src/style.hg
@@ -423,7 +423,7 @@ public:
* @param property_name The name of the style property to get.
* @param value: An output parameter in which the value of the property being queried will be stored.
*
- * @newin2p16
+ * @since{2,16}
*/
template <class PropertyType>
void get_style_property(GType widget_type, const Glib::ustring& property_name, PropertyType& value) const;
diff --git a/gtk/src/textbuffer.hg b/gtk/src/textbuffer.hg
index df7495d..ff35df1 100644
--- a/gtk/src/textbuffer.hg
+++ b/gtk/src/textbuffer.hg
@@ -339,7 +339,7 @@ public:
* @param default_editable Whether the buffer is editable by default.
* @result An iterator to the location where text was deleted, if the buffer was modified.
*
- * @newin2p6
+ * @since{2,6}
*/
iterator backspace(const iterator& iter, bool interactive = true, bool default_editable = true);
_IGNORE(gtk_text_buffer_backspace)
diff --git a/gtk/src/textmark.hg b/gtk/src/textmark.hg
index 5d566d8..1697bd5 100644
--- a/gtk/src/textmark.hg
+++ b/gtk/src/textmark.hg
@@ -74,7 +74,7 @@ protected:
* @param name mark name.
* @param left_gravity Whether the mark should have left gravity.
- * @newin2p12
+ * @since{2,12}
*/
explicit TextMark(bool left_gravity = true);
@@ -89,7 +89,7 @@ protected:
* @param name mark name.
* @param left_gravity Whether the mark should have left gravity.
- * @newin2p12
+ * @since{2,12}
*/
_WRAP_CTOR(TextMark(const Glib::ustring& name, bool left_gravity = true), gtk_text_mark_new)
@@ -107,7 +107,7 @@ public:
* @param name mark name.
* @param left_gravity Whether the mark should have left gravity.
* @result A RefPtr to a new text mark.
- * @newin2p12
+ * @since{2,12}
*/
_WRAP_CREATE(bool left_gravity = true)
@@ -123,7 +123,7 @@ public:
* @param name mark name.
* @param left_gravity Whether the mark should have left gravity.
* @result A RefPtr to a new text mark.
- * @newin2p12
+ * @since{2,12}
*/
_WRAP_CREATE(const Glib::ustring& name, bool left_gravity = true)
diff --git a/gtk/src/toolshell.hg b/gtk/src/toolshell.hg
index 1443e97..04b6828 100644
--- a/gtk/src/toolshell.hg
+++ b/gtk/src/toolshell.hg
@@ -32,7 +32,7 @@ namespace Gtk
/** A base class for containers containing ToolItem widgets.
* This interface allows container widgets to provide additional information when embedding ToolItem widgets.
*
- * @newin2p14
+ * @since{2,14}
*/
class ToolShell : public Glib::Interface
{
diff --git a/gtk/src/tooltip.hg b/gtk/src/tooltip.hg
index 954962a..5ab83d3 100644
--- a/gtk/src/tooltip.hg
+++ b/gtk/src/tooltip.hg
@@ -69,7 +69,7 @@ namespace Gtk
* wish. The semantics of the return value are exactly as before,
* return true to show the window, false to not show it.
*
- * @newin2p12
+ * @since{2,12}
*/
class Tooltip : public Glib::Object
{
diff --git a/gtk/src/treemodel.hg b/gtk/src/treemodel.hg
index 77fb87d..d69c066 100644
--- a/gtk/src/treemodel.hg
+++ b/gtk/src/treemodel.hg
@@ -201,7 +201,7 @@ public:
/** Emits the "rows_reordered" signal on the tree model. This should be called by
* custom models when their rows have been reordered. This method overload is for nodes whose
* path has a depth of 0.
- * @newin2p10
+ * @since{2,10}
*
* @param path A tree path pointing to the tree node whose children have been reordered.
* @param new_order An array of integers mapping the current position of each child
diff --git a/gtk/src/treepath.hg b/gtk/src/treepath.hg
index 7a67b18..7c4233a 100644
--- a/gtk/src/treepath.hg
+++ b/gtk/src/treepath.hg
@@ -84,7 +84,7 @@ public:
TreePath& operator=(const TreeModel::iterator& iter);
/** Checks that the path is not empty, by calling empty().
- * @newin2p16
+ * @since{2,16}
*/
operator bool() const;
diff --git a/gtk/src/treeview.hg b/gtk/src/treeview.hg
index 83cda58..e368036 100644
--- a/gtk/src/treeview.hg
+++ b/gtk/src/treeview.hg
@@ -128,7 +128,7 @@ public:
*
* @see set_model().
*
- * @newin2p8
+ * @since{2,8}
*/
void unset_model();
@@ -526,7 +526,7 @@ public:
* can be placed
* @return true if a row exists at that coordinate.
*
- * @newin2p8
+ * @since{2,8}
*/
bool get_path_at_pos(int x, int y, TreeModel::Path& path, TreeViewColumn*& column, int& cell_x, int& cell_y) const;
@@ -744,7 +744,7 @@ public:
*
* Return value: whether or not the given tooltip context points to a row.
*
- * @newin2p12
+ * @since{2,12}
*/
bool get_tooltip_context_path(int& x, int& y,
bool keyboard_tip,
@@ -770,7 +770,7 @@ public:
*
* Return value: whether or not the given tooltip context points to a row.
*
- * @newin2p12
+ * @since{2,12}
*/
bool get_tooltip_context_iter(int& x, int& y,
bool keyboard_tip,
diff --git a/gtk/src/uimanager.hg b/gtk/src/uimanager.hg
index c0888cd..6bb3e4c 100644
--- a/gtk/src/uimanager.hg
+++ b/gtk/src/uimanager.hg
@@ -171,7 +171,7 @@ _WRAP_ENUM(UIManagerItemType, GtkUIManagerItemType)
*
* The behaviour is chosen based on the "hide_if_empty" property of the action to which the submenu is associated.
*
- * @newin2p4
+ * @since{2,4}
*/
class UIManager : public Glib::Object
{
@@ -214,7 +214,7 @@ public:
* @param buffer the string to parse
* @result The merge id for the merged UI. The merge id can be used to unmerge the UI with remove_ui(). If an error occurred, the return value is 0.
* @throws exception
- * @newin2p4
+ * @since{2,4}
*/
#ifdef GLIBMM_EXCEPTIONS_ENABLED
ui_merge_id add_ui_from_string(const Glib::ustring& buffer);
@@ -237,7 +237,7 @@ public:
*
* @see add_ui().
*
- * @newin2p4
+ * @since{2,4}
* @param merge_id The merge id for the merged UI, see gtk_ui_manager_new_merge_id().
* @param path A path.
* @param name The name for the added UI element.
diff --git a/gtk/src/volumebutton.hg b/gtk/src/volumebutton.hg
index 33ddf4d..251e538 100644
--- a/gtk/src/volumebutton.hg
+++ b/gtk/src/volumebutton.hg
@@ -34,7 +34,7 @@ namespace Gtk
* accessible labels.
*
* @ingroup Widgets
- * @newin2p12
+ * @since{2,12}
*/
class VolumeButton : public ScaleButton
{
diff --git a/gtk/src/widget.hg b/gtk/src/widget.hg
index 2121050..c2dfa24 100644
--- a/gtk/src/widget.hg
+++ b/gtk/src/widget.hg
@@ -295,7 +295,7 @@ public:
*
* @result A Gdk::Pixmap snapshot of the widget
*
- * @newin2p14
+ * @since{2,14}
*/
Glib::RefPtr<Gdk::Pixmap> get_snapshot() const;
@@ -377,7 +377,7 @@ public:
* @param primary the color to use for primary cursor (does not need to be allocated).
* @param secondary the color to use for secondary cursor (does not need to be allocated).
*
- * @newin2p12
+ * @since{2,12}
*/
_WRAP_METHOD(void modify_cursor(const Gdk::Color& primary, const Gdk::Color& secondary), gtk_widget_modify_cursor)
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
