[RTEMS Project] #4229: conf.py files need updated for sphinxcontrib-bibtex ver. 2.0.0 and greater

[RTEMS trac]

#4229: conf.py files need updated for sphinxcontrib-bibtex ver. 2.0.0 and greater
------------------------+--------------------
  Reporter:  Ryan Long  |      Owner:  (none)
      Type:  defect     |     Status:  new
  Priority:  normal     |  Milestone:  6.1
 Component:  doc        |    Version:  6
  Severity:  normal     |   Keywords:
Blocked By:             |   Blocking:
------------------------+--------------------
 I followed the instructions in the README, but I still ran across this
 error. I was able to get around it by specifying the version
 ofsphinxcontrib-bibtex to be 1.0.0. This fix might probably needs to be
 applied to the 5 release branch as well.

 **Command line output**
 {{{
 Checking for 'sphinxcontrib.bibtex'      : not found (see README.txt)
 The configuration failed
 (complete log in /home/rlong/nta-workspace/nta-docs/build/config.log)
 }}}

 **Output in ${TOP}/build/config.log**
 {{{
 err: WARNING: Since v2.0, Sphinx uses "index" as master_doc by default.
 Please add "master_doc = 'contents'" to your conf.py.

  found
  ----------------------------------------
  Checking for 'sphinxcontrib.bibtex'
  [1/1] Processing
 ^[[01;34mbuild/.conf_check_70571fadfd25a3c4e29a4087f18cfa38/testbuild/contents.rst^[[0m

   /home/rlong/nta-workspace/nta-docs/sphinx/bin/sphinx-build -b html -D
 extensions=sphinxcontrib.bibtex -C . out
  out: Running Sphinx v3.4.3
  making output directory... done

  err:
  Extension error:
  You must configure the bibtex_bibfiles setting

  from /home/rlong/nta-workspace/nta-docs/user: Test does not build:
 Traceback (most recent call last):
    File "/home/rlong/nta-workspace/nta-
 docs/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Configure.py",
 line 333, in run_build
      bld.compile()
    File "/home/rlong/nta-workspace/nta-
 docs/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Build.py", line
 176, in compile
      raise Errors.BuildError(self.producer.error)
  waflib.Errors.BuildError: Build failed
   -> task in '' failed with exit status 2 (run with -v to display more
 information)
 not found (see README.txt)
 from /home/rlong/nta-workspace/nta-docs/user: The configuration failed
 }}}

--
Ticket URL: <http://devel.rtems.org/ticket/4229>
RTEMS Project <http://www.rtems.org/>
RTEMS Project