Fix comment typo

Author: SerafimArts

Writerside/tl.tree

@@ -141,18 +141,18 @@
         <toc-element toc-title="Psalm" topic="psalm-tags.md">
             <toc-element topic="psalm-allow-private-mutation-tag.md" />
             <toc-element topic="psalm-api-tag.md" />
-            <toc-element topic="psalm-assert-tag.md" wip="true" />
-            <toc-element topic="psalm-assert-if-false-tag.md" wip="true" />
-            <toc-element topic="psalm-assert-if-true-tag.md" wip="true" />
-            <toc-element topic="psalm-assert-untainted-tag.md" wip="true" />
+            <toc-element topic="psalm-assert-tag.md" />
+            <toc-element topic="psalm-assert-if-false-tag.md" />
+            <toc-element topic="psalm-assert-if-true-tag.md" />
+            <toc-element topic="psalm-assert-untainted-tag.md" />
             <toc-element topic="psalm-check-type-tag.md" wip="true" />
             <toc-element topic="psalm-check-type-exact-tag.md" wip="true" />
             <toc-element topic="psalm-consistent-constructor-tag.md" />
             <toc-element topic="psalm-consistent-templates-tag.md" />
             <toc-element topic="psalm-external-mutation-free-tag.md" />
             <toc-element topic="psalm-extends-tag.md" />
             <toc-element topic="psalm-flow-tag.md" wip="true" />
-            <toc-element topic="psalm-if-this-is-tag.md" wip="true" />
+            <toc-element topic="psalm-if-this-is-tag.md" />
             <toc-element topic="psalm-ignore-falsable-return-tag.md" />
             <toc-element topic="psalm-ignore-nullable-return-tag.md" />
             <toc-element topic="psalm-ignore-var-tag.md" />
@@ -161,7 +161,7 @@
             <toc-element topic="psalm-immutable-tag.md" />
             <toc-element topic="psalm-implements-tag.md" />
             <toc-element topic="psalm-import-type-tag.md" wip="true" />
-            <toc-element topic="psalm-inheritors-tag.md" wip="true" />
+            <toc-element topic="psalm-inheritors-tag.md" />
             <toc-element topic="psalm-internal-tag.md" />
             <toc-element topic="psalm-method-tag.md" />
             <toc-element topic="psalm-mutation-free-tag.md" />
@@ -180,10 +180,10 @@
             <toc-element topic="psalm-require-extends-tag.md" />
             <toc-element topic="psalm-require-implements-tag.md" />
             <toc-element topic="psalm-return-tag.md" />
-            <toc-element topic="psalm-scope-this-tag.md" wip="true" />
+            <toc-element topic="psalm-scope-this-tag.md" />
             <toc-element topic="psalm-seal-methods-tag.md" />
             <toc-element topic="psalm-seal-properties-tag.md" />
-            <toc-element topic="psalm-self-out-tag.md" wip="true" />
+            <toc-element topic="psalm-self-out-tag.md" />
             <toc-element topic="psalm-stub-override-tag.md" />
             <toc-element topic="psalm-suppress-tag.md" />
             <toc-element topic="psalm-taint-escape-tag.md" wip="true" />
@@ -194,19 +194,19 @@
             <toc-element topic="psalm-template-tag.md" />
             <toc-element topic="psalm-template-contravariant-tag.md" />
             <toc-element topic="psalm-template-covariant-tag.md" />
-            <toc-element topic="psalm-this-out-tag.md" wip="true" />
-            <toc-element topic="psalm-trace-tag.md" wip="true" />
+            <toc-element topic="psalm-this-out-tag.md" />
+            <toc-element topic="psalm-trace-tag.md" />
             <toc-element topic="psalm-type-tag.md" wip="true" />
             <toc-element topic="psalm-use-tag.md" />
             <toc-element topic="psalm-var-tag.md" />
             <toc-element topic="psalm-variadic-tag.md" />
-            <toc-element topic="psalm-yield-tag.md" wip="true" />
+            <toc-element topic="psalm-yield-tag.md" />
         </toc-element>
         <toc-element toc-title="PHPStan" topic="phpstan-tags.md">
             <toc-element topic="phpstan-allow-private-mutation-tag.md" />
