Add pytest.freeze_includes() to reference

[beneyal]

Stumbled with that way more than I thought 😄
Fixes #4062 .

[nicoddemus]

Thanks a lot @beneyal!

[RonnyPfannschmidt]

remidns e, we need to deprecate it, it breaks entrypoint systems ^^ - all those freeze things are horribly broken and dont fix

[nicoddemus]

remidns e, we need to deprecate it, it breaks entrypoint system

I disagree, it has worked perfectly well for years for us at ESSS (which is the use case presented in the docs).

[RonnyPfannschmidt]

@nicoddemus the freezer things had years to fix the entrypoint system and they didnt, it makes it required to keep pytest internals on a legacy structure that uses plain python data instead of driving it by metadata

im not saying to remove it without having a alternative, but without a deprecation cycle its impossible to move it to a project that generates the supporting structures when its made

im happy to take part in architect something that can support pytest plugins in the long run, but for that, we still have to properly deprecate the hook

[coveralls]

Coverage increased (+0.02%) to 93.811% when pulling a5269b2 on beneyal:master into 25fe370 on pytest-dev:master.