From e60ba39364e13546ec124a732e19b3a45682d605 Mon Sep 17 00:00:00 2001
From: Felipe Magno de Almeida <felipe@expertisesolutions.com.br>
Date: Sun, 13 Oct 2019 23:45:17 -0300
Subject: [PATCH] csharp: Add since documentation to Async methods

Reviewers: lauromoura

Reviewed By: lauromoura

After review, fixed formatting and indentation.

Subscribers: cedric, #reviewers, #committers

Tags: #efl

Maniphest Tasks: T8359

Differential Revision: https://phab.enlightenment.org/D10384
---
 .../eolian/mono/async_function_definition.hh  | 26 +++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

diff --git a/src/bin/eolian_mono/eolian/mono/async_function_definition.hh b/src/bin/eolian_mono/eolian/mono/async_function_definition.hh
index a6907a2a95..8ca3c5c6b2 100644
--- a/src/bin/eolian_mono/eolian/mono/async_function_definition.hh
+++ b/src/bin/eolian_mono/eolian/mono/async_function_definition.hh
@@ -57,7 +57,18 @@ struct async_function_declaration_generator
       return true;
 
     if (!as_generator(
-            scope_tab << "/// <summary>Async wrapper for <see cref=\"" << name_helpers::managed_method_name(f) << "\" />.</summary>\n"
+            scope_tab << "/// <summary>Async wrapper for <see cref=\"" << name_helpers::managed_method_name(f) << "\" />.\n"
+        ).generate(sink, attributes::unused, context))
+      return false;
+
+    if (!f.documentation.since.empty())
+      if (!as_generator
+          (scope_tab << "/// <para>Since EFL " + f.documentation.since + ".</para>\n")
+          .generate (sink, attributes::unused, context))
+      return false;
+
+    if (!as_generator(
+            scope_tab << "/// </summary>\n"
         ).generate(sink, attributes::unused, context))
       return false;
 
@@ -104,7 +115,18 @@ struct async_function_definition_generator
     std::transform(f.parameters.begin(), f.parameters.end(), std::back_inserter(param_forwarding), parameter_forwarding);
 
     if (!as_generator(
-            scope_tab << "/// <summary>Async wrapper for <see cref=\"" << name_helpers::managed_method_name(f) << "\" />.</summary>\n"
+            scope_tab << "/// <summary>Async wrapper for <see cref=\"" << name_helpers::managed_method_name(f) << "\" />.\n"
+        ).generate(sink, attributes::unused, context))
+      return false;
+
+    if (!f.documentation.since.empty())
+      if (!as_generator
+          (scope_tab << "/// <para>Since EFL " + f.documentation.since + ".</para>\n")
+          .generate (sink, attributes::unused, context))
+      return false;
+
+    if (!as_generator(
+            scope_tab << "/// </summary>\n"
         ).generate(sink, attributes::unused, context))
       return false;