Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]
Groups > linux.debian.maint.python > #14507 > unrolled thread
| Started by | James Addison <jay@jp-hosting.net> |
|---|---|
| First post | 2022-10-02 14:30 +0200 |
| Last post | 2022-10-02 14:30 +0200 |
| Articles | 1 — 1 participant |
Back to article view | Back to linux.debian.maint.python
This discussion starts older than the indexed window; earlier articles aren't shown. The article labeled Started by
below is the oldest one visible, not the original post.
Bug#998059: sphinx: LANGUAGE environment variable inconsistently affects output of objects.inv James Addison <jay@jp-hosting.net> - 2022-10-02 14:30 +0200
| From | James Addison <jay@jp-hosting.net> |
|---|---|
| Date | 2022-10-02 14:30 +0200 |
| Subject | Bug#998059: sphinx: LANGUAGE environment variable inconsistently affects output of objects.inv |
| Message-ID | <Fc6gx-bxCQ-1@gated-at.bofh.it> |
Source: sphinx Followup-For: Bug #998059 X-Debbugs-Cc: debian-python@lists.debian.org (context: cross-posting based on an idea[1] that has been discussed upstream in sphinx's GitHub repository about how to resolve locale-based build variance) The SPHINXOPTS[2] environment variable provides a way to selectively override defined environment variables (such as LANGUAGE) in a way that should only affect sphinx (limiting the effects on unrelated build steps). For example: SPHINXOPTS='-D LANGUAGE="en_US.UTF-8"' That would allow the objects.inv file to be built in a fixed language on a per-package basis. It doesn't seem ideal to artificially limit documentation localization for affected packages, but could allow many of the affected packages to pass diffoscope reproducibility testing. Alternatives explored: I wasn't able to identify a straightforward, supported way to disable creation of the objects.inv file, nor is it currently possible to invoke a multi-locale HTML sphinx build (an approach that might permit output of monolithic documentation outputs that wouldn't vary based on build environment locale). I'll file a feature request for the former; the latter is tracked by an existing request[3]. [1] - https://github.com/sphinx-doc/sphinx/issues/9778#issuecomment-1264065231 [2] - https://github.com/sphinx-doc/sphinx/blob/v4.5.0/doc/man/sphinx-build.rst#environment-variables [3] - https://github.com/sphinx-doc/sphinx/issues/788
Back to top | Article view | linux.debian.maint.python
csiph-web