8000 Make the docs ready for 2.4 by wouterj · Pull Request #2690 · symfony/symfony-docs · GitHub
[go: up one dir, main page]

Skip to content

Make the docs ready for 2.4 #2690

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 2 commits into from
Closed
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
Removed all 2.2 versionadded directives
  • Loading branch information
wouterj committed Jun 12, 2013
commit 02b3a4c17375ba2a1d0047a0610af449d054a0e3
14 changes: 0 additions & 14 deletions book/routing.rst
Original file line number Diff line number Diff line change
Expand Up @@ -67,10 +67,6 @@ The route is simple:

return $collection;

.. versionadded:: 2.2
The ``path`` option is new in Symfony2.2, ``pattern`` is used in older
versions.

The path defined by the ``blog_show`` route acts like ``/blog/*`` where
the wildcard is given the name ``slug``. For the URL ``/blog/my-blog-post``,
the ``slug`` variable gets a value of ``my-blog-post``, which is available
Expand Down Expand Up @@ -681,10 +677,6 @@ be accomplished with the following route configuration:

return $collection;

.. versionadded:: 2.2
The ``methods`` option is added in Symfony2.2. Use the ``_method``
requirement in older versions.

Despite the fact that these two routes have identical paths (``/contact``),
the first route will match only GET requests and the second route will match
only POST requests. This means that you can display the form and submit the
Expand All @@ -697,9 +689,6 @@ form via the same URL, while using distinct controllers for the two actions.
Adding a Host
~~~~~~~~~~~~~

.. versionadded:: 2.2
Host matching support was added in Symfony 2.2

You can also match on the HTTP *host* of the incoming request. For more
information, see :doc:`/components/routing/hostname_pattern` in the Routing
component documentation.
Expand Down Expand Up @@ -1042,9 +1031,6 @@ from the new routing resource.
Adding a Host regex to Imported Routes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. versionadded:: 2.2
Host matching support was added in Symfony 2.2

You can set the host regex on imported routes. For more information, see
:ref:`component-routing-host-imported`.

Expand Down
7 changes: 0 additions & 7 deletions book/security.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1333,10 +1333,6 @@ it as base64. In other words, the password has been greatly obfuscated so
that the hashed password can't be decoded (i.e. you can't determine the password
from the hashed password).

.. versionadded:: 2.2
As of Symfony 2.2 you can also use the :ref:`PBKDF2<reference-security-pbkdf2>`
and :ref:`BCrypt<reference-security-bcrypt>` password encoders.

Determining the Hashed Password
...............................

Expand Down Expand Up @@ -1955,9 +1951,6 @@ cookie will be ever created by Symfony2):
Utilities
---------

.. versionadded:: 2.2
The ``StringUtils`` and ``SecureRandom`` classes were added in Symfony 2.2

The Symfony Security Component comes with a collection of nice utilities related
to security. These utilities are used by Symfony, but you should also use
them if you want to solve the problem they address.
Expand Down
12 changes: 0 additions & 12 deletions book/templating.rst
Original file line number Diff line number Diff line change
Expand Up @@ -376,11 +376,6 @@ When working with template inheritance, here are some tips to keep in mind:
Template Naming and Locations
-----------------------------

.. versionadded:: 2.2
Namespaced path support was added in 2.2, allowing for template names
like ``@AcmeDemo/layout.html.twig``. See :doc:`/cookbook/templating/namespaced_paths`
for more details.

By default, templates can live in two different locations:

* ``app/Resources/views/``: The applications ``views`` directory can contain
Expand Down Expand Up @@ -568,10 +563,6 @@ template using the ``with`` command.
maps (i.e. an array with named keys). If you needed to pass in multiple
elements, it would look like this: ``{'foo': foo, 'bar': bar}``.

.. versionadded:: 2.2
The ``include()`` function is a new Twig feature that's available in
Symfony 2.2. Prior, the ``{% include %}`` tag was used.

.. index::
single: Templating; Embedding action

Expand Down Expand Up @@ -750,9 +741,6 @@ in your application configuration:
),
));

.. versionadded:: 2.2
Default templates per render function was added in Symfony 2.2

You can define default templates per ``render`` function (which will override
any global default template that is defined):

Expand Down
6 changes: 0 additions & 6 deletions components/config/definition.rst
Original file line number Diff line number Diff line change
Expand Up @@ -111,9 +111,6 @@ and are created with ``node($name, $type)`` or their associated shortcut
Numeric node constraints
~~~~~~~~~~~~~~~~~~~~~~~~

.. versionadded:: 2.2
The numeric (float and integer) nodes are new in 2.2

Numeric nodes (float and integer) provide two extra constraints -
:method:`Symfony\\Component\\Config\\Definition\\Builder::min` and
:method:`Symfony\\Component\\Config\\Definition\\Builder::max` -
Expand Down Expand Up @@ -270,9 +267,6 @@ has a certain value:
Optional Sections
-----------------

.. versionadded:: 2.2
The ``canBeEnabled`` and ``canBeDisabled`` methods are new in Symfony 2.2

If you have entire sections which are optional and can be enabled/disabled,
you can take advantage of the shortcut
:method:`Symfony\\Component\\Config\\Definition\\Builder\\ArrayNodeDefinition::canBeEnabled` and
Expand Down
13 changes: 0 additions & 13 deletions components/console/helpers/dialoghelper.rst
Original file line number Diff line number Diff line change
Expand Up @@ -56,9 +56,6 @@ the default value (``AcmeDemoBundle`` here) is returned.
Autocompletion
~~~~~~~~~~~~~~

.. versionadded:: 2.2
Autocompletion for questions was added in Symfony 2.2.

You can also specify an array of potential answers for a given question. These
will be autocompleted as the user types::

Expand All @@ -74,9 +71,6 @@ will be autocompleted as the user types::
Hiding the User's Response
~~~~~~~~~~~~~~~~~~~~~~~~~~

.. versionadded:: 2.2
The ``askHiddenResponse`` method was added in Symfony 2.2.

You can also ask a question and hide the response. This is particularly
convenient for passwords::

Expand Down Expand Up @@ -144,9 +138,6 @@ be able to proceed if her input is valid.
Hiding the User's Response
~~~~~~~~~~~~~~~~~~~~~~~~~~

.. versionadded:: 2.2
The ``askHiddenResponseAndValidate`` method was added in Symfony 2.2.

You can also ask and validate a hidden response::

$dialog = $this->getHelperSet()->get('dialog');
Expand All @@ -171,10 +162,6 @@ some reason, pass true as the fifth argument.
Let the user choose from a list of Answers
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. versionadded:: 2.2
The :method:`Symfony\\Component\\Console\\Helper\\DialogHelper::select` method
was added in Symfony 2.2.

If you have a predefined set of answers the user can choose from, you
could use the ``ask`` method described above or, to make sure the user
provided a correct answer, the ``askAndValidate`` method. Both have
Expand Down
3 changes: 0 additions & 3 deletions components/console/helpers/progresshelper.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,6 @@
Progress Helper
===============

.. versionadded:: 2.2
The ``progress`` helper was added in Symfony 2.2.

.. versionadded:: 2.3
The ``setCurrent`` method was added in Symfony 2.3.

Expand Down
3 changes: 0 additions & 3 deletions components/dependency_injection/compilation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -277,9 +277,6 @@ but also load a secondary one only if a certain parameter is set::
Prepending Configuration passed to the Extension
------------------------------------------------

.. versionadded:: 2.2
The ability to prepend the configuration of a bundle is new in Symfony 2.2.

An Extension can prepend the configuration of any Bundle before the ``load()``
method is called by implementing :class:`Symfony\\Component\\DependencyInjection\\Extension\\PrependExtensionInterface`::

Expand Down
6 changes: 0 additions & 6 deletions components/finder.rst
Original file line number Diff line number Diff line change
Expand Up @@ -82,9 +82,6 @@ Search in several locations by chaining calls to

$finder->files()->in(__DIR__)->in('/elsewhere');

.. versionadded:: 2.2
Wildcard support was added in version 2.2.

Use wildcard characters to search in the directories matching a pattern::

$finder->in('src/Symfony/*/*/Resources');
Expand Down Expand Up @@ -206,9 +203,6 @@ The ``notContains()`` method excludes files containing given pattern::
Path
~~~~

