Skip to content

Commit

Permalink
Minor rewordings for the "deprecated" service option
Browse files Browse the repository at this point in the history
  • Loading branch information
javiereguiluz committed Oct 19, 2015
1 parent f4ba8f1 commit 3c37397
Showing 1 changed file with 11 additions and 13 deletions.
24 changes: 11 additions & 13 deletions components/dependency_injection/advanced.rst
Original file line number Diff line number Diff line change
Expand Up @@ -226,8 +226,7 @@ Deprecating Services
The ``deprecated`` setting was introduced in Symfony 2.8.

Once you have decided to deprecate the use of a service (because it is outdated
or you decided not to use and maintain it anymore), you can deprecate its
definition:
or you decided not to maintain it anymore), you can deprecate its definition:

.. configuration-block::

Expand Down Expand Up @@ -261,26 +260,25 @@ definition:
)
;
Now, every time a service is created using this deprecated definition, a
deprecation warning will be triggered, advising you to stop or to change your
uses of that service.
Now, every time this service is used, a deprecation warning is triggered,
advising you to stop or to change your uses of that service.

The message is actually a message template, which will replace occurrences
of the ``%service_id%`` by the service's id. You **must** have at least one
The message is actually a message template, which replaces occurrences of the
``%service_id%`` placeholder by the service's id. You **must** have at least one
occurrence of the ``%service_id%`` placeholder in your template.

.. note::

The deprecation message is optional. If not set, Symfony will show a default
message ``The "%service_id%" service is deprecated. You should stop using it,
The deprecation message is optional. If not set, Symfony will show this default
message: ``The "%service_id%" service is deprecated. You should stop using it,
as it will soon be removed.``.

.. tip::

It is strongly recommended that you fill the message template, to avoid a
message that could be too generic such as the default one. A good message
informs when this service was deprecated, and until when it will be
maintained (look at the examples above).
It is strongly recommended that you define a custom message because the
default one is too generic. A good message informs when this service was
deprecated, until when it will be maintained and the alternative services
to use (if any).

For service decorators (see above), if the definition does not modify the
deprecated status, it will inherit the status from the definition that is
Expand Down

0 comments on commit 3c37397

Please sign in to comment.