Implement 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.
(PREDEFINED): Predefine G_GNUC_NORETURN, G_GNUC_NULL_TERMINATED and
G_GNUC_PURE to the empty expansion.  Remove GTKMM_* macros.
* tools/pm/DocsParser.pm (convert_tags_to_doxygen): Change "Since:"
substitution to output the new generic @since alias.
* {glib,gio}/src/*.hg, {glib,gio}/{glib,gio}mm/*.h: Change all uses
of @newin?p?* to @since{major,minor}.

5 files changed, 26 insertions, 26 deletions

diff --git a/glib/glibmm/main.h b/glib/glibmm/main.h
index 840379f9..99fca308 100644
--- a/glib/glibmm/main.h
+++ b/glib/glibmm/main.h
@@ -191,7 +191,7 @@ public:
    * @param priority The priority of the new event source.
    * @return A connection handle, which can be used to disconnect the handler.
    *
-   * @newin2p14
+   * @since{2,14}
    */
   sigc::connection connect_seconds(const sigc::slot<bool>& slot, unsigned int interval,
                            int priority = PRIORITY_DEFAULT);
diff --git a/glib/glibmm/miscutils.h b/glib/glibmm/miscutils.h
index 407287e4..dfa765b8 100644
--- a/glib/glibmm/miscutils.h
+++ b/glib/glibmm/miscutils.h
@@ -168,7 +168,7 @@ std::string get_current_dir();
  * Return value: the path to the specified special directory.
  * @param directory Te logical id of special directory
  * 
- * @newin2p14
+ * @since{2,14}
  */
 std::string get_user_special_dir(GUserDirectory directory);
 
@@ -178,7 +178,7 @@ std::string get_user_special_dir(GUserDirectory directory);
  * On UNIX platforms this is determined using the mechanisms described in the
  * XDG Base Directory Specification
  *
- * @newin2p14
+ * @since{2,14}
  */
 std::string get_user_data_dir();
 
@@ -188,7 +188,7 @@ std::string get_user_data_dir();
  * On UNIX platforms this is determined using the mechanisms described in the
  * XDG Base Directory Specification
  *
- * @newin2p14
+ * @since{2,14}
  */
 std::string get_user_config_dir();
 
@@ -198,7 +198,7 @@ std::string get_user_config_dir();
  * On UNIX platforms this is determined using the mechanisms described in the
  * XDG Base Directory Specification
  *
- * @newin2p14
+ * @since{2,14}
  */
 std::string get_user_cache_dir();
 
diff --git a/glib/glibmm/refptr.h b/glib/glibmm/refptr.h
index 381188f4..a72d7f9f 100644
--- a/glib/glibmm/refptr.h
+++ b/glib/glibmm/refptr.h
@@ -121,7 +121,7 @@ public:
 #endif //GLIBMM_DISABLE_DEPRECATED
 
   /** Set underlying instance to 0, decrementing reference count of existing instance appropriately.
-   * @newin2p16
+   * @since{2,16}
    */
   inline void reset();
 
diff --git a/glib/glibmm/timeval.h b/glib/glibmm/timeval.h
index 7e496525..387be842 100644
--- a/glib/glibmm/timeval.h
+++ b/glib/glibmm/timeval.h
@@ -53,7 +53,7 @@ struct TimeVal : public GTimeVal
    * @param iso_date ISO 8601 encoded string.
    * @return <tt>true</tt> if conversion was successful.
    *
-   * @newin2p22
+   * @since{2,22}
    */
   bool assign_from_iso8601(const Glib::ustring& iso_date);
 
@@ -81,7 +81,7 @@ struct TimeVal : public GTimeVal
   /** Returns an ISO 8601 encoded string, relative to the Coordinated
    * Universal Time (UTC).
    *
-   * @newin2p22
+   * @since{2,22}
    */
   Glib::ustring as_iso8601() const;
 
diff --git a/glib/glibmm/ustring.h b/glib/glibmm/ustring.h
index 37142079..7b03caf4 100644
--- a/glib/glibmm/ustring.h
+++ b/glib/glibmm/ustring.h
@@ -598,7 +598,7 @@ public:
 //! @{
 
   /* Returns fmt as is, but checks for invalid references in the format string.
-   * @newin2p18
+   * @since{2,18}
    */
   template <class T1>
   static inline
@@ -620,21 +620,21 @@ public:
    * @return The substituted message string.
    * @throw Glib::ConvertError
    *
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1>
   static inline
   ustring compose(const ustring& fmt, const T1& a1);
 
   /* See the documentation for compose(const ustring& fmt, const T1& a1).
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1, class T2>
   static inline
   ustring compose(const ustring& fmt, const T1& a1, const T2& a2);
 
   /* See the documentation for compose(const ustring& fmt, const T1& a1).
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1, class T2, class T3>
   static inline
@@ -642,7 +642,7 @@ public:
                   const T1& a1, const T2& a2, const T3& a3);
 
   /* See the documentation for compose(const ustring& fmt, const T1& a1).
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1, class T2, class T3, class T4>
   static inline
@@ -651,7 +651,7 @@ public:
                   const T4& a4);
 
   /* See the documentation for compose(const ustring& fmt, const T1& a1).
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1, class T2, class T3, class T4, class T5>
   static inline
@@ -660,7 +660,7 @@ public:
                   const T4& a4, const T5& a5);
 
   /* See the documentation for compose(const ustring& fmt, const T1& a1).
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1, class T2, class T3, class T4, class T5, class T6>
   static inline
@@ -669,7 +669,7 @@ public:
                   const T4& a4, const T5& a5, const T6& a6);
 
   /* See the documentation for compose(const ustring& fmt, const T1& a1).
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1, class T2, class T3, class T4, class T5, class T6, class T7>
   static inline
@@ -679,7 +679,7 @@ public:
                   const T7& a7);
 
   /* See the documentation for compose(const ustring& fmt, const T1& a1).
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1, class T2, class T3, class T4,
             class T5, class T6, class T7, class T8>
@@ -690,7 +690,7 @@ public:
                   const T7& a7, const T8& a8);
 
   /* See the documentation for compose(const ustring& fmt, const T1& a1).
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1, class T2, class T3, class T4, class T5,
             class T6, class T7, class T8, class T9>
@@ -728,7 +728,7 @@ public:
    * @return The string representation of the argument stream.
    * @throw Glib::ConvertError
    *
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1>
   static inline
@@ -736,7 +736,7 @@ public:
 
   /* See the documentation for format(const T1& a1).
    *
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1, class T2>
   static inline
@@ -744,7 +744,7 @@ public:
 
   /* See the documentation for format(const T1& a1).
    *
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1, class T2, class T3>
   static inline
@@ -752,7 +752,7 @@ public:
 
   /* See the documentation for format(const T1& a1).
    *
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1, class T2, class T3, class T4>
   static inline
@@ -760,7 +760,7 @@ public:
 
   /* See the documentation for format(const T1& a1).
    *
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1, class T2, class T3, class T4, class T5>
   static inline
@@ -769,7 +769,7 @@ public:
 
   /* See the documentation for format(const T1& a1).
    *
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1, class T2, class T3, class T4, class T5, class T6>
   static inline
@@ -778,7 +778,7 @@ public:
 
   /* See the documentation for format(const T1& a1).
    *
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1, class T2, class T3, class T4,
             class T5, class T6, class T7>
@@ -788,7 +788,7 @@ public:
 
   /* See the documentation for format(const T1& a1).
    *
-   * @newin2p16
+   * @since{2,16}
    */
   template <class T1, class T2, class T3, class T4,
             class T5, class T6, class T7, class T8>