.. versionadded:: 2.2
The ``path()`` and ``notPath()`` methods were added in version 2.2.

Restrict files and directories by path with the
:method:`Symfony\\Component\\Finder\\Finder::path` method::

Expand Down
7 changes: 0 additions & 7 deletions components/http_foundation/introduction.rst
F42D
Original file line number Diff line number Diff line change
Expand Up @@ -240,9 +240,6 @@ by using the following methods:
* :method:`Symfony\\Component\\HttpFoundation\\Request::getCharsets`:
returns the list of accepted charsets ordered by descending quality;

.. versionadded:: 2.2
The :class:`Symfony\\Component\\HttpFoundation\\AcceptHeader` class is new in Symfony 2.2.

If you need to get full access to parsed data from ``Accept``, ``Accept-Language``,
``Accept-Charset`` or ``Accept-Encoding``, you can use
:class:`Symfony\\Component\\HttpFoundation\\AcceptHeader` utility class::
Expand Down Expand Up @@ -430,10 +427,6 @@ abstracts the hard work behind a simple API::

$response->headers->set('Content-Disposition', $d);

.. versionadded:: 2.2
The :class:`Symfony\\Component\\HttpFoundation\\BinaryFileResponse`
class was added in Symfony 2.2.

Alternatively, if you are serving a static file, you can use a
:class:`Symfony\\Component\\HttpFoundation\\BinaryFileResponse`::

Expand Down
3 changes: 0 additions & 3 deletions components/process.rst
Original file line number Diff line number Diff line change
Expand Up @@ -36,9 +36,6 @@ a command in a sub-process::
The component takes care of the subtle differences between the different platforms
when executing the command.

.. versionadded:: 2.2
The ``getIncrementalOutput()`` and ``getIncrementalErrorOutput()`` methods were added in Symfony 2.2.

The ``getOutput()`` method always return the whole content of the standard
output of the command and ``getErrorOutput()`` the content of the error
output. Alternatively, the :method:`Symfony\\Component\\Process\\Process::getIncrementalOutput`
Expand Down
4 changes: 0 additions & 4 deletions components/property_access/introduction.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,6 @@ The PropertyAccess Component
The PropertyAccess component provides function to read and write from/to an
object or array using a simple string notation.

.. versionadded:: 2.2
The PropertyAccess Component is new to Symfony 2.2. Previously, the
``PropertyPath`` class was located in the ``Form`` component.

Installation
------------

Expand Down
3 changes: 0 additions & 3 deletions components/routing/hostname_pattern.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,6 @@
How to match a route based on the Host
======================================

.. versionadded:: 2.2
Host matching support was added in Symfony 2.2

You can also match on the HTTP *host* of the incoming request.

.. configuration-block::
Expand Down
7 changes: 0 additions & 7 deletions components/routing/introduction.rst
Original file line number Diff line number Diff line change
Expand Up @@ -93,9 +93,6 @@ are the least commonly needed.
7. An array of methods. These enforce a certain HTTP request method (``HEAD``,
``GET``, ``POST``, ...).

.. versionadded:: 2.2
Host matching support was added in Symfony 2.2

Take the following route, which combines several of these ideas::