-            <toc-element topic="phpstan-assert-tag.md" wip="true" />
-            <toc-element topic="phpstan-assert-if-false-tag.md" wip="true" />
-            <toc-element topic="phpstan-assert-if-true-tag.md" wip="true" />
+            <toc-element topic="phpstan-assert-tag.md" />
+            <toc-element topic="phpstan-assert-if-false-tag.md" />
+            <toc-element topic="phpstan-assert-if-true-tag.md" />
             <toc-element topic="phpstan-consistent-constructor-tag.md" />
             <toc-element topic="phpstan-extends-tag.md" />
             <toc-element topic="phpstan-ignore-tag.md" wip="true" />
@@ -232,31 +232,31 @@
             <toc-element topic="phpstan-require-extends-tag.md" />
             <toc-element topic="phpstan-require-implements-tag.md" />
             <toc-element topic="phpstan-return-tag.md" />
-            <toc-element topic="phpstan-self-out-tag.md" wip="true" />
+            <toc-element topic="phpstan-self-out-tag.md" />
             <toc-element topic="phpstan-template-tag.md" />
             <toc-element topic="phpstan-template-contravariant-tag.md" />
             <toc-element topic="phpstan-template-covariant-tag.md" />
-            <toc-element topic="phpstan-this-out-tag.md" wip="true" />
+            <toc-element topic="phpstan-this-out-tag.md" />
             <toc-element topic="phpstan-throws-tag.md" />
             <toc-element topic="phpstan-type-tag.md" wip="true" />
             <toc-element topic="phpstan-use-tag.md" />
             <toc-element topic="phpstan-var-tag.md" />
-            <toc-element topic="phpstan-yield-tag.md" wip="true" />
+            <toc-element topic="phpstan-yield-tag.md" />
         </toc-element>
         <toc-element toc-title="Phan" topic="phan-tags.md">
             <toc-element topic="phan-abstract-tag.md" />
-            <toc-element topic="phan-assert-tag.md" wip="true" />
+            <toc-element topic="phan-assert-tag.md" />
             <toc-element topic="phan-assert-false-condition-tag.md" wip="true" />
-            <toc-element topic="phan-assert-if-false-tag.md" wip="true" />
-            <toc-element topic="phan-assert-if-true-tag.md" wip="true" />
+            <toc-element topic="phan-assert-if-false-tag.md" />
+            <toc-element topic="phan-assert-if-true-tag.md" />
             <toc-element topic="phan-assert-true-condition-tag.md" wip="true" />
-            <toc-element topic="phan-closure-scope-tag.md" wip="true" />
+            <toc-element topic="phan-closure-scope-tag.md" />
             <toc-element topic="phan-constructor-used-for-side-effects-tag.md" />
             <toc-element topic="phan-extends-tag.md" />
             <toc-element topic="phan-file-suppress-tag.md" wip="true" />
             <toc-element topic="phan-forbid-undeclared-magic-methods-tag.md" />
             <toc-element topic="phan-forbid-undeclared-magic-properties-tag.md" />
-            <toc-element topic="phan-hardcode-return-type-tag.md" wip="true" />
+            <toc-element topic="phan-hardcode-return-type-tag.md" />
             <toc-element topic="phan-immutable-tag.md" />
             <toc-element topic="phan-inherits-tag.md" />
             <toc-element topic="phan-method-tag.md" />
@@ -269,7 +269,7 @@
             <toc-element topic="phan-property-write-tag.md" />
             <toc-element topic="phan-pure-tag.md" />
             <toc-element topic="phan-read-only-tag.md" />
-            <toc-element topic="phan-real-return-tag.md" wip="true" />
+            <toc-element topic="phan-real-return-tag.md" />
             <toc-element topic="phan-return-tag.md" />
             <toc-element topic="phan-side-effect-free-tag.md" />
             <toc-element topic="phan-suppress-current-line-tag.md" wip="true" />
