Document $suffix argument to tempnam()

.doctor-rst.yaml

@@ -40,18 +40,18 @@ rules:
     extend_abstract_controller: ~
 #    no_app_bundle: ~
 
-    #   4.x
+    #   master
     versionadded_directive_major_version:
-        major_version: 4
+        major_version: 5
 
     versionadded_directive_min_version:
-        min_version: '4.0'
+        min_version: '5.0'
 
     deprecated_directive_major_version:
-        major_version: 4
+        major_version: 5
 
     deprecated_directive_min_version:
-        min_version: '4.0'
+        min_version: '5.0'
 
 # do not report as violation
 whitelist:
@@ -78,7 +78,10 @@ whitelist:
         - '.. versionadded:: 1.6' # Flex in setup/upgrade_minor.rst
         - '0 => 123' # assertion for var_dumper - components/var_dumper.rst
         - '1 => "foo"' # assertion for var_dumper - components/var_dumper.rst
+        - '123,' # assertion for var_dumper - components/var_dumper.rst
+        - '"foo",' # assertion for var_dumper - components/var_dumper.rst
         - '$var .= "Because of this `\xE9` octet (\\xE9),\n";'
         - "`Deploying Symfony 4 Apps on Heroku`_."
         - ".. _`Deploying Symfony 4 Apps on Heroku`: https://devcenter.heroku.com/articles/deploying-symfony4"
+        - "//                  224, 165, 141, 224, 164, 164, 224, 165, 135])"
         - '.. versionadded:: 0.2' # MercureBundle

_build/redirection_map

@@ -429,6 +429,7 @@
 /profiler/storage /profiler
 /setup/composer /setup
 /security/security_checker /setup
+/setup/built_in_web_server /setup/symfony_server
 /service_container/parameters /configuration
 /routing/generate_url_javascript /routing
 /routing/slash_in_parameter /routing

bundles/configuration.rst

@@ -199,10 +199,6 @@ The ``Configuration`` class to handle the sample configuration looks like::
         }
     }
 
-.. deprecated:: 4.2
-
-    Not passing the root node name to ``TreeBuilder`` was deprecated in Symfony 4.2.
-
 .. seealso::
 
     The ``Configuration`` class can be much more complicated than shown here,

cache.rst

@@ -30,10 +30,6 @@ The following example shows a typical usage of the cache::
 Symfony supports the Cache Contracts, PSR-6/16 and Doctrine Cache interfaces.
 You can read more about these at the :doc:`component documentation </components/cache>`.
 
-.. versionadded:: 4.2
-
-    The cache contracts were introduced in Symfony 4.2.
-
 .. _cache-configuration-with-frameworkbundle:
 
 Configuring Cache with FrameworkBundle
@@ -390,10 +386,6 @@ If an error happens when storing an item in a pool, Symfony stores it in the
 other pools and no exception is thrown. Later, when the item is retrieved,
 Symfony stores the item automatically in all the missing pools.
 
-.. versionadded:: 4.4
-
-    Support for configuring a chain using ``framework.cache.pools`` was introduced in Symfony 4.4.
-
 .. configuration-block::
 
     .. code-block:: yaml
@@ -614,10 +606,6 @@ To see all available cache pools:
 
     $ php bin/console cache:pool:list
 
-.. versionadded:: 4.3
-
-    The ``cache:pool:list`` command was introduced in Symfony 4.3.
-
 Clear one pool:
 
 .. code-block:: terminal

components/browser_kit.rst

@@ -312,10 +312,6 @@ dedicated web crawler or scraper such as `Goutte`_::
         '.table-list-header-toggle a:nth-child(1)'
     )->text());
 
-.. versionadded:: 4.3
-
-    The feature to make external HTTP requests was introduced in Symfony 4.3.
-
 Learn more
 ----------
 

components/cache/adapters/memcached_adapter.rst

@@ -70,10 +70,6 @@ helper method allows creating and configuring a `Memcached`_ class instance usin
         'memcached:?host[localhost]&host[localhost:12345]&host[/some/memcached.sock:]=3'
     );
 
-.. versionadded:: 4.2
-
-    The option to define multiple servers in a single DSN was introduced in Symfony 4.2.
-
 The `Data Source Name (DSN)`_ for this adapter must use the following format:
 
 .. code-block:: text

components/cache/adapters/redis_adapter.rst

@@ -102,14 +102,6 @@ name of your service group::
         'redis:?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster'
     );
 
-.. versionadded:: 4.2
-
-    The option to define multiple servers in a single DSN was introduced in Symfony 4.2.
-
-.. versionadded:: 4.4
-
-    Redis Sentinel support was introduced in Symfony 4.4.
-
 .. note::
 
     See the :class:`Symfony\\Component\\Cache\\Traits\\RedisTrait` for more options

components/cache/psr6_psr16_adapters.rst

@@ -46,10 +46,6 @@ this use-case::
     // now use this wherever you want
     $githubApiClient = new GitHubApiClient($psr6Cache);
 