$route = new Route(
Expand Down Expand Up @@ -160,10 +157,6 @@ the :method:`Symfony\\Component\\Routing\\RouteCollection::addPrefix` method::

$rootCollection->addCollection($subCollection);

.. versionadded:: 2.2
The ``addPrefix`` method is added in Symfony2.2. This was part of the
``addCollection`` method in older versions.

Set the Request Parameters
~~~~~~~~~~~~~~~~~~~~~~~~~~

Expand Down
4 changes: 0 additions & 4 deletions components/stopwatch.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,6 @@ The Stopwatch Component

Stopwatch component provides a way to profile code.

.. versionadded:: 2.2
The Stopwatch Component is new to Symfony 2.2. Previously, the ``Stopwatch``
class was located in the ``HttpKernel`` component (and was new in 2.1).

Installation
------------

Expand Down
8 changes: 1 addition & 7 deletions cookbook/form/dynamic_form_modification.rst
Original file line number Diff line number Diff line change
Expand Up @@ -112,13 +112,7 @@ Inside the Event Subscriber Class

The goal is to create a "name" field *only* if the underlying Product object
is new (e.g. hasn't been persisted to the database). Based on that, the subscriber
might look like the following:

.. versionadded:: 2.2
The ability to pass a string into :method:`FormInterface::add<Symfony\\Component\\Form\\FormInterface::add>`
was added in Symfony 2.2.

.. code-block:: php
might look like the following::

// src/Acme/DemoBundle/Form/EventListener/AddNameFieldSubscriber.php
namespace Acme\DemoBundle\Form\EventListener;
Expand Down
5 changes: 1 addition & 4 deletions cookbook/templating/namespaced_paths.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,6 @@
How to use and Register namespaced Twig Paths
=============================================

.. versionadded:: 2.2
Namespaced path support was added in 2.2.

Usually, when you refer to a template, you'll use the ``MyBundle:Subdir:filename.html.twig``
format (see :ref:`template-naming-locations`).

Expand Down Expand Up @@ -80,4 +77,4 @@ called ``sidebar.twig`` in that directory, you can use it easily:

.. code-block:: jinja

{% include '@foo_bar/side.bar.twig` %}
{% include '@foo_bar/side.bar.twig` %}
6 changes: 1 addition & 5 deletions cookbook/templating/render_without_controller.rst
Original file line number Diff line number Diff line change
Expand Up @@ -77,10 +77,6 @@ this is probably only useful if you'd like to cache this page partial (see
Caching the static Template
---------------------------

.. versionadded:: 2.2
The ability to cache templates rendered via ``FrameworkBundle:Template:template``
is new in Symfony 2.2.

Since templates that are rendered in this way are typically static, it might
make sense to cache them. Fortunately, this is easy! By configuring a few
other variables in your route, you can control exactly how your page is cached:
Expand Down Expand Up @@ -134,4 +130,4 @@ object created in the controller. For more information on caching, see

There is also a ``private`` variable (not shown here). By default, the Response
will be made public, as long as ``maxAge`` or ``sharedMaxAge`` are passed.
If set to ``true``, the Response will be marked as private.
If set to ``true``, the Response will be marked as private.
5 changes: 0 additions & 5 deletions reference/configuration/framework.rst
Original file line number Diff line number Diff line change
Expand Up @@ -401,11 +401,6 @@ would be ``/images/logo.png?version=5``.
profiler
~~~~~~~~

.. versionadded:: 2.2
The ``enabled`` option was added in Symfony 2.2. Previously, the profiler
could only be disabled by omitting the ``framework.profiler`` configuration
entirely.

.. _profiler.enabled:

enabled
Expand Down
6 changes: 0 additions & 6 deletions reference/configuration/security.rst
Original file line number Diff line number Diff line change
Expand Up @@ -283,9 +283,6 @@ Redirecting after Login
Using the PBKDF2 encoder: Security and Speed
--------------------------------------------

.. versionadded:: 2.2
The PBKDF2 password encoder was added in Symfony 2.2.

The `PBKDF2`_ encoder provides a high level of Cryptographic security, as
recommended by the National Institute of Standards and Technology (NIST).

Expand All @@ -303,9 +300,6 @@ for the hash algorithm.
Using the BCrypt Password Encoder
---------------------------------

.. versionadded:: 2.2
The BCrypt password encoder was added in Symfony 2.2.

.. configuration-block::

.. code-block:: yaml
Expand Down
3 changes: 0 additions & 3 deletions reference/constraints/CardScheme.rst
Original file line number Diff line number Diff line change
@@ -1,9 +1,6 @@
CardScheme
==========

.. versionadded:: 2.2
The CardScheme validation is new in Symfony 2.2.

This constraint ensures that a credit card number is valid for a given credit card
company. It can be used to validate the number before trying to initiate a payment
through a payment gateway.
Expand Down
3 changes: 0 additions & 3 deletions reference/constraints/Luhn.rst
Original file line number Diff line number Diff line change
@@ -1,9 +1,6 @@
Luhn
====

.. versionadded:: 2.2
The Luhn validation is new in Symfony 2.2.

This constraint is used to ensure that a credit card number passes the `Luhn algorithm`_.
It is useful as a first step to validating a credit card: before communicating with a
payment gateway.
Expand Down
4 changes: 0 additions & 4 deletions reference/twig_reference.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,10 +17,6 @@ There may also be tags in bundles you use that aren't listed here.
Functions
---------

.. versionadded:: 2.2
The ``render`` and ``controller`` functions are new in Symfony 2.2. Prior,
the ``{% render %}`` tag was used and had a different signature.

+----------------------------------------------------+--------------------------------------------------------------------------------------------+
| Function Syntax | Usage |
+====================================================+============================================================================================+
Expand Down
0