mirror of
https://github.com/php/php-src.git
synced 2025-08-18 06:58:55 +02:00
d679f02295
This patch adds missing newlines, trims multiple redundant final newlines into a single one, and trims redundant leading newlines in all *.phpt sections. According to POSIX, a line is a sequence of zero or more non-' <newline>' characters plus a terminating '<newline>' character. [1] Files should normally have at least one final newline character. C89 [2] and later standards [3] mention a final newline: "A source file that is not empty shall end in a new-line character, which shall not be immediately preceded by a backslash character." Although it is not mandatory for all files to have a final newline fixed, a more consistent and homogeneous approach brings less of commit differences issues and a better development experience in certain text editors and IDEs. [1] http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html#tag_03_206 [2] https://port70.net/~nsz/c/c89/c89-draft.html#2.1.1.2 [3] https://port70.net/~nsz/c/c99/n1256.html#5.1.1.2
113 lines
1.7 KiB
PHP
113 lines
1.7 KiB
PHP
--TEST--
|
|
ReflectionMethod::getDocComment()
|
|
--INI--
|
|
opcache.save_comments=1
|
|
--FILE--
|
|
<?php
|
|
/**
|
|
* My Doc Comment for A
|
|
*/
|
|
class A {
|
|
/**
|
|
* My Doc Comment for A::f
|
|
*/
|
|
function f() {}
|
|
|
|
/**
|
|
* My Doc Comment for A::privf
|
|
*/
|
|
private function privf() {}
|
|
|
|
/** My Doc Comment for A::protStatf */
|
|
protected static function protStatf() {}
|
|
|
|
/**
|
|
|
|
* My Doc Comment for A::finalStatPubf
|
|
*/
|
|
final static public function finalStatPubf() {}
|
|
|
|
}
|
|
|
|
|
|
class B extends A {
|
|
/*** Not a doc comment */
|
|
function f() {}
|
|
|
|
/** *
|
|
* My Doc Comment for B::privf
|
|
*/
|
|
|
|
|
|
|
|
|
|
private function privf() {}
|
|
|
|
|
|
/** My Doc Comment for B::protStatf
|
|
|
|
|
|
|
|
|
|
*/
|
|
protected static function protStatf() {}
|
|
|
|
}
|
|
|
|
foreach (array('A', 'B') as $class) {
|
|
$rc = new ReflectionClass($class);
|
|
$rms = $rc->getMethods();
|
|
foreach ($rms as $rm) {
|
|
echo "\n\n---> Doc comment for $class::" . $rm->getName() . "():\n";
|
|
var_dump($rm->getDocComment());
|
|
}
|
|
}
|
|
?>
|
|
--EXPECTF--
|
|
---> Doc comment for A::f():
|
|
string(%d) "/**
|
|
* My Doc Comment for A::f
|
|
*/"
|
|
|
|
|
|
---> Doc comment for A::privf():
|
|
string(%d) "/**
|
|
* My Doc Comment for A::privf
|
|
*/"
|
|
|
|
|
|
---> Doc comment for A::protStatf():
|
|
string(%d) "/** My Doc Comment for A::protStatf */"
|
|
|
|
|
|
---> Doc comment for A::finalStatPubf():
|
|
string(%d) "/**
|
|
|
|
* My Doc Comment for A::finalStatPubf
|
|
*/"
|
|
|
|
|
|
---> Doc comment for B::f():
|
|
bool(false)
|
|
|
|
|
|
---> Doc comment for B::privf():
|
|
string(%d) "/** *
|
|
* My Doc Comment for B::privf
|
|
*/"
|
|
|
|
|
|
---> Doc comment for B::protStatf():
|
|
string(%d) "/** My Doc Comment for B::protStatf
|
|
|
|
|
|
|
|
|
|
*/"
|
|
|
|
|
|
---> Doc comment for B::finalStatPubf():
|
|
string(%d) "/**
|
|
|
|
* My Doc Comment for A::finalStatPubf
|
|
*/"
|