[RTEMS Project] #4915: Building sphinx 7.0.1 fails

[RTEMS trac]

#4915: Building sphinx 7.0.1 fails
--------------------------------+----------------------------------------
 Reporter:  Andrew Butterfield  |       Owner:  Utkarsh Verma <utkarsh@…>
     Type:  defect              |      Status:  closed
 Priority:  high                |   Milestone:  Indefinite
Component:  tool                |     Version:  6
 Severity:  normal              |  Resolution:  fixed
 Keywords:  sphinx              |  Blocked By:
 Blocking:                      |
--------------------------------+----------------------------------------

Comment (by Joel Sherrill <joel@…>):

 In [changeset:"13237ab34b8430760a930d456cc18ddf8e7ed55c/rtems-docs"
 13237ab/rtems-docs]:
 {{{
 #!CommitTicketReference repository="rtems-docs"
 revision="13237ab34b8430760a930d456cc18ddf8e7ed55c"
 layout.html: Revert patch forcing Spinx to >= 6.0

 Unfortunately, updating past Sphinx 5.x results in unordered bullet
 lists not formatting correctly as show in a screen capture attached
 to #4928. Revert this patch until the issue is resolved and output
 is reviewed for other potential issues.

     From: Utkarsh Verma <utkarsh at bitbanged.com>
     Date: Wed, 14 Jun 2023 05:36:26 +0000
     Subject: [PATCH] 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.

 Updates #4915.
 Updates #4928.
 }}}

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