geckon01/Twig
1
0
Fork 0
mirror of https://github.com/twigphp/Twig.git synced 2026-08-31 20:47:28 +00:00
Code Issues Packages Projects Releases Wiki Activity

Fix docs about the deprecated tag

Browse Source
This commit is contained in:
Fabien Potencier
2022-03-26 11:37:03 +01:00
parent 28bec2f1ff
commit 17142af9f8
1 changed files with 10 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/tags/deprecated.rst
+10 -8
View File
@@ -14,18 +14,20 @@ PHP function) where the ``deprecated`` tag is used in a template:
{% deprecated 'The "base.twig" template is deprecated, use "layout.twig" instead.' %}
{% extends 'layout.twig' %}
Also you can deprecate a block in the following way:
You can also deprecate a macro in the following way:
.. code-block:: twig
{% block hey %}
{% deprecated 'The "hey" block is deprecated, use "greet" instead.' %}
{{ block('greet') }}
{% endblock %}
{% macro welcome(name) %}
{% deprecated 'The "welcome" macro is deprecated, use "hello" instead.' %}
{% block greet %}
Hey you!
{% endblock %}
...
{% endmacro %}
Note that by default, the deprecation notices are silenced and never displayed nor logged.
See :ref:`deprecation-notices` to learn how to handle them.
.. note::
Don't use the ``deprecated`` tag to deprecate a ``block`` as the
deprecation cannot always be triggered correctly.