Changes between Version 1 and Version 2 of Ticket #53875
- Timestamp:
- 08/04/2021 09:16:59 PM (5 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Ticket #53875 – Description
v1 v2 12 12 }}} 13 13 14 Further emphasis is puton not using `/**` specifically:14 The docs put emphasis on not using `/**` specifically: 15 15 16 16 > Important note: Multi-line comments must not begin with `/**` (double asterisk) as the parser might mistake it for a DocBlock. Use `/*` (single asterisk) instead. 17 18 It's worth emphasizing here that it does not say ''single-line'' comments shouldn't use `/**` but the handbook docs do not explain (that I have found) when and why single-line comments should use `/**`. This same syntax is also used when hooks are used in multiple locations, for example. 17 19 18 20 According to our own standard, I believe these lines should instead be: