-
-
Notifications
You must be signed in to change notification settings - Fork 2.1k
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
singlehtml: deprecate the 'fix_refuris' helper function #13037
singlehtml: deprecate the 'fix_refuris' helper function #13037
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Remember to add new deprecations to doc/extdev/deprecated.rst
.
A
…-uri-resolution Conflicts: sphinx/builders/singlehtml.py
Although I'm fairly keen to merge this, and think it should be safe -- maybe I'll take one more self-review pass (and/or try some builds of external |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Our deprecation policy calls for two major releases. Any reason to expidite this one?
A
Nope, this can wait until Sphinx 10 - oddly I think I configured that originally; I can't remember why I reset that to Sphinx 9. |
Co-authored-by: Adam Turner <[email protected]>
Feature or Bugfix
Purpose
singlehtml
builder helper method that I believe should be redundant since 🐛 Fix singlehtml target uris to be same-document references #11970 and singlehtml: Use same-document hyperlinks for internal project references #12551 are in place, but that might, perhaps, be re-used by other functionality (extensions / codebases).Detail
sphinx.builders.singlehtml.SingleFileHTMLBuilder.fix_refuris
method, and adds a warning noting that it's planned for removal in Sphinx 9 (the next major version).Relates
Edit: update description: this PR removes calls to the method, so don't imply that this is deprecation of already-unused code.