[RTEMS Project] #4928: Upgrade Version of Sphinx to 7

RTEMS trac trac at rtems.org
Thu Jul 20 14:46:52 UTC 2023


#4928: Upgrade Version of Sphinx to 7
-------------------------+---------------------
 Reporter:  Chris Johns  |       Owner:  (none)
     Type:  defect       |      Status:  new
 Priority:  normal       |   Milestone:  6.1
Component:  doc          |     Version:  6
 Severity:  normal       |  Resolution:
 Keywords:               |  Blocked By:
 Blocking:               |
-------------------------+---------------------

Comment (by Joel Sherrill):

 I think Kinsey has Sphinx 5 installed (he's off this week) and it formats
 incorrectly also. This is the commit (https://git.rtems.org/rtems-
 docs/commit/?id=4c87f9b594217786cabc84ba4d734383234e6d14) that made the
 change.


 {{{
 eng: Fix builds for newer Sphinx versions (>=7)
 The current Sphinx theme depends on the `style` parameter which got
 deprecated in v5.1 and finally got removed in v7. Now, the `styles` key
 should be preferred which is a list of stylesheets. This commit
 implements this change.

 Closes #4915
 }}}

 I'll install Sphinx 5 and report back. If this addresses the problem, then
 the waf checks for version need updating and wherever we discuss the
 tooling for documentation needs updating.

--
Ticket URL: <http://devel.rtems.org/ticket/4928#comment:5>
RTEMS Project <http://www.rtems.org/>
RTEMS Project


More information about the bugs mailing list