note 125523 deleted from language.basic-syntax.comments by cmb
| From: | cmb@php.net | Date: | Thu, 19 Nov 2020 10:22:53 +0000 |
| Subject: | note 125523 deleted from language.basic-syntax.comments by cmb | ||
| References: | 1 | Groups: | php.notes |
| Request: | Send a blank email to php-notes+get-215867@lists.php.net to get a copy of this message | ||
Note Submitter: Anonymous
----
Please note that block comments are not the same as PHPDoc. Therefore, it is important to double
check your code because PHP documentation generators cannot detect block comments as PHPDoc.
Example:
<?php
class Foo {
/**
* This is a PHPDoc, it will be detected by PHP documentation generators
*
* @var bool $bar
*/
public $bar = true;
/*
* This is a block comment, it will not be detected by PHP documentation generators
*
* @var array $baz
*/
public $baz = [];
}
?>