<commit_before>{% macro class_item(class, short = false, indent = "") -%}
{{ indent }}- {{ _self.class_name(class, short) }}{% if class.shortdesc %} &mdash; {{ class.shortdesc }}{% endif %}
{%- endmacro -%}

{% macro class_name(class, short = false, suffix = "") -%}
{% spaceless -%}
{% if class.projectclass or class.phpclass %}
[`{{ short ? class.shortname : class }}{{ suffix }}`]({% if class.projectclass %}{{ _self.markdown_path(class_path(class)) }}{% else %}http://php.net/class.{{ class }}{% endif %})
{% else %}
`{{ class }}`
{% endif %}
{%- endspaceless %}
{%- endmacro -%}

{% macro class_type(class, sentence = false) -%}
{% spaceless %}
{% if class.interface %}
{% if sentence %}an {% endif %}
interface
{%- else -%}
{% if sentence %}{% if class.abstract %}an{% else %}a{% endif %} {% endif %}
{% if class.abstract %}abstract {% endif %}
class
{%- endif -%}
{% endspaceless %}
{%- endmacro -%}

{% macro hint(hint) -%}
{% spaceless %}
{% if hint.class -%}
{{ _self.class_name(hint.name, true, hint.array ? "[]" : "") }}
{%- elseif hint.name -%}
`{{ hint.name }}{% if hint.array %}[]{% endif %}`
{%- endif %}
{% endspaceless %}
{%- endmacro -%}

{% macro markdown_path(path) -%}
{% spaceless %}
{{- path|replace({".html": ".md"}) -}}
{% endspaceless %}
{%- endmacro -%}

{% macro member_signature(type, member) -%}
- It is a **{{ _self.member_visibility(member) }}{% if member.abstract is defined and member.abstract %} abstract{% endif %}** {{ type }}.
{% if member.final %}
- It is a **finalized** {{ type }}.
{% endif %}
{% if "property" == type %}
{% if member.hint|length > 1 %}
- It can be one of the following types:
{%- for hint in member.hint %}

    - {{ _self.hint(hint) }}
{%- endfor -%}
{%- elseif member.hint|length > 0 %}
- It is a(n) {{ _self.hint(member.hint[0]) }} value.
{%- else %}
- Its type is not specified.
{% endif %}
{% elseif "method" == type %}
{% if member.parameters %}
- It accepts the following parameter(s):
{% for parameter in member.parameters %}
    - `${{ parameter.name }}`{% if parameter.hint %} ({% for hint in parameter.hint %}{{ _self.hint(hint) }}{% if not loop.last %}|{% endif %}{% endfor %}){% endif %}{% if parameter.shortdesc %} &mdash; {{ parameter.shortdesc }}{% endif %}

{% endfor %}
{% endif %}
{% if member.hint|length > 1 %}
- It can return one of the following values:
{% for hint in member.hint %}
    - {{ _self.hint(hint) }}
{% endfor -%}
{% elseif member.hint|length > 0 %}
- It returns a(n) {{ _self.hint(member.hint[0]) }} value.
{% else %}
- It does not return anything.
{% endif %}
{% if member.exceptions %}
- It throws one of the following exceptions:
{% for exception in member.exceptions %}
    - {{ _self.class_name(exception[0]) }}{% if exception[1] is defined and exception[1] is not empty %} &mdash; {{ exception[1] }}{% endif %}

{% endfor %}
{% endif %}
{% endif %}
{%- endmacro -%}

{% macro member_visibility(member) -%}
{% spaceless %}
{% if member.private %}private{% elseif member.protected %}protected{% else %}public{% endif %}
{% if member.static %} static{% endif %}
{% endspaceless %}
{%- endmacro -%}
<commit_msg>Including return hint.<commit_after>{% macro class_item(class, short = false, indent = "") -%}
{{ indent }}- {{ _self.class_name(class, short) }}{% if class.shortdesc %} &mdash; {{ class.shortdesc }}{% endif %}
{%- endmacro -%}

{% macro class_name(class, short = false, suffix = "") -%}
{% spaceless -%}
{% if class.projectclass or class.phpclass %}
[`{{ short ? class.shortname : class }}{{ suffix }}`]({% if class.projectclass %}{{ _self.markdown_path(class_path(class)) }}{% else %}http://php.net/class.{{ class }}{% endif %})
{% else %}
`{{ class }}`
{% endif %}
{%- endspaceless %}
{%- endmacro -%}

{% macro class_type(class, sentence = false) -%}
{% spaceless %}
{% if class.interface %}
{% if sentence %}an {% endif %}
interface
{%- else -%}
{% if sentence %}{% if class.abstract %}an{% else %}a{% endif %} {% endif %}
{% if class.abstract %}abstract {% endif %}
class
{%- endif -%}
{% endspaceless %}
{%- endmacro -%}

{% macro hint(hint) -%}
{% spaceless %}
{% if hint.class -%}
{{ _self.class_name(hint.name, true, hint.array ? "[]" : "") }}
{%- elseif hint.name -%}
`{{ hint.name }}{% if hint.array %}[]{% endif %}`
{%- endif %}
{% endspaceless %}
{%- endmacro -%}

{% macro markdown_path(path) -%}
{% spaceless %}
{{- path|replace({".html": ".md"}) -}}
{% endspaceless %}
{%- endmacro -%}

{% macro member_signature(type, member) -%}
- It is a **{{ _self.member_visibility(member) }}{% if member.abstract is defined and member.abstract %} abstract{% endif %}** {{ type }}.
{% if member.final %}
- It is a **finalized** {{ type }}.
{% endif %}
{% if "property" == type %}
{% if member.hint|length > 1 %}
- It can be one of the following types:
{%- for hint in member.hint %}

    - {{ _self.hint(hint) }}
{%- endfor -%}
{%- elseif member.hint|length > 0 %}
- It is a(n) {{ _self.hint(member.hint[0]) }} value.
{%- else %}
- Its type is not specified.
{% endif %}
{% elseif "method" == type %}
{% if member.parameters %}
- It accepts the following parameter(s):
{% for parameter in member.parameters %}
    - `${{ parameter.name }}`{% if parameter.hint %} ({% for hint in parameter.hint %}{{ _self.hint(hint) }}{% if not loop.last %}|{% endif %}{% endfor %}){% endif %}{% if parameter.shortdesc %} &mdash; {{ parameter.shortdesc }}{% endif %}

{% endfor %}
{% endif %}
{% if (member.hint|length > 1) or member.hintDesc %}
{% if member.hintDesc %}
- _Returns:_ {{ member.hintDesc }}
{% else %}
- It can return one of the following values:
{% endif %}
{% for hint in member.hint %}
    - {{ _self.hint(hint) }}
{% endfor -%}
{% elseif member.hint|length > 0 %}
- It returns a(n) {{ _self.hint(member.hint[0]) }} value.
{% else %}
- It does not return anything.
{% endif %}
{% if member.exceptions %}
- It throws one of the following exceptions:
{% for exception in member.exceptions %}
    - {{ _self.class_name(exception[0]) }}{% if exception[1] is defined and exception[1] is not empty %} &mdash; {{ exception[1] }}{% endif %}

{% endfor %}
{% endif %}
{% endif %}
{%- endmacro -%}

{% macro member_visibility(member) -%}
{% spaceless %}
{% if member.private %}private{% elseif member.protected %}protected{% else %}public{% endif %}
{% if member.static %} static{% endif %}
{% endspaceless %}
{%- endmacro -%}

{'fraction_non_alphanumeric': 0.23243328596241908, 'fraction_numerical': 0.0031580609505763462, 'mean_word_length': 3.891119691119691, 'pattern_counts': {'":': 2, '<': 3, '<?xml version=': 0, '>': 11, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1139240', 'n_tokens_mistral': 2486, 'n_tokens_neox': 2127, 'n_words': 548}