Skip to content

[Contracts] [PHPUnitBridge] Document the "symfony/deprecation-contracts" #14669

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

Merged
merged 1 commit into from
Dec 8, 2020

Conversation

noniagriconomie
Copy link
Contributor

When reading this doc, I remembered this package, i think it can be useful to document it here

@carsonbot carsonbot added this to the 4.4 milestone Dec 7, 2020
@noniagriconomie noniagriconomie changed the title Update phpunit_bridge.rst [PHPUnitBridge] Document the "symfony/deprecation-contracts" Dec 7, 2020
@@ -165,6 +165,9 @@ Deprecation notices can be triggered by using::

@trigger_error('Your deprecation message', E_USER_DEPRECATED);

You can also require the `symfony/deprecation-contracts` that provide the global
function `trigger_deprecation()` for this usage.
Copy link
Contributor

@OskarStark OskarStark Dec 8, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
function `trigger_deprecation()` for this usage.
``trigger_deprecation()`` function for this usage.

I would rather use:

:method:`\Symfony\........::trigger_deprecation`

here

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

let me find an example in the codebase @OskarStark :)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hum in fact there is no namespace etc, it is a global func, so what path should i write?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Lets keep it like this then, thanks!

@carsonbot carsonbot changed the title [PHPUnitBridge] Document the "symfony/deprecation-contracts" [Contracts] [PHPUnitBridge] Document the "symfony/deprecation-contracts" Dec 8, 2020
@OskarStark
Copy link
Contributor

Thank you Antoine.

@OskarStark OskarStark merged commit 223828a into symfony:4.4 Dec 8, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants