Skip to content

changelog: :ref:package_env`` cannot resolve (tox target, no local label) #14818

Closed

Description

@HardMax71

The changelog entry for #13933 references :ref:package_env`` twice (doc/en/changelog.rst lines 469 and 484 at f306da7):

version string can be passed into its :ref:package_env through
the SETUPTOOLS_SCM_PRETEND_VERSION_FOR_PYTEST environment
variable as a part of the release process

package_env is a tox setting, and no label with that name exists in pytest's own docs, so the plain :ref: cannot resolve locally; the Sphinx build warns and the rendered changelog carries an unresolved reference.

Two possible fixes, whichever fits your intersphinx setup:

  • :external+tox:ref:package_env`` if tox is (or can be) in intersphinx_mapping
  • a plain link: `package_env <https://tox.wiki/en/latest/config.html#package_env>`_

Both occurrences carry the same towncrier-generated text, so one correction at the source covers both.

Found by amiss while validating its Sphinx :ref: resolution against the pytest docs tree.

Activity

  1. nightcityblade commented on Aug 1, 2026

    @nightcityblade
  2. nightcityblade commented on Aug 1, 2026

    @nightcityblade
  3. bluetech commented on Aug 3, 2026

    @bluetech
    Member

    It seems to work fine: https://docs.pytest.org/en/latest/changelog.html#packaging-updates-and-notes-for-downstreams
    Although I guess explicitly marking the ref as tox external would be slightly better.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions