From: Philip Withnall <philip@tecnocode.co.uk>
Date: Tue, 14 Aug 2012 21:58:13 +0000 (+0200)
Subject: doclet/gtkdoc: Implement @throws taglet in the gtk-doc comment converter
X-Git-Tag: 0.37.1~3^2~159
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8c3c869986caeaa8342cbe814eba4becd8f089d2;p=thirdparty%2Fvala.git

doclet/gtkdoc: Implement @throws taglet in the gtk-doc comment converter

This now appends a paragraph to the gtk-doc comment explaining that
particular throw value and description.
---

diff --git a/src/doclets/gtkdoc/commentconverter.vala b/src/doclets/gtkdoc/commentconverter.vala
index b585a0d8c..3b90d482b 100644
--- a/src/doclets/gtkdoc/commentconverter.vala
+++ b/src/doclets/gtkdoc/commentconverter.vala
@@ -277,6 +277,10 @@ public class Gtkdoc.CommentConverter : ContentVisitor {
 			this.see_also = see_also;
 		} else if (t is Taglets.Link) {
 			((Taglets.Link)t).produce_content().accept (this);
+		} else if (t is Taglets.Throws) {
+			var taglet = (Taglets.Throws) t;
+			var link = get_docbook_link (taglet.error_domain) ?? taglet.error_domain_name;
+			old_builder.append_printf ("\n<para>%s will be returned in @error %s</para>", link, current_builder.str);
 		} else {
 			reporter.simple_warning ("GtkDoc: warning: Taglet not supported"); // TODO
 		}