From: Xavi Artigas <xavierartigas@yahoo.es>
Date: Thu, 25 Jul 2019 15:30:44 +0000 (+0200)
Subject: mono-docs: Clearer docs for ConstructingHandle
X-Git-Tag: submit/tizen/20190805.083058~157
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=8e3d956796ee49e36dadf8d5f2c1e80e128b2b93;p=platform%2Fupstream%2Fefl.git

mono-docs: Clearer docs for ConstructingHandle

Only *slightly* clearer.
---

diff --git a/src/bin/eolian_mono/eolian/mono/klass.hh b/src/bin/eolian_mono/eolian/mono/klass.hh
index a98866e..46215b9 100644
--- a/src/bin/eolian_mono/eolian/mono/klass.hh
+++ b/src/bin/eolian_mono/eolian/mono/klass.hh
@@ -204,7 +204,8 @@ struct klass
 
          if (!as_generator
             (
-             scope_tab << "/// <summary>Constructor to be used when objects are expected to be constructed from native code.</summary>\n"
+             scope_tab << "/// <summary>Subclasses should override this constructor if they are expected to be instantiated from native code.\n"
+             << scope_tab << "/// Do not call this constructor directly.</summary>\n"
              << scope_tab << "/// <param name=\"ch\">Tag struct storing the native handle of the object being constructed.</param>\n"
              << scope_tab << "private " << concrete_name << "(ConstructingHandle ch) : base(ch)\n"
              << scope_tab << "{\n"
@@ -511,7 +512,8 @@ struct klass
                      << (*(scope_tab << scope_tab << constructor_invocation << "\n"))
                      << scope_tab << scope_tab << "FinishInstantiation();\n"
                      << scope_tab << "}\n\n"
-                     << scope_tab << "/// <summary>Constructor to be used when objects are expected to be constructed from native code.</summary>\n"
+                     << scope_tab << "/// <summary>Subclasses should override this constructor if they are expected to be instantiated from native code.\n"
+                     << scope_tab << "/// Do not call this constructor directly.</summary>\n"
                      << scope_tab << "/// <param name=\"ch\">Tag struct storing the native handle of the object being constructed.</param>\n"
                      << scope_tab << "protected " << inherit_name << "(ConstructingHandle ch) : base(ch)\n"
                      << scope_tab << "{\n"