Fix Sphinx syntax errors in the documentation

Author: wouterj

_build/.requirements.txt

@@ -12,3 +12,4 @@ snowballstemmer==1.2.1
 sphinx==1.8.5
 git+https://github.com/fabpot/[email protected]#egg_name=sphinx-php
 sphinxcontrib-phpdomain==0.6.3
+jsx-lexer===0.0.8

best_practices/creating-the-project.rst

@@ -27,15 +27,15 @@ to create files and execute the following commands:
 
 **Linux and macOS systems**:
 
-.. class:: command-linux
+.. rst-class:: command-linux
 .. code-block:: terminal
 
     $ cd projects/
     $ symfony new blog --version=3.4
 
 **Windows systems**:
 
-.. class:: command-windows
+.. rst-class:: command-windows
 .. code-block:: terminal
 
     > cd projects/

components/asset.rst

@@ -147,7 +147,6 @@ corresponding output file:
 
 .. code-block:: json
 
-    // rev-manifest.json
     {
         "css/app.css": "build/css/app.b916426ea1d10021f3f17ce8031f93c2.css",
         "js/app.js": "build/js/app.13630905267b809161e71d0f8a0c017b.js",
@@ -160,6 +159,7 @@ In those cases, use the
     use Symfony\Component\Asset\Package;
     use Symfony\Component\Asset\VersionStrategy\JsonManifestVersionStrategy;
 
+    // assumes the JSON file above is called "rev-manifest.json"
     $package = new Package(new JsonManifestVersionStrategy(__DIR__.'/rev-manifest.json'));
 
     echo $package->getUrl('css/app.css');

components/lock.rst

@@ -155,7 +155,7 @@ object) and ``isExpired()`` (which returns a boolean).
 The Owner of The Lock
 ---------------------
 
-Locks that are acquired for the first time are owned[1]_ by the ``Lock`` instance that acquired
+Locks that are acquired for the first time are owned [1]_ by the ``Lock`` instance that acquired
 it. If you need to check whether the current ``Lock`` instance is (still) the owner of
 a lock, you can use the ``isAcquired()`` method::
 

controller.rst

@@ -314,7 +314,7 @@ the argument by its name:
 
                 <!-- Explicitly configure the service -->
                 <service id="AppBundle\Controller\LuckyController">
-                    <tag name"controller.service_arguments"/>
+                    <tag name="controller.service_arguments"/>
                     <bind key="$logger"
                         type="service"
                         id="monolog.logger.doctrine"

frontend/encore/vuejs.rst

@@ -78,10 +78,9 @@ Using styles
 You can't use ``<style>`` in ``.jsx`` files. As a workaround, you can import
 ``.css``, ``.scss``, etc. files manually:
 
-.. code-block:: javascript
+.. code-block:: jsx
 
     // App.jsx
-
     import './App.css'
 
     export default {
@@ -107,10 +106,9 @@ You can't use `Scoped Styles`_ (``<style scoped>``) either in ``.jsx`` files. As
 a workaround, you can use `CSS Modules`_ by suffixing import paths with
 ``?module``:
 
-.. code-block:: javascript
+.. code-block:: jsx
 
     // Component.jsx
-
     import styles from './Component.css?module' // suffix with "?module"
 
     export default {
@@ -142,7 +140,7 @@ Using images
 You can't use ``<img src="./image.png">`` in ``.jsx`` files. As a workaround,
 you can import them with ``require()`` function:
 
-.. code-block:: javascript
+.. code-block:: jsx
 
     export default {
         name: 'Component',

reference/configuration/debug.rst

@@ -25,7 +25,7 @@ key in your application configuration.
 Configuration
 -------------
 
-.. class:: list-config-options
+.. rst-class:: list-config-options
 
 * `dump_destination`_
 * `max_items`_

reference/configuration/framework.rst

@@ -27,7 +27,7 @@ configured under the ``framework`` key in your application configuration.
 Configuration
 -------------
 
-.. class:: list-config-options list-config-options--complex
+.. rst-class:: list-config-options list-config-options--complex
 
 * `annotations`_
 

reference/configuration/swiftmailer.rst

@@ -25,7 +25,7 @@ to :doc:`send emails </email>`. All these options are configured under the
 Configuration
 -------------
 
-.. class:: list-config-options list-config-options--complex
+.. rst-class:: list-config-options list-config-options--complex
 
 * `antiflood`_
 

reference/configuration/twig.rst

@@ -25,7 +25,7 @@ the ``twig`` key in your application configuration.
 Configuration
 -------------
 
-.. class:: list-config-options list-config-options--complex
+.. rst-class:: list-config-options list-config-options--complex
 
 * `auto_reload`_
 * `autoescape`_

reference/configuration/web_profiler.rst

@@ -30,7 +30,7 @@ execution and displays it in both the web debug toolbar and the
 Configuration
 -------------
 
-.. class:: list-config-options
+.. rst-class:: list-config-options
 
 * `excluded_ajax_paths`_
 * `intercept_redirects`_

reference/forms/twig_reference.rst

@@ -197,7 +197,7 @@ array).
 
 .. code-block:: html+twig
 
-    <option {% if choice is selectedchoice(value) %} selected="selected"{% endif %} ...>
+    <option {% if choice is selectedchoice(value) %} selected="selected"{% endif %} {# ... #}>
 
 .. _form-twig-rootform:
 
@@ -247,7 +247,7 @@ of variables. By default, these blocks live inside `form_div_layout.html.twig`_.
 
 Look at the ``form_label`` as an example:
 
-.. code-block:: html+twig
+.. code-block:: twig
 
     {% block form_label %}
         {% if not compound %}

security/remember_me.rst

@@ -328,7 +328,7 @@ so ``DoctrineTokenProvider`` can store the tokens:
 
         .. code-block:: xml
 
-            <doctrine:dbal schema-filter="~^(?!rememberme_token)~" .../>
+            <doctrine:dbal schema-filter="~^(?!rememberme_token)~"/>
 
         .. code-block:: php
 

service_container.rst

@@ -1183,12 +1183,12 @@ unique string as the key of each service config:
             <services>
                 <prototype namespace="AppBundle\Domain"
                     resource="../../src/AppBundle/Domain/*/CommandHandler"/>
-                    <tag name"command_handler"/>
+                    <tag name="command_handler"/>
                 </prototype>
 
                 <prototype namespace="AppBundle\Domain"
                     resource="../../src/AppBundle/Domain/*/EventSubscriber"/>
-                    <tag name"event_subscriber"/>
+                    <tag name="event_subscriber"/>
                 </prototype>
 
                 <!-- ... -->

setup.rst

@@ -22,7 +22,7 @@ executable that needs to be installed on your system only once:
 
 **Linux and macOS systems**:
 
-.. class:: command-linux
+.. rst-class:: command-linux
 .. code-block:: terminal
 
     $ sudo mkdir -p /usr/local/bin
@@ -31,7 +31,7 @@ executable that needs to be installed on your system only once:
 
 **Windows systems**:
 
-.. class:: command-windows
+.. rst-class:: command-windows
 .. code-block:: terminal
 
     > php -r "file_put_contents('symfony', file_get_contents('https://symfony.com/installer'));"
@@ -43,7 +43,7 @@ executable that needs to be installed on your system only once:
     environment variable and create a ``symfony.bat`` file to create the global
     command or move it to any other directory convenient for you:
 
-    .. class:: command-windows
+    .. rst-class:: command-windows
     .. code-block:: terminal
 
         # for example, if WAMP is used ...