<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
span.EmailStyle17
{mso-style-type:personal-compose;
font-family:"Calibri",sans-serif;
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri",sans-serif;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="#0563C1" vlink="#954F72" style="word-wrap:break-word">
<div class="WordSection1">
<p class="MsoNormal">Hi all,<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">I’m trying to build the RTEMS Documentation, but having a problem with sphinxcontrib-bibtex. It’s been a long time since I’ve tried this, so maybe there’s a configuration problem on my end. Anyway, I’ve pulled down the rtems-docs repo
and tried to follow the instructions in the README. Installation of all the tools seems good, but running waf configure fails.
<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Thanks in advance for any advice.<o:p></o:p></p>
<p class="MsoNormal">Jeff<o:p></o:p></p>
<p class="MsoNormal"><o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">$ ./waf configure -v --pdf --singlehtml --prefix=/home/mayes/Documents/rtems<o:p></o:p></p>
<p class="MsoNormal" style="text-indent:.5in">…<o:p></o:p></p>
<p class="MsoNormal" style="text-indent:.5in">…<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in">Checking for 'sphinxcontrib.bibtex' : 11:18:46 runner ' /home/mayes/sphinx/bin/sphinx-build -b html -D extensions=sphinxcontrib.bibtex -c . . out '<o:p></o:p></p>
<p class="MsoNormal" style="text-indent:.5in">not found (see README.txt) <o:p></o:p></p>
<p class="MsoNormal" style="text-indent:.5in">The configuration failed<o:p></o:p></p>
<p class="MsoNormal" style="text-indent:.5in">(complete log in /home/mayes/rtems-docs/build/config.log)<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Here’s the relevant output from the build/config.log file:<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Checking for 'sphinxcontrib.bibtex'<o:p></o:p></p>
<p class="MsoNormal">[1/1] Processing ^[[01;34mbuild/.conf_check_4f991dacd3d42895f236eb1da8e20c9e/testbuild/contents.rst^[[0m<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">/home/mayes/sphinx/bin/sphinx-build -b html -D extensions=sphinxcontrib.bibtex -c . . out<o:p></o:p></p>
<p class="MsoNormal">out: Running Sphinx v4.0.2<o:p></o:p></p>
<p class="MsoNormal">making output directory... done<o:p></o:p></p>
<p class="MsoNormal">building [mo]: targets for 0 po files that are out of date<o:p></o:p></p>
<p class="MsoNormal">building [html]: targets for 1 source files that are out of date<o:p></o:p></p>
<p class="MsoNormal">updating environment: [new config] 1 added, 0 changed, 0 removed<o:p></o:p></p>
<p class="MsoNormal">reading sources... [100%] contents<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">err: WARNING: could not open bibtex file /home/mayes/rtems-docs/build/.conf_check_4f991dacd3d42895f236eb1da8e20c9e/testbuild/refs.bib.<o:p></o:p></p>
<p class="MsoNormal">WARNING: Since v2.0, Sphinx uses "index" as root_doc by default. Please add "root_doc = 'contents'" to your conf.py.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Extension error (sphinxcontrib.bibtex.domain):<o:p></o:p></p>
<p class="MsoNormal">Handler <function env_updated at 0x7fc4db8e6a60> for event 'env-updated' threw an exception (exception: 'index')<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">from /home/mayes/rtems-docs/user: Test does not build: Traceback (most recent call last):<o:p></o:p></p>
<p class="MsoNormal"> File "/home/mayes/rtems-docs/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Configure.py", line 333, in run_build<o:p></o:p></p>
<p class="MsoNormal"> bld.compile()<o:p></o:p></p>
<p class="MsoNormal"> File "/home/mayes/rtems-docs/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Tools/errcheck.py", line 140, in check_compile<o:p></o:p></p>
<p class="MsoNormal"> ret=self.orig_compile()<o:p></o:p></p>
<p class="MsoNormal"> File "/home/mayes/rtems-docs/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Build.py", line 176, in compile<o:p></o:p></p>
<p class="MsoNormal"> raise Errors.BuildError(self.producer.error)<o:p></o:p></p>
<p class="MsoNormal">waflib.Errors.BuildError: Build failed<o:p></o:p></p>
<p class="MsoNormal">-> task in '' failed with exit status 2:<o:p></o:p></p>
<p class="MsoNormal"> {task 140180890500232: ${BIN_SPHINX_BUILD} -b html -D extensions=sphinxcontrib.bibtex -c . . out contents.rst -> }<o:p></o:p></p>
<p class="MsoNormal">' /home/mayes/sphinx/bin/sphinx-build -b html -D extensions=sphinxcontrib.bibtex -c . . out '<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">not found (see README.txt)<o:p></o:p></p>
<p class="MsoNormal">from /home/mayes/rtems-docs/user: The configuration failed<o:p></o:p></p>
</div>
</body>
</html>