Move some @throws phpdocs where they belong

Author: fabpot

src/Environment.php

@@ -323,10 +323,6 @@ public function getTemplateClass(string $name, ?int $index = null): string
      * Renders a template.
      *
      * @param string|TemplateWrapper $name The template name
-     *
-     * @throws LoaderError  When the template cannot be found
-     * @throws SyntaxError  When an error occurred during compilation
-     * @throws RuntimeError When an error occurred during rendering
      */
     public function render($name, array $context = []): string
     {
@@ -337,10 +333,6 @@ public function render($name, array $context = []): string
      * Displays a template.
      *
      * @param string|TemplateWrapper $name The template name
-     *
-     * @throws LoaderError  When the template cannot be found
-     * @throws SyntaxError  When an error occurred during compilation
-     * @throws RuntimeError When an error occurred during rendering
      */
     public function display($name, array $context = []): void
     {
@@ -351,10 +343,6 @@ public function display($name, array $context = []): void
      * Loads a template.
      *
      * @param string|TemplateWrapper $name The template name
-     *
-     * @throws LoaderError  When the template cannot be found
-     * @throws RuntimeError When a previously generated cache is corrupted
-     * @throws SyntaxError  When an error occurred during compilation
      */
     public function load($name): TemplateWrapper
     {
@@ -379,9 +367,7 @@ public function load($name): TemplateWrapper
      * @param string   $name  The template name
      * @param int|null $index The index if it is an embedded template
      *
-     * @throws LoaderError  When the template cannot be found
      * @throws RuntimeError When a previously generated cache is corrupted
-     * @throws SyntaxError  When an error occurred during compilation
      *
      * @internal
      */
@@ -438,9 +424,6 @@ public function loadTemplate(string $cls, string $name, ?int $index = null): Tem
      *
      * @param string      $template The template source
      * @param string|null $name     An optional name of the template to be used in error messages
-     *
-     * @throws LoaderError When the template cannot be found
-     * @throws SyntaxError When an error occurred during compilation
      */
     public function createTemplate(string $template, ?string $name = null): TemplateWrapper
     {
@@ -487,7 +470,6 @@ public function isTemplateFresh(string $name, int $time): bool
      * @param string|TemplateWrapper|array<string|TemplateWrapper> $names A template or an array of templates to try consecutively
      *
      * @throws LoaderError When none of the templates can be found
-     * @throws SyntaxError When an error occurred during compilation
      */
     public function resolveTemplate($names): TemplateWrapper
     {
@@ -524,9 +506,6 @@ public function setLexer(Lexer $lexer)
         $this->lexer = $lexer;
     }
 
-    /**
-     * @throws SyntaxError When the code is syntactically wrong
-     */
     public function tokenize(Source $source): TokenStream
     {
         if (null === $this->lexer) {
@@ -546,8 +525,6 @@ public function setParser(Parser $parser)
 
     /**
      * Converts a token stream to a node tree.
-     *
-     * @throws SyntaxError When the token stream is syntactically or semantically wrong
      */
     public function parse(TokenStream $stream): ModuleNode
     {

src/Lexer.php

@@ -181,6 +181,9 @@ private function initialize(): void
         $this->isInitialized = true;
     }
 
+    /**
+     * @throws SyntaxError When the code is syntactically wrong
+     */
     public function tokenize(Source $source): TokenStream
     {
         $this->initialize();

src/Parser.php

@@ -76,6 +76,9 @@ public function getVarName(): string
         return \sprintf('__internal_parse_%d', $this->varNameSalt++);
     }
 
+    /**
+     * @throws SyntaxError When the token stream is syntactically or semantically wrong
+     */
     public function parse(TokenStream $stream, $test = null, bool $dropNeedle = false): ModuleNode
     {
         $vars = get_object_vars($this);

src/Template.php

@@ -353,13 +353,23 @@ public function getBlocks(): array
         return $this->blocks;
     }
 
+    /**
+     * @throws LoaderError  When the template cannot be found
+     * @throws SyntaxError  When an error occurred during compilation
+     * @throws RuntimeError When an error occurred during rendering
+     */
     public function display(array $context, array $blocks = []): void
     {
         foreach ($this->yield($context, $blocks) as $data) {
             echo $data;
         }
     }
 
+    /**
+     * @throws LoaderError  When the template cannot be found
+     * @throws SyntaxError  When an error occurred during compilation
+     * @throws RuntimeError When an error occurred during rendering
+     */
     public function render(array $context): string
     {
         if (!$this->useYield) {