phpdoc_annotation_without_dot.rst 1007 B

1234567891011121314151617181920212223242526272829303132333435363738
  1. ======================================
  2. Rule ``phpdoc_annotation_without_dot``
  3. ======================================
  4. PHPDoc annotation descriptions should not be a sentence.
  5. Examples
  6. --------
  7. Example #1
  8. ~~~~~~~~~~
  9. .. code-block:: diff
  10. --- Original
  11. +++ New
  12. <?php
  13. /**
  14. - * @param string $bar Some string.
  15. + * @param string $bar some string
  16. */
  17. function foo ($bar) {}
  18. Rule sets
  19. ---------
  20. The rule is part of the following rule sets:
  21. - `@PhpCsFixer <./../../ruleSets/PhpCsFixer.rst>`_
  22. - `@Symfony <./../../ruleSets/Symfony.rst>`_
  23. References
  24. ----------
  25. - Fixer class: `PhpCsFixer\\Fixer\\Phpdoc\\PhpdocAnnotationWithoutDotFixer <./../../../src/Fixer/Phpdoc/PhpdocAnnotationWithoutDotFixer.php>`_
  26. - Test class: `PhpCsFixer\\Tests\\Fixer\\Phpdoc\\PhpdocAnnotationWithoutDotFixerTest <./../../../tests/Fixer/Phpdoc/PhpdocAnnotationWithoutDotFixerTest.php>`_
  27. The test class defines officially supported behaviour. Each test case is a part of our backward compatibility promise.