From 21d6d4df0728a842c17dcbc00b18b647b817b670 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jos=C3=A9=20Alburquerque?= <jaalburqu@svn.gnome.org>
Date: Wed, 19 Sep 2012 14:57:31 -0400
Subject: _WRAP_VFUNC: Prepend @throws clause to vfuncs that throw errors.

	* tools/pm/Output.pm (output_wrap_vfunc_h): Prepend a Doxygen @throws
	clause to the declaration of virtual functions that throw Glib::Error.
---
 ChangeLog          | 7 +++++++
 tools/pm/Output.pm | 7 +++++++
 2 files changed, 14 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index b7ba3fe8..712fb611 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2012-09-19  José Alburquerque  <jaalburquerque@gmail.com>
+
+	_WRAP_VFUNC: Prepend @throws clause to vfuncs that throw errors.
+
+	* tools/pm/Output.pm (output_wrap_vfunc_h): Prepend a Doxygen @throws
+	clause to the declaration of virtual functions that throw Glib::Error.
+
 2012-09-18  José Alburquerque  <jaalburqu@svn.gnome.org>
 
 	Gio::DBus::Connection: Add the call_[finish|sync]() with UnixFDLists.
diff --git a/tools/pm/Output.pm b/tools/pm/Output.pm
index a820d240..916b18cb 100644
--- a/tools/pm/Output.pm
+++ b/tools/pm/Output.pm
@@ -118,6 +118,13 @@ sub output_wrap_vfunc_h($$$$$$)
 #   );
 #  $self->append($str);
 
+  # Prepend a Doxygen @throws directive to the declaration if the virtual
+  # function throws an error.
+  if($$objCDefsFunc{throw_any_errors})
+  {
+    $self->append('/// @throws Glib::Error.' . "\n");
+  }
+
   my $cppVfuncDecl = "virtual " . $$objCppfunc{rettype} . " " . $$objCppfunc{name} . "(" . $objCppfunc->args_types_and_names() . ")";
   if($objCppfunc->get_is_const())
   {
-- 
cgit v1.2.1