Register @example tag handler out of the box

The Example tag handler exists and is fully functional, but was never wired into the default tag handler map of StandardTagFactory. As a result, `@example` and `{@example ...}` were always parsed as a Generic tag, which broke downstream tooling (phpDocumentor rendered the tag as a literal string instead of resolving the referenced file).

Fixes #412

Author: lacatoire

src/DocBlock/StandardTagFactory.php

@@ -17,6 +17,7 @@
 use phpDocumentor\Reflection\DocBlock\Tags\Author;
 use phpDocumentor\Reflection\DocBlock\Tags\Covers;
 use phpDocumentor\Reflection\DocBlock\Tags\Deprecated;
+use phpDocumentor\Reflection\DocBlock\Tags\Example;
 use phpDocumentor\Reflection\DocBlock\Tags\Factory\AbstractPHPStanFactory;
 use phpDocumentor\Reflection\DocBlock\Tags\Factory\ExtendsFactory;
 use phpDocumentor\Reflection\DocBlock\Tags\Factory\Factory;
@@ -89,6 +90,7 @@ final class StandardTagFactory implements TagFactory
         'author'             => Author::class,
         'covers'             => Covers::class,
         'deprecated'         => Deprecated::class,
+        'example'            => Example::class,
         'link'               => LinkTag::class,
         'see'                => SeeTag::class,
         'since'              => Since::class,

tests/unit/DocBlock/StandardTagFactoryTest.php

@@ -22,6 +22,7 @@
 use phpDocumentor\Reflection\Assets\CustomTagFactory;
 use phpDocumentor\Reflection\DocBlock\Tags\Author;
 use phpDocumentor\Reflection\DocBlock\Tags\Deprecated;
+use phpDocumentor\Reflection\DocBlock\Tags\Example;
 use phpDocumentor\Reflection\DocBlock\Tags\Extends_;
 use phpDocumentor\Reflection\DocBlock\Tags\Formatter;
 use phpDocumentor\Reflection\DocBlock\Tags\Formatter\PassthroughFormatter;
@@ -135,6 +136,27 @@ public function testCreatingASpecificTag(): void
         $this->assertSame('author', $tag->getName());
     }
 
+    /**
+     * @uses \phpDocumentor\Reflection\DocBlock\StandardTagFactory::addService
+     * @uses \phpDocumentor\Reflection\DocBlock\Tags\Example
+     *
+     * @covers ::__construct
+     * @covers ::create
+     */
+    public function testExampleTagIsRecognisedOutOfTheBox(): void
+    {
+        $context    = new Context('');
+        $tagFactory = StandardTagFactory::createInstance(m::mock(FqsenResolver::class));
+
+        $tag = $tagFactory->create('@example "path/to/example.php" 3 10 Example description.', $context);
+
+        $this->assertInstanceOf(Example::class, $tag);
+        $this->assertSame('example', $tag->getName());
+        $this->assertSame('path/to/example.php', $tag->getFilePath());
+        $this->assertSame(3, $tag->getStartingLine());
+        $this->assertSame(10, $tag->getLineCount());
+    }
+
     /**
      * @uses \phpDocumentor\Reflection\DocBlock\StandardTagFactory::addService
      * @uses \phpDocumentor\Reflection\DocBlock\Tags\See