@@ -282,12 +282,12 @@
             <toc-element topic="phan-unused-param-tag.md" />
             <toc-element topic="phan-var-tag.md" />
             <toc-element topic="phan-write-only-tag.md" />
-            <toc-element topic="phanclosurescope-tag.md" wip="true" />
+            <toc-element topic="phanclosurescope-tag.md" />
         </toc-element>
         <toc-element toc-title="PhpStorm" topic="phpstorm-tags.md">
             <toc-element topic="noinspection-tag.md" wip="true" />
             <toc-element topic="language-tag.md" wip="true" />
-            <toc-element topic="expected-exception-tag.md" wip="true" />
+            <toc-element topic="expected-exception-tag.md" />
             <toc-element topic="formatter-off-tag.md" />
             <toc-element topic="formatter-on-tag.md" />
         </toc-element>

Writerside/topics/phpdoc/tags/expected-exception-tag.md

@@ -1,7 +1,6 @@
 # @expectedException
 
 <primary-label ref="phpdoc-component"/>
-<secondary-label ref="not-implemented"/>
 
 The `@expectedException` tag declares the `Throwable` a test method is
 expected to throw. It is an old PHPUnit-era convention that predates the
@@ -11,12 +10,12 @@ expected to throw. It is an old PHPUnit-era convention that predates the
 "@expectedException" <Type> [ <Description> ]
 ```
 
-<note>
-Not yet recognized by <code>TypeLang\PhpDoc\DocBlockParser</code> — parsing
-a docblock containing this tag returns a plain <code>Tag</code>, its whole
-suffix folded into the description. See
-<a href="custom-tags.md">Custom Tags</a> for the current workaround if you
-need to recognize it yourself.
-</note>
+Parsing a `@expectedException` tag produces a `ExpectedExceptionTag` instance, carrying the
+parsed `$type` alongside the `$name` and optional `$description` every
+[Tag](phpdoc.md#tag) already provides.
+
+```php
+final class ExpectedExceptionTag extends TypedTag {}
+```
 
 A historical PHPUnit convention, not a PhpStorm tag.

Writerside/topics/phpdoc/tags/phan-assert-if-false-tag.md

@@ -1,21 +1,27 @@
 # @phan-assert-if-false
 
 <primary-label ref="phpdoc-component"/>
-<secondary-label ref="not-implemented"/>
 
 The `@phan-assert-if-false` tag asserts the given type for an
 argument or variable when the function returns `false`. It belongs
 to the same assertion family as [@phan-assert](phan-assert-tag.md)
 and its counterpart
 [@phan-assert-if-true](phan-assert-if-true-tag.md).
 
-<note>
-Not yet recognized by <code>TypeLang\PhpDoc\DocBlockParser</code> — parsing
-a docblock containing this tag returns a plain <code>Tag</code>, its whole
-suffix folded into the description. See
-<a href="custom-tags.md">Custom Tags</a> for the current workaround if you
-need to recognize it yourself.
-</note>
+```
+"@phan-assert-if-false" <Type> <Variable> [ <Description> ]
+```
+
+Parsing a `@phan-assert-if-false` tag produces an `AssertIfFalseTag` instance, carrying the
+asserted `$type` and `$variable` alongside the `$name` and optional
+`$description` every [Tag](phpdoc.md#tag) already provides.
+
+```php
+final class AssertIfFalseTag extends TypedVariableTag {}
+```
+
+The same `AssertIfFalseTag` is produced by [@psalm-assert-if-false](psalm-assert-if-false-tag.md) and [@phpstan-assert-if-false](phpstan-assert-if-false-tag.md), which restate the same
+assertion for their respective tools.
 
 Defined by Phan; see the "Assertions" section of
 [Phan's Annotating Your Source Code wiki](https://github.com/phan/phan/wiki/Annotating-Your-Source-Code).

Writerside/topics/phpdoc/tags/phan-assert-if-true-tag.md

@@ -1,21 +1,27 @@
 # @phan-assert-if-true
 
 <primary-label ref="phpdoc-component"/>
-<secondary-label ref="not-implemented"/>
 
 The `@phan-assert-if-true` tag asserts the given type for an
 argument or variable when the function returns `true`. It belongs
 to the same assertion family as [@phan-assert](phan-assert-tag.md)
 and its counterpart
 [@phan-assert-if-false](phan-assert-if-false-tag.md).
 
-<note>
-Not yet recognized by <code>TypeLang\PhpDoc\DocBlockParser</code> — parsing
-a docblock containing this tag returns a plain <code>Tag</code>, its whole
-suffix folded into the description. See
-<a href="custom-tags.md">Custom Tags</a> for the current workaround if you
-need to recognize it yourself.
-</note>
+```
+"@phan-assert-if-true" <Type> <Variable> [ <Description> ]
+```
+
+Parsing a `@phan-assert-if-true` tag produces an `AssertIfTrueTag` instance, carrying the
+asserted `$type` and `$variable` alongside the `$name` and optional
+`$description` every [Tag](phpdoc.md#tag) already provides.
+
+```php
+final class AssertIfTrueTag extends TypedVariableTag {}
+```
+
+The same `AssertIfTrueTag` is produced by [@psalm-assert-if-true](psalm-assert-if-true-tag.md) and [@phpstan-assert-if-true](phpstan-assert-if-true-tag.md), which restate the same
+assertion for their respective tools.
 
 Defined by Phan; see the "Assertions" section of
 [Phan's Annotating Your Source Code wiki](https://github.com/phan/phan/wiki/Annotating-Your-Source-Code).

Writerside/topics/phpdoc/tags/phan-assert-tag.md

@@ -1,7 +1,6 @@
 # @phan-assert
 
 <primary-label ref="phpdoc-component"/>
-<secondary-label ref="not-implemented"/>
 
 The `@phan-assert` tag asserts that an argument or variable is
 narrowed to a given type after the call returns. Phan documents it
@@ -10,13 +9,20 @@ siblings — see [@phan-assert-if-true](phan-assert-if-true-tag.md) and
 [@phan-assert-if-false](phan-assert-if-false-tag.md) — as part of the
 same assertion family.
 
-<note>
-Not yet recognized by <code>TypeLang\PhpDoc\DocBlockParser</code> — parsing
-a docblock containing this tag returns a plain <code>Tag</code>, its whole
-suffix folded into the description. See
-<a href="custom-tags.md">Custom Tags</a> for the current workaround if you
-need to recognize it yourself.
-</note>
+```
+"@phan-assert" <Type> <Variable> [ <Description> ]
+```
+
+Parsing a `@phan-assert` tag produces an `AssertTag` instance, carrying the
+asserted `$type` and `$variable` alongside the `$name` and optional
+`$description` every [Tag](phpdoc.md#tag) already provides.
+
+```php
+final class AssertTag extends TypedVariableTag {}
+```
+
+The same `AssertTag` is produced by [@psalm-assert](psalm-assert-tag.md) and [@phpstan-assert](phpstan-assert-tag.md), which restate the same
+assertion for their respective tools.
 
 Defined by Phan; see the "Assertions" section of
 [Phan's Annotating Your Source Code wiki](https://github.com/phan/phan/wiki/Annotating-Your-Source-Code).

Writerside/topics/phpdoc/tags/phan-closure-scope-tag.md

@@ -1,7 +1,6 @@
 # @phan-closure-scope
 
 <primary-label ref="phpdoc-component"/>
-<secondary-label ref="not-implemented"/>
 
 The `@phan-closure-scope` tag binds the type of `$this` inside a
 `Closure`, letting Phan analyze the closure's body as though it were
@@ -11,12 +10,12 @@ bound to an instance of the given class.
 "@phan-closure-scope" <Type>
 ```
 
