fixes in order that all the doc compiles

Author: nikophil

_build/composer.lock

@@ -3,12 +3,10 @@
 namespace SymfonyDocs\Command;
 
 use Doctrine\RST\Builder;
-use Doctrine\RST\Event\PostBuildRenderEvent;
 use Doctrine\RST\Event\PostNodeRenderEvent;
 use Doctrine\RST\Event\PostParseDocumentEvent;
-use Doctrine\RST\Event\PreBuildParseEvent;
 use Doctrine\RST\Event\PreBuildRenderEvent;
-use Doctrine\RST\Event\PreBuildScanEvent;
+use Doctrine\RST\Nodes\DocumentNode;
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Helper\ProgressBar;
 use Symfony\Component\Console\Input\InputInterface;
@@ -41,6 +39,7 @@ class ParseDoc extends Command
     private $htmlOutputDir;
     private $jsonOutputDir;
     private $parsedFiles = [];
+    private $parseOnly;
 
     public function __construct()
     {
@@ -57,12 +56,14 @@ protected function configure()
         $this
             ->addOption('source-dir', null, InputOption::VALUE_REQUIRED, 'RST files Source directory', __DIR__.'/../../..')
             ->addOption('html-output-dir', null, InputOption::VALUE_REQUIRED, 'HTML files output directory', __DIR__.'/../../html')
-            ->addOption('json-output-dir', null, InputOption::VALUE_REQUIRED, 'JSON files output directory', __DIR__.'/../../json');
+            ->addOption('json-output-dir', null, InputOption::VALUE_REQUIRED, 'JSON files output directory', __DIR__.'/../../json')->addOption('parse-only', null, InputOption::VALUE_OPTIONAL, 'Parse only given directory', null)
+//            ->addOption('for-pdf', null, InputOption::VALUE_NONE, 'Export for pdf')
+        ;
     }
 
     protected function initialize(InputInterface $input, OutputInterface $output)
     {
-        $this->io = new SymfonyStyle($input, $output);
+        $this->io     = new SymfonyStyle($input, $output);
         $this->output = $output;
 
         $this->sourceDir = $this->getRealAbsolutePath($input->getOption('source-dir'));
@@ -80,6 +81,11 @@ protected function initialize(InputInterface $input, OutputInterface $output)
             $this->filesystem->remove($this->jsonOutputDir);
         }
 
+//        $this->parseOnly = $this->getRealAbsolutePath($input->getOption('parse-only'));
+//        if ($this->parseOnly && !$this->filesystem->exists($this->parseOnly)) {
+//            throw new \InvalidArgumentException(sprintf('Given "parse-only" directory "%s" does not exist', $this->parseOnly));
+//        }
+
         $this->builder = new Builder(KernelFactory::createKernel());
         $eventManager  = $this->builder->getConfiguration()->getEventManager();
         $eventManager->addEventListener(
@@ -117,7 +123,7 @@ protected function execute(InputInterface $input, OutputInterface $output)
             }
         }
 
-        $this->io->note('Start transforming doc into json files');
+        $this->io->note('Start exporting doc into json files');
         $this->progressBar = new ProgressBar($output, $this->finder->count());
         $jsonGenerator     = new JsonGenerator($this->builder->getDocuments()->getAll());
         $jsonGenerator->generateJson($this->htmlOutputDir, $this->jsonOutputDir, $this->progressBar);
@@ -152,15 +158,27 @@ public function postParseDocument(PostParseDocumentEvent $postParseDocumentEvent
 
     public function preBuildRender()
     {
-        $eventManager  = $this->builder->getConfiguration()->getEventManager();
+        $eventManager = $this->builder->getConfiguration()->getEventManager();
         $eventManager->removeEventListener(
             [PostParseDocumentEvent::POST_PARSE_DOCUMENT],
             $this
         );
 
         $this->progressBar->finish();
 
+        $this->progressBar = new ProgressBar($this->output);
+
+        $eventManager->addEventListener(
+            [PostNodeRenderEvent::POST_NODE_RENDER],
+            $this
+        );
+
         $this->io->newLine(2);
         $this->io->note('Start rendering in HTML...');
     }
+
+    public function postNodeRender()
+    {
+        $this->progressBar->advance();
+    }
 }

_build/src/Command/ParseDoc.php

@@ -17,3 +17,4 @@
         AnnotationRegistry::registerLoader([$loader, 'loadClass']);
 
         return $loader;
+

_includes/_annotation_loader_tip.rst.inc

@@ -10,7 +10,7 @@ using an email address that already exists in the system.
 +----------------+-------------------------------------------------------------------------------------+
 | Options        | - `fields`_                                                                         |
 |                | - `message`_                                                                        |
-|                | - `em`_                                                                             |
+|                | - :ref:`em <reference-constraint-unique-entity-em>`                                                                             |
 |                | - `repositoryMethod`_                                                               |
 |                | - `errorPath`_                                                                      |
 |                | - `ignoreNull`_                                                                     |
@@ -141,6 +141,8 @@ message
 
 The message that's displayed when this constraint fails.
 
+.. _reference-constraint-unique-entity-em:
+
 em
 ~~
 

reference/constraints/UniqueEntity.rst

@@ -14,7 +14,7 @@ objects from the database.
 +-------------+------------------------------------------------------------------+
 | Options     | - `choice_label`_                                                |
 |             | - `class`_                                                       |
-|             | - `em`_                                                          |
+|             | - :ref:`em <reference-forms-type-entity-em>`                     |
 |             | - `query_builder`_                                               |
 +-------------+------------------------------------------------------------------+
 | Overridden  | - `choice_name`_                                                 |
@@ -187,6 +187,8 @@ The class of your entity (e.g. ``AppBundle:Category``). This can be
 a fully-qualified class name (e.g. ``AppBundle\Entity\Category``)
 or the short alias name (as shown prior).
 
+.. _reference-forms-type-entity-em:
+
 em
 ~~