[issue44006] symbol documentation still exists

New submission from Jelle Zijlstra <jelle.zijlstra@gmail.com>: symbol is being removed in 3.10, but https://docs.python.org/3.10/library/symbol.html still exists and claims it will be removed in "future versions". It was removed in bpo-40939 / GH-21005. ---------- assignee: docs@python components: Documentation messages: 392653 nosy: Jelle Zijlstra, docs@python, lys.nikolaou priority: normal severity: normal status: open title: symbol documentation still exists versions: Python 3.10 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44006> _______________________________________

Shantanu <hauntsaninja@gmail.com> added the comment: Do you see what's generating it? As far as I can tell, the RST was removed a while ago in https://github.com/python/cpython/pull/21624 ---------- nosy: +hauntsaninja _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44006> _______________________________________

Jelle Zijlstra <jelle.zijlstra@gmail.com> added the comment: You're right, the file doesn't exist on master. I guess there must be some sort of caching. For what it's worth, I found it by going to the module documentation on an earlier version and using the dropdown to navigate to 3.10. If you go to the dataclasses docs and select a version where it doesn't exist yet (e.g., 3.6), it redirects to https://docs.python.org/3.6/. That feels like the right behavior here too. ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44006> _______________________________________

Ammar Askar <ammar@ammaraskar.com> added the comment: Added Julien to the nosy list, looks like we might be retaining old deleted docs pages. ---------- nosy: +ammar2, mdk _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44006> _______________________________________

Julien Palard <julien+python@palard.fr> added the comment: This is interesting! Also notice the footer: Last updated on Jul 26, 2020. I checked on the docsbuild server and found the `symbol.html` file was marked as modified today (probably by the build cron) (and it contains the "Last updated on Jul 26, 2020" string, yes). I think the explanation may be that Sphinx does not remove a file from the html output when it's rst counterpart is removed (which may be legitimate, Sphinx can't guess the rst was there before, so it can't distinguish if it's a human generated file that should be kept, or an old file to delete). There's however no links pointing to it (apart when switching version from 3.9 to 3.10 using the version switcher). I'm removing the files manually as is: docsbuild@docs:/srv/docsbuild/3.10$ rm cpython-*/Doc/build/html/library/symbol.html I'll let the daily cron update docs.python.org (to ensure it does the job). ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44006> _______________________________________

Julien Palard <julien+python@palard.fr> added the comment: After the cron passed, and after purging the HTTP cache, it now 404: $ curl https://docs.python.org/3.10/library/symbol.html <html> <head><title>404 Not Found</title></head> Thanks for noticing! ---------- resolution: -> fixed stage: -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44006> _______________________________________

Jelle Zijlstra <jelle.zijlstra@gmail.com> added the comment: Thanks Julien! I noticed two other libraries in the same situation: https://docs.python.org/3.10/library/formatter.html and https://docs.python.org/3.10/library/parser.html. The RST files for both are also gone from master. Could you purge the cache for them too, or would you prefer I open a new issue? ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44006> _______________________________________

Ammar Askar <ammar@ammaraskar.com> added the comment: Also, would it make sense to do a clean build (with the html output folder wiped) in the build-cron to avoid this happening in the future? ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44006> _______________________________________
participants (4)
-
Ammar Askar
-
Jelle Zijlstra
-
Julien Palard
-
Shantanu