This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Column or row spanning cells are not implemented.
Type: Stage:
Components: Documentation Versions: Python 3.8
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: cheryl.sabella, docs@python, mdk, xtreak
Priority: normal Keywords:

Created on 2018-10-20 16:28 by mdk, last changed 2022-04-11 14:59 by admin.

Messages (8)
msg328159 - (view) Author: Julien Palard (mdk) * (Python committer) Date: 2018-10-20 16:28
Recent tables introduced in Doc/c-api/typeobj.rst are using columns spanning.

But columns spanning is not implemented in the sphinx text builder, resulting in:

$ cd Doc
$ sphinx-build -b text -d build/doctrees -W -D latex_elements.papersize= -Ea -A daily=1 -A switchers=1 . build/text
Running Sphinx v1.8.1
building [mo]: all of 0 po files
building [text]: all source files
updating environment: 475 added, 0 changed, 0 removed
reading sources... [100%] whatsnew/index                                                                                                           
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [ 12%] c-api/typeobj                                                                                                             
Exception occurred:
  File "/home/mdk/.venvs/mdk/lib/python3.6/site-packages/sphinx/writers/text.py", line 623, in visit_entry
    raise NotImplementedError('Column or row spanning cells are '
NotImplementedError: Column or row spanning cells are not implemented.
The full traceback has been saved in /tmp/sphinx-err-3q24uv89.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!

we could either try to remove our column spannings (but they're usefull, first table, 2nd header line), either implement it sphinx-side.
msg328160 - (view) Author: Julien Palard (mdk) * (Python committer) Date: 2018-10-20 16:40
Oh and we're also using raw spanning, in the same place, as the table header is two raws height and almost all cells but the last spans on two raws.
msg328225 - (view) Author: Julien Palard (mdk) * (Python committer) Date: 2018-10-21 23:26
Started implementing a POC sphinx-side so we may not have to "fix" our doc: https://github.com/JulienPalard/sphinx/tree/text-colspan-rowspan
msg328275 - (view) Author: Julien Palard (mdk) * (Python committer) Date: 2018-10-22 21:40
POC is now a PR: https://github.com/sphinx-doc/sphinx/pull/5559
msg328998 - (view) Author: Julien Palard (mdk) * (Python committer) Date: 2018-10-31 15:58
https://github.com/sphinx-doc/sphinx/pull/5559 has been merged, let's wait for a release of Sphinx and we'll be able to build Python 3.8 documentation as text again.
msg336581 - (view) Author: Cheryl Sabella (cheryl.sabella) * (Python committer) Date: 2019-02-25 23:54
> https://github.com/sphinx-doc/sphinx/pull/5559 has been merged, let's wait for a release of Sphinx and we'll be able to build Python 3.8 documentation as text again.

I tried running the sphinx-build command using Sphinx 1.8.4 and I got the same exception.

Running Sphinx v1.8.4
building [mo]: all of 0 po files
building [text]: all source files
updating environment: 475 added, 0 changed, 0 removed
reading sources... [100%] whatsnew/index
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [ 12%] c-api/typeobj
Exception occurred:
  File "n:\projects\cpython-venv\lib\site-packages\sphinx\writers\text.py", line 623, in visit_entry
    raise NotImplementedError('Column or row spanning cells are '
NotImplementedError: Column or row spanning cells are not implemented.
The full traceback has been saved in C:\Users\cheka\AppData\Local\Temp\sphinx-err-222wk1in.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!
msg336582 - (view) Author: Julien Palard (mdk) * (Python committer) Date: 2019-02-25 23:56
IIRC this will be released in the next major sphinx version, planned for around march.
msg336585 - (view) Author: Cheryl Sabella (cheryl.sabella) * (Python committer) Date: 2019-02-26 00:08
Apologies, I didn't realize it would be in the major version; I checked since there had been minor release versions since this ticket.  I'll check again once the major release is out.

Thanks!
History
Date User Action Args
2022-04-11 14:59:07adminsetgithub: 79214
2019-02-26 00:08:01cheryl.sabellasetmessages: + msg336585
2019-02-25 23:56:19mdksetmessages: + msg336582
2019-02-25 23:54:40cheryl.sabellasetnosy: + cheryl.sabella
messages: + msg336581
2018-10-31 15:58:55mdksetmessages: + msg328998
2018-10-22 21:40:50mdksetmessages: + msg328275
2018-10-21 23:26:40mdksetmessages: + msg328225
2018-10-20 18:50:07xtreaksetnosy: + xtreak
2018-10-20 16:40:32mdksetmessages: + msg328160
2018-10-20 16:28:35mdkcreate