eolian gen: generate documentation for first object param if present 87/155787/2
authorSangHyeon Jade Lee <dltkdgus1764@gmail.com>
Mon, 16 Oct 2017 07:03:33 +0000 (16:03 +0900)
committerGerrit Code Review <gerrit@review.ap-northeast-2.compute.internal>
Mon, 16 Oct 2017 07:22:53 +0000 (07:22 +0000)
eolian gen: generate documentation for first object param if present
This prevents doxygen from emitting warnings.

This commit is ported form upstream patch
rEFL5699466dbabc8a1b2bd6b46a49cb268c5db415e1

Change-Id: Ieb90d2367335b1eb4f62f904f15ec6d6cf3268a7
Author:     Daniel Kolesa <d.kolesa@osg.samsung.com>
Signed-off-by: SangHyeon Jade Lee <dltkdgus1764@gmail.com>
src/bin/eolian/docs_generator.c

index 4f90602..7a8202a 100644 (file)
@@ -514,6 +514,18 @@ docs_generate_function(const Eolian_Function *fid, Eolian_Function_Type ftype,
           }
      }
 
+   if (!eolian_function_is_class(fid))
+     {
+        _indent_line(buf, indent);
+        eina_strbuf_append(buf, " * @param[in] obj The object.\n");
+        if (!par && (rdoc || since))
+          {
+             _indent_line(buf, indent);
+             eina_strbuf_append(buf, " *\n");
+          }
+     }
+
+
    while (par)
      {
         const Eolian_Documentation *adoc = eolian_parameter_documentation_get(par);