make pydoc-topics fails

[JelleZijlstra]

BPO	30424
Nosy	@ezio-melotti, @JelleZijlstra, @nceder, @iritkatriel

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2022-01-25.16:07:41.411>
created_at = <Date 2017-05-21.15:42:56.376>
labels = ['3.7', 'docs']
title = 'make pydoc-topics fails'
updated_at = <Date 2022-01-25.16:07:41.410>
user = 'https://github.com/JelleZijlstra'

bugs.python.org fields:

activity = <Date 2022-01-25.16:07:41.410>
actor = 'iritkatriel'
assignee = 'docs@python'
closed = True
closed_date = <Date 2022-01-25.16:07:41.411>
closer = 'iritkatriel'
components = ['Documentation']
creation = <Date 2017-05-21.15:42:56.376>
creator = 'JelleZijlstra'
dependencies = []
files = []
hgrepos = []
issue_num = 30424
keywords = []
message_count = 3.0
messages = ['294104', '294201', '411627']
nosy_count = 5.0
nosy_names = ['ezio.melotti', 'docs@python', 'JelleZijlstra', 'NaomiCeder', 'iritkatriel']
pr_nums = []
priority = 'normal'
resolution = 'out of date'
stage = 'resolved'
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue30424'
versions = ['Python 3.7']

[JelleZijlstra]

Running make pydoc-topics in Doc/ on master fails with

$ make pydoc-topics
sphinx-build -b pydoc-topics -d build/doctrees -D latex_elements.papersize=  . build/pydoc-topics 
Running Sphinx v1.6.1
making output directory...
loading pickled environment... not yet created
building [mo]: targets for 0 po files that are out of date
building [pydoc-topics]: all pydoc topics
updating environment: 466 added, 0 changed, 0 removed
reading sources... [100%] whatsnew/index                                                                                                                                                        
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
/Users/jzijlstra-mpbt/py/venvs/venv36/lib/python3.6/site-packages/sphinx/application.py:444: RemovedInSphinx17Warning: app.status_iterator() is now deprecated. Use sphinx.util.status_iterator() instead.
  RemovedInSphinx17Warning)
/Users/jzijlstra-mpbt/py/venvs/venv36/lib/python3.6/site-packages/sphinx/application.py:425: RemovedInSphinx17Warning: app._display_chunk() is now deprecated. Use sphinx.util.display_chunk() instead.
  RemovedInSphinx17Warning)
building topics... [  1%] assert                                                                                                                                                                
Exception occurred:
  File "/Users/jzijlstra-mpbt/py/venvs/venv36/lib/python3.6/site-packages/sphinx/builders/__init__.py", line 129, in create_translator
    assert translator_class, "translator not found for %s" % self.__class__.__name__
AssertionError: translator not found for PydocTopicsBuilder
The full traceback has been saved in /var/folders/nh/ctlmlrjs6sx561k27fgn4btm0000gp/T/sphinx-err-_9ox_985.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!
make: *** [build] Error 1

I ran into this because some code in Lib/pydoc.py told me to run make pydoc-topics as part of the patch for bpo-30406.

[nceder]

This issue is related to the version of sphinx. When I tested with sphinx 1.3.6 it worked fine, but with sphinx 1.6.2 I did get the error.

[iritkatriel]

We're have minimum sphinx version set to 1.8 now, so this should no longer be an issue.