[issue44006] symbol documentation still exists

[Julien Palard]

Julien Palard  added the comment:

Oh, it's ~unrelated, but thanks for the heads up, I overlooked a Sentry error :D

It's related to: https://github.com/python/docsbuild-scripts/issues/122, let's 
track it there.

(The visible effects are the same: the full build, reponsible for deleting the 
file is failing, while the quick (html only, not removing files) build succeed, 
so the old HTML files are kept if PDF builds are failing...)

--
resolution:  -> fixed
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue44006] symbol documentation still exists

[STINNER Victor]

STINNER Victor  added the comment:

I reopen the issue for binhex.

https://docs.python.org/dev/library/binhex.html is still there whereas 
https://github.com/python/cpython/blob/main/Doc/library/binxhex.rst is gone.

--
nosy: +vstinner
resolution: fixed -> 
status: closed -> open

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue44006] symbol documentation still exists

[Julien Palard]

Julien Palard  added the comment:

I `rm -fr 3.10` on the doc server yesterday, so it started 3.10 from scratch 
today and the file were properly removed.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue44006] symbol documentation still exists

[Ammar Askar]

Ammar Askar  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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue44006] symbol documentation still exists

[Jelle Zijlstra]

Jelle Zijlstra  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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue44006] symbol documentation still exists

[Julien Palard]

Julien Palard  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

404 Not Found

Thanks for noticing!

--
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue44006] symbol documentation still exists

[Julien Palard]

Julien Palard  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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue44006] symbol documentation still exists

[Ammar Askar]

Ammar Askar  added the comment:

Added Julien to the nosy list, looks like we might be retaining old deleted 
docs pages.

--
nosy: +ammar2, mdk

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue44006] symbol documentation still exists

[Jelle Zijlstra]

Jelle Zijlstra  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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue44006] symbol documentation still exists

[Shantanu]

Shantanu  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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue44006] symbol documentation still exists

[Jelle Zijlstra]

New submission from Jelle Zijlstra :

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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com