-<note>
-Not yet recognized by <code>TypeLang\PhpDoc\DocBlockParser</code> — parsing
-a docblock containing this tag returns a plain <code>Tag</code>, its whole
-suffix folded into the description. See
-<a href="custom-tags.md">Custom Tags</a> for the current workaround if you
-need to recognize it yourself.
-</note>
+Parsing a `@phan-closure-scope` tag produces a `PhanClosureScopeTag` instance, carrying the
+parsed `$type` alongside the `$name` and optional `$description` every
+[Tag](phpdoc.md#tag) already provides.
+
+```php
+final class PhanClosureScopeTag extends TypedTag {}
+```
 
 Defined by [Phan's Annotating Your Source Code wiki](https://github.com/phan/phan/wiki/Annotating-Your-Source-Code#phan-closure-scope).

Writerside/topics/phpdoc/tags/phan-hardcode-return-type-tag.md

@@ -1,18 +1,21 @@
 # @phan-hardcode-return-type
 
 <primary-label ref="phpdoc-component"/>
-<secondary-label ref="not-implemented"/>
 
 The `@phan-hardcode-return-type` tag forces Phan to use the
 documented return type instead of the type it would otherwise infer
 from the method body.
 
-<note>
-Not yet recognized by <code>TypeLang\PhpDoc\DocBlockParser</code> — parsing
-a docblock containing this tag returns a plain <code>Tag</code>, its whole
-suffix folded into the description. See
-<a href="custom-tags.md">Custom Tags</a> for the current workaround if you
-need to recognize it yourself.
-</note>
+```
+"@phan-hardcode-return-type" <Type> [ <Description> ]
+```
+
+Parsing a `@phan-hardcode-return-type` tag produces a `PhanHardcodeReturnTypeTag` instance, carrying the
+parsed `$type` alongside the `$name` and optional `$description` every
+[Tag](phpdoc.md#tag) already provides.
+
+```php
+final class PhanHardcodeReturnTypeTag extends TypedTag {}
+```
 
 Defined by Phan.

Writerside/topics/phpdoc/tags/phan-real-return-tag.md

@@ -1,19 +1,22 @@
 # @phan-real-return
 
 <primary-label ref="phpdoc-component"/>
-<secondary-label ref="not-implemented"/>
 
 The `@phan-real-return` tag documents the actual native return
 type of a function or method, kept distinct from the type
 documented via [@return](return-tag.md).
 
-<note>
-Not yet recognized by <code>TypeLang\PhpDoc\DocBlockParser</code> — parsing
-a docblock containing this tag returns a plain <code>Tag</code>, its whole
-suffix folded into the description. See
-<a href="custom-tags.md">Custom Tags</a> for the current workaround if you
-need to recognize it yourself.
-</note>
+```
+"@phan-real-return" <Type> [ <Description> ]
+```
+
+Parsing a `@phan-real-return` tag produces a `PhanRealReturnTag` instance, carrying the
+parsed `$type` alongside the `$name` and optional `$description` every
+[Tag](phpdoc.md#tag) already provides.
+
+```php
+final class PhanRealReturnTag extends TypedTag {}
+```
 
 Defined by Phan, a static analyzer for PHP; no dedicated
 documentation page could be confirmed for this tag.

Writerside/topics/phpdoc/tags/phanclosurescope-tag.md

@@ -1,18 +1,15 @@
 # @phanclosurescope
 
 <primary-label ref="phpdoc-component"/>
-<secondary-label ref="not-implemented"/>
+<secondary-label ref="alias-tag"/>
 
 The `@phanclosurescope` tag is an older alias of
 [@phan-closure-scope](phan-closure-scope-tag.md), binding the
 type of `$this` inside a `Closure`.
 
-<note>
-Not yet recognized by <code>TypeLang\PhpDoc\DocBlockParser</code> — parsing
-a docblock containing this tag returns a plain <code>Tag</code>, its whole
-suffix folded into the description. See
-<a href="custom-tags.md">Custom Tags</a> for the current workaround if you
-need to recognize it yourself.
-</note>
+This library recognizes `@phanclosurescope` as an alias of the canonical
+[@phan-closure-scope](phan-closure-scope-tag.md) tag: it parses identically and produces
+the exact same tag instance, keeping the vendor-prefixed name it was
+written with.
 
 Defined by [Phan](https://github.com/phan/phan/wiki/Annotating-Your-Source-Code).