diff --git a/td/generate/DotnetTlDocumentationGenerator.php b/td/generate/DotnetTlDocumentationGenerator.php index db53cc1ea..9772fb450 100644 --- a/td/generate/DotnetTlDocumentationGenerator.php +++ b/td/generate/DotnetTlDocumentationGenerator.php @@ -158,13 +158,16 @@ EOT ); } - protected function addClassDocumentation($class_name, $base_class_name, $description, $return_type) + protected function getFunctionReturnTypeDescription($return_type) { - $return_type_description = $return_type ? "\r\n/// Returns .' : ''; + return "\r\n/// Returns .'; + } + protected function addClassDocumentation($class_name, $base_class_name, $description) + { $this->addDocumentation("public ref class $class_name sealed : $base_class_name {", << -/// $description$return_type_description +/// $description /// EOT ); diff --git a/td/generate/DoxygenTlDocumentationGenerator.php b/td/generate/DoxygenTlDocumentationGenerator.php index 775ee871a..d8f25c302 100644 --- a/td/generate/DoxygenTlDocumentationGenerator.php +++ b/td/generate/DoxygenTlDocumentationGenerator.php @@ -321,13 +321,16 @@ EOT ); } - protected function addClassDocumentation($class_name, $base_class_name, $description, $return_type) + protected function getFunctionReturnTypeDescription($return_type) { - $return_type_description = $return_type ? PHP_EOL.' *'.PHP_EOL." * Returns $return_type." : ''; + return PHP_EOL.' *'.PHP_EOL." * Returns $return_type."; + } + protected function addClassDocumentation($class_name, $base_class_name, $description) + { $this->addDocumentation("class $class_name final : public $base_class_name {", << Returns {@link $return_type $return_type}

" : ''; + return PHP_EOL.' *'.PHP_EOL." *

Returns {@link $return_type $return_type}

"; + } + protected function addClassDocumentation($class_name, $base_class_name, $description) + { $this->addDocumentation(" public static class $class_name extends $base_class_name {", <<getBaseClassName($is_function); - $this->addClassDocumentation($class_name, $base_class_name, $info['description'], $is_function ? $this->getTypeName($type) : ''); + $class_description = $info['description']; + if ($is_function) { + $class_description .= $this->getFunctionReturnTypeDescription($this->getTypeName($type)); + } + $this->addClassDocumentation($class_name, $base_class_name, $class_description); foreach ($known_fields as $name => $type) { $may_be_null = stripos($info[$name], 'may be null') !== false;