Fixed empty doc for API references

Author: ezimuel

util/docstheme/macros.twig

@@ -136,3 +136,35 @@ class
 {% if member.static %} static{% endif %}
 {% endspaceless %}
 {%- endmacro -%}
+
+{% macro method_parameters_signature(method) -%}
+    {%- from "macros.twig" import hint_link -%}
+    (
+        {%- for parameter in method.parameters %}
+            {%- if parameter.hashint %}{{ hint_link(parameter.hint) }} {% endif -%}
+            {%- if parameter.variadic %}...{% endif %}${{ parameter.name|raw }}
+            {%- if parameter.default is not null %} = {{ parameter.default }}{% endif %}
+            {%- if not loop.last %}, {% endif %}
+        {%- endfor -%}
+    )
+{%- endmacro %}
+
+{% macro hint_link(hints) -%}
+    {%- from _self import class_link %}
+
+    {%- if hints %}
+        {%- for hint in hints %}
+            {%- if hint.class %}
+                {{- class_link(hint.name) }}
+            {%- elseif hint.name %}
+                {{- abbr_class(hint.name) }}
+            {%- endif %}
+            {%- if hint.array %}[]{% endif %}
+            {%- if not loop.last %}|{% endif %}
+        {%- endfor %}
+    {%- endif %}
+{%- endmacro %}
+
+{% macro class_link(class, absolute) -%}
+    {{- class }}
+{%- endmacro %}

util/docstheme/pages/class.twig

@@ -36,50 +36,33 @@ The {{ class_type(class) }} defines the following methods:
 {% if method.name != "__construct" %}
 
 
-{% if class.shortname != "ClientBuilder" %}
 [[{{ sanitize(replace_backslash(method)~"_"~method.name) }}]]
 .`{{ method.name }}()`
 {% if method.tags('note') %}
 {% for note in method.tags('note') %}
 *NOTE:* {{ note|join(' ') }}
 {% endfor %}
 {% endif %}
-****
-[source,php]
-----
-/*
-{% if method.shortdesc %}
-{{ method.shortdesc|raw }}
-{% endif %}
-*/
-
-$params = [
-    // ...
-];
-
-$client = ClientBuilder::create()->build();
-$response = {{ get_namespace(class) }}->{{ method.name }}({{ param_list(method)|trim(',') }});
-----
-****
-{% else %}
 [[{{ sanitize(replace_backslash(method)~"_"~method.name) }}]]
-.`{{ method.name }}()`
+.`{{ method.name }}{{ block('method_parameters_signature') }}`
 ****
 [source,php]
 ----
 /*
 {% if method.shortdesc %}
-    {{ method.shortdesc|raw }}
+{{ method.shortdesc|raw }}
 {% endif %}
 */
-
 ----
 ****
 {% endif %}
-{% endif %}
 
 {% endfor %}
 {% endif %}
 
 {% endblock %}
 
+{% block method_parameters_signature -%}
+    {%- from "macros.twig" import method_parameters_signature -%}
+    {{ method_parameters_signature(method) }}
+{%- endblock %}

util/template/client-class

@@ -89,6 +89,8 @@ class Client
     }
 
     /**
+     * Extract an argument from the array of parameters
+     *
      * @return null|mixed
      */
     public function extractArgument(array &$params, string $arg)

util/template/client-namespace-function

@@ -1,3 +1,6 @@
+    /**
+     * Returns the :name namespace
+     */
     public function :name(): :namespace
     {
         return $this->:name;