-.. versionadded:: 4.3
-
-    The ``Psr16Adapter`` class was introduced in Symfony 4.3.
-
 Using a PSR-6 Cache Object as a PSR-16 Cache
 --------------------------------------------
 
@@ -87,8 +83,4 @@ this use-case::
     // now use this wherever you want
     $githubApiClient = new GitHubApiClient($psr16Cache);
 
-.. versionadded:: 4.3
-
-    The ``Psr16Cache`` class was introduced in Symfony 4.3.
-
 .. _`PSR-16`: http://www.php-fig.org/psr/psr-16/

components/config/definition.rst

@@ -68,10 +68,6 @@ implements the :class:`Symfony\\Component\\Config\\Definition\\ConfigurationInte
         }
     }
 
-.. deprecated:: 4.2
-
-    Not passing the root node name to ``TreeBuilder`` was deprecated in Symfony 4.2.
-
 Adding Node Definitions to the Tree
 -----------------------------------
 

components/console/helpers/progressbar.rst

@@ -56,11 +56,6 @@ you can also set the current progress by calling the
     to redraw every N iterations. By default, redraw frequency is
     **100ms** or **10%** of your ``max``.
 
-    .. versionadded:: 4.4
-
-        The ``minSecondsBetweenRedraws()`` and ``maxSecondsBetweenRedraws()``
-        methods were introduced in Symfony 4.4.
-
 If you don't know the exact number of steps in advance, set it to a reasonable
 value and then call the ``setMaxSteps()`` method to update it as needed::
 
@@ -124,10 +119,6 @@ If ``$iterable = [1, 2]``, the previous code will output the following:
      1/2 [==============>-------------]  50%
      2/2 [============================] 100%
 
-.. versionadded:: 4.3
-
-    The ``iterate()`` method was introduced in Symfony 4.3.
-
 Customizing the Progress Bar
 ----------------------------
 
@@ -316,11 +307,6 @@ to display it can be customized::
             $progressBar->advance();
         }
 
-    .. versionadded:: 4.4
-
-        The ``minSecondsBetweenRedraws`` and ``maxSecondsBetweenRedraws()`` methods
-        were introduced in Symfony 4.4.
-
 Custom Placeholders
 ~~~~~~~~~~~~~~~~~~~
 

components/console/helpers/questionhelper.rst

@@ -214,10 +214,6 @@ provide a callback function to dynamically generate suggestions::
         $filePath = $helper->ask($input, $output, $question);
     }
 
-.. versionadded:: 4.3
-
-    The ``setAutocompleterCallback()`` method was introduced in Symfony 4.3.
-
 Do not Trim the Answer
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -238,10 +234,6 @@ You can also specify if you want to not trim the answer by setting it directly w
         $name = $helper->ask($input, $output, $question);
     }
 
-.. versionadded:: 4.4
-
-    The ``setTrimmable()`` method was introduced in Symfony 4.4.
-
 Hiding the User's Response
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 

components/console/single_command_tool.rst

@@ -5,34 +5,36 @@ Building a single Command Application
 =====================================
 
 When building a command line tool, you may not need to provide several commands.
-In such case, having to pass the command name each time is tedious. Fortunately,
-it is possible to remove this need by declaring a single command application::
+In such case, having to pass the command name each time is tedious.
+
+.. versionadded:: 5.1
+
+    The :class:`Symfony\\Component\\Console\\SingleCommandApplication` class was
+    introduced in Symfony 5.1.
+
+Fortunately, it is possible to remove this need by declaring a single command
+application::
 
     #!/usr/bin/env php
     <?php
     require __DIR__.'/vendor/autoload.php';
 
-    use Symfony\Component\Console\Application;
     use Symfony\Component\Console\Input\InputArgument;
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Input\InputOption;
     use Symfony\Component\Console\Output\OutputInterface;
-
-    (new Application('echo', '1.0.0'))
-        ->register('echo')
-            ->addArgument('foo', InputArgument::OPTIONAL, 'The directory')
-            ->addOption('bar', null, InputOption::VALUE_REQUIRED)
-            ->setCode(function(InputInterface $input, OutputInterface $output) {
-                // output arguments and options
-            })
-        ->getApplication()
-        ->setDefaultCommand('echo', true) // Single command application
+    use Symfony\Component\Console\SingleCommandApplication;
+
+    (new SingleCommandApplication())
+        ->setName('My Super Command') // Optional
+        ->setVersion('1.0.0') // Optional
+        ->addArgument('foo', InputArgument::OPTIONAL, 'The directory')
+        ->addOption('bar', null, InputOption::VALUE_REQUIRED)
+        ->setCode(function (InputInterface $input, OutputInterface $output) {
+            // output arguments and options
+        })
         ->run();
 
-The :method:`Symfony\\Component\\Console\\Application::setDefaultCommand` method
-accepts a boolean as second parameter. If true, the command ``echo`` will then
-always be used, without having to pass its name.
-
 You can still register a command as usual::
 
     #!/usr/bin/env php
@@ -49,3 +51,7 @@ You can still register a command as usual::
 
     $application->setDefaultCommand($command->getName(), true);
     $application->run();
+
+The :method:`Symfony\\Component\\Console\\Application::setDefaultCommand` method
+accepts a boolean as second parameter. If true, the command ``echo`` will then
+always be used, without having to pass its name.

components/css_selector.rst

@@ -98,10 +98,6 @@ Pseudo-classes are partially supported:
   ``li:first-of-type``) but not with the ``*`` selector).
 * Supported: ``*:only-of-type``.
 
-.. versionadded:: 4.4
-
-    The support for ``*:only-of-type`` was introduced in Symfony 4.4.
-
 Learn more
 ----------
 

components/dom_crawler.rst

@@ -77,10 +77,6 @@ tree.
     The DomCrawler component will use it automatically when the content has
     an HTML5 doctype.
 
-    .. versionadded:: 4.3
-
-        The automatic support of the html5-php library was introduced in Symfony 4.3.
-
 Node Filtering
 ~~~~~~~~~~~~~~
 
@@ -169,10 +165,6 @@ Verify if the current node matches a selector::
 
     $crawler->matches('p.lorem');
 
-.. versionadded:: 4.4
-
-    The ``matches()`` method was introduced in Symfony 4.4.
-
 Node Traversing
 ~~~~~~~~~~~~~~~
 
@@ -207,10 +199,6 @@ Get the first parent (heading toward the document root) of the element that matc
 
     $crawler->closest('p.lorem');
 
-.. versionadded:: 4.4
-
-    The ``closest()`` method was introduced in Symfony 4.4.
-
 .. note::
 
     All the traversal methods return a new :class:`Symfony\\Component\\DomCrawler\\Crawler`
@@ -236,14 +224,6 @@ Access the value of the first node of the current selection::
     // the internal ones (e.g. "  foo\n  bar    baz \n " is returned as "foo bar baz")
     $crawler->filterXPath('//body/p')->text('Default text content', true);
 
-.. versionadded:: 4.3
-
-    The default argument of ``text()`` was introduced in Symfony 4.3.
-
-.. versionadded:: 4.4
-
-    The option to trim white spaces in ``text()`` was introduced in Symfony 4.4.
-
 Access the attribute value of the first node of the current selection::
 
     $class = $crawler->filterXPath('//body/p')->attr('class');
@@ -260,10 +240,6 @@ Extract attribute and/or node values from the list of nodes::
     Special attribute ``_text`` represents a node value, while ``_name``
     represents the element name (the HTML tag name).
 
-    .. versionadded:: 4.3
-
-        The special attribute ``_name`` was introduced in Symfony 4.3.
-
 Call an anonymous function on each node of the list::
 
     use Symfony\Component\DomCrawler\Crawler;
@@ -357,19 +333,11 @@ and :phpclass:`DOMNode` objects::
         // avoid the exception passing an argument that html() returns when node does not exist
         $html = $crawler->html('Default <strong>HTML</strong> content');
 
-    .. versionadded:: 4.3
-
-        The default argument of ``html()`` was introduced in Symfony 4.3.
-
     Or you can get the outer HTML of the first node using
     :method:`Symfony\\Component\\DomCrawler\\Crawler::outerHtml`::
 
         $html = $crawler->outerHtml();
 
-    .. versionadded:: 4.4
-
-        The ``outerHtml()`` method was introduced in Symfony 4.4.
-
 Expression Evaluation
 ~~~~~~~~~~~~~~~~~~~~~
 
@@ -521,10 +489,6 @@ useful methods for working with forms::
     $method = $form->getMethod();
     $name = $form->getName();
 
-.. versionadded:: 4.4
-
-    The ``getName()`` method was introduced in Symfony 4.4.
-
 The :method:`Symfony\\Component\\DomCrawler\\Form::getUri` method does more
 than just return the ``action`` attribute of the form. If the form method
 is GET, then it mimics the browser's behavior and returns the ``action``

components/dotenv.rst

@@ -104,10 +104,6 @@ You can adjust the variable defining the environment, default environment and te
 environments by passing them as additional arguments to ``Dotenv::loadEnv()``
 (see :method:`Symfony\\Component\\Dotenv\\Dotenv::loadEnv` for details).
 
-.. versionadded:: 4.2
-
-    The ``Dotenv::loadEnv()`` method was introduced in Symfony 4.2.
-
 You should never store a ``.env.local`` file in your code repository as it might
 contain sensitive information; create a ``.env`` file (or multiple
 environment-specific ones as shown above) with sensible defaults instead.
@@ -156,10 +152,6 @@ Define a default value in case the environment variable is not set:
     DB_USER=
     DB_PASS=${DB_USER:-root}pass # results in DB_PASS=rootpass
 
-.. versionadded:: 4.4
-
-    The support for default values has been introduced in Symfony 4.4.
-
 Embed commands via ``$()`` (not supported on Windows):
 
 .. code-block:: terminal