Skip to content

Commit 24862e2

Browse files
committed
rewording / restyling
1 parent 54b2dbd commit 24862e2

File tree

1 file changed

+2
-7
lines changed

1 file changed

+2
-7
lines changed

proposed/phpdoc.md

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -449,10 +449,9 @@ The following keywords are recognized by this PSR:
449449

450450
11. `null`: the element to which this type applies is a `NULL` value or, in technical terms, does not exist.
451451

452-
A big difference compared to `void` is that this type is used in any situation where the described element may at
452+
Compared to `void`, this type is used in any situation where the described element may at
453453
any given time contain an explicit `NULL` value.
454454

455-
**Example 1:**
456455
```php
457456
/**
458457
* @return null
@@ -464,10 +463,6 @@ The following keywords are recognized by this PSR:
464463
}
465464
```
466465

467-
This type is commonly used in conjunction with another type to indicate that it is possible that nothing is
468-
returned.
469-
470-
**Example 2:**
471466
```php
472467
/**
473468
* @param bool $create_new When true returns a new stdClass.
@@ -486,7 +481,7 @@ The following keywords are recognized by this PSR:
486481
12. `callable`: the element to which this type applies is a pointer to a function call. This may be any type of callable
487482
as per the [definition of PHP][PHP_CALLABLE].
488483

489-
13. `false` or `true`: the element to which this type applies will have the value `TRUE` or `FALSE`. No other value will
484+
13. `false` or `true`: the element to which this type applies will have the exact value `TRUE` or `FALSE`. No other value will
490485
be returned from this element.
491486

492487
14. `self`: the element to which this type applies is of the same class in which the documented element is originally

0 commit comments

Comments
 (0)