<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Jan 17, 2017 at 9:44 AM, Stavros Passas <span dir="ltr"><<a href="mailto:stavros.passas@movidius.com" target="_blank">stavros.passas@movidius.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><br><div class="gmail_quote"><div><div class="h5">On 17 January 2017 at 15:39, Joel Sherrill <span dir="ltr"><<a href="mailto:joel@rtems.org" target="_blank">joel@rtems.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote"><span class="m_-3986803788643345611gmail-">On Tue, Jan 17, 2017 at 9:30 AM, Gedare Bloom <span dir="ltr"><<a href="mailto:gedare@rtems.org" target="_blank">gedare@rtems.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On Fri, Jan 13, 2017 at 5:51 PM, Chris Johns <<a href="mailto:chrisj@rtems.org" target="_blank">chrisj@rtems.org</a>> wrote:<br>
> On 14/1/17 8:21 am, Gedare Bloom wrote:<br>
>> I was unable to compile rtems-docs (cleanly), so I have not committed<br>
>> this patch yet.<br>
><br>
> What is the problem?<br>
><br>
<br>
It appears to be a problem in my distribution's texlive / latex<br>
support I guess. I'm on an aging Ubuntu here. :)<br>
<br></blockquote></span><div>I don't recall my exact failure on CentOS and Fedora but it turned out that</div><div>they didn't package the complete TexLive contents. I ended up removing</div><div>what came with the distribution and using the TexLive master distribution.</div><div><br></div><div>The README.txt file has details.</div><div><br></div><div><a href="https://git.rtems.org/rtems-docs/tree/README.txt" target="_blank">https://git.rtems.org/rtems-do<wbr>cs/tree/README.txt</a><br></div><div><br></div><div>I can now build the docs even on CentOS 6 which is as old a distribution</div><div>as anyone should be made to use. :)</div><div><div class="m_-3986803788643345611gmail-h5"><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
$ uname -a<br>
Linux gedare-pc 3.13.0-24-generic #47-Ubuntu SMP Fri May 2 23:30:00<br>
UTC 2014 x86_64 x86_64 x86_64 GNU/Linux<br>
<br>
$ sphinx-build --version<br>
Sphinx (sphinx-build) 1.5.1<br>
<br>
$ python --version<br>
Python 2.7.6<br>
<br>
Relevant-seeming shell output below:<br>
<br>
[ 24/101] Processing<br>
/home/gedare/work/rtems/rtems-<wbr>docs/build/c-user/html/index.h<wbr>tml:<br>
c-user/barrier_manager.rst c-user/board_support_packages.<wbr>rst<br>
c-user/chains.rst c-user/clock_manager.rst<br>
c-user/<a href="http://configuring_a_system.rs" target="_blank">configuring_a_system.rs</a><wbr>t c-user/constant_bandwidth_serv<wbr>er.rst<br>
c-user/<a href="http://cpu_usage_statistics.rs" target="_blank">cpu_usage_statistics.rs</a><wbr>t c-user/directive_status_codes.<wbr>rst<br>
c-user/dual_ports_memory_manag<wbr>er.rst c-user/event_manager.rst<br>
c-user/example_application.rst c-user/fatal_error.rst<br>
c-user/glossary.rst c-user/index.rst c-user/initialization.rst<br>
c-user/interrupt_manager.rst c-user/io_manager.rst<br>
c-user/key_concepts.rst c-user/linker_sets.rst<br>
c-user/message_manager.rst c-user/multiprocessing.rst<br>
c-user/object_services.rst c-user/overview.rst<br>
c-user/partition_manager.rst c-user/pci_library.rst c-user/preface.rst<br>
c-user/rate_monotonic_manager.<wbr>rst c-user/red_black_trees.rst<br>
c-user/region_manager.rst c-user/rtems_data_types.rst<br>
c-user/scheduling_concepts.rst c-user/semaphore_manager.rst<br>
c-user/signal_manager.rst c-user/<a href="http://stack_bounds_checker.rs" target="_blank">stack_bounds_checker.rs</a><wbr>t<br>
c-user/symmetric_multiprocessi<wbr>ng_services.rst c-user/task_manager.rst<br>
c-user/timer_manager.rst c-user/timespec_helpers.rst<br>
c-user/user_extensions.rst -> build/c-user/html/index.html<br>
16:19:18 runner ' /usr/local/bin/sphinx-build -Q -b html -c . -d<br>
/home/gedare/work/rtems/rtems-<wbr>docs/build/c-user/doctrees/htm<wbr>l .<br>
/home/gedare/work/rtems/rtems-<wbr>docs/build/c-user/html '<br>
/usr/local/lib/python2.7/dist-<wbr>packages/sphinx/util/requests.<wbr>py:33:<br>
UserWarning: Some links may return broken results due to being unable<br>
to check the Server Name Indication (SNI) in the returned SSL cert<br>
against the hostname in the url requested. Recommended to install<br>
"requests[security]" as a dependency or upgrade to a python version<br>
with SNI support (Python 3 and Python 2.7.9+).<br>
  'Some links may return broken results due to being unable to '<br>
<br>
Exception occurred:<br>
  File "/usr/local/lib/python2.7/dist<wbr>-packages/sphinx/writers/latex<wbr>.py",<br>
line 366, in __init__<br>
    self.sectionnames.index(builde<wbr>r.config.latex_toplevel_sectio<wbr>ning)<br>
ValueError: 'parts' is not in list<br>
The full traceback has been saved in /tmp/sphinx-err-sQHg09.log, if<br>
you want to report the issue to the developers.<br>
Please also report this if it was a user error, so that a better error<br>
message can be provided next time.<br>
A bug report can be filed in the tracker at<br>
<<a href="https://github.com/sphinx-doc/sphinx/issues" rel="noreferrer" target="_blank">https://github.com/sphinx-doc<wbr>/sphinx/issues</a>>. Thanks!<br>
<br>
Above warning and exception repeat 3 more times.<br></blockquote></div></div></div></div></div></blockquote><div><br></div><div><br></div></div></div><div>I've seen this issue, it was caused by latex_use_parts and was causing sphinx to crash.</div><div>It has been fixed by <a href="https://github.com/sphinx-doc/sphinx/commit/12096b3b863f40d10fce94e03abc4b8d3f856eb1" target="_blank">https://github.com/sphinx-doc/<wbr>sphinx/commit/<wbr>12096b3b863f40d10fce94e03abc4b<wbr>8d3f856eb1</a></div><div>thus, I would either try to update sphinx, or if you feel brave enough you could manually patch sphinx, which should theoretically fix this issue too. </div><div><div class="h5"><div><br></div></div></div></div></div></div></blockquote><div><br></div><div>I recall having issues that Chris didn't when I fetched the master instead of using</div><div>the released version.</div><div><br></div><div>I did just install it in my home directory and prepend things to my PATH. The</div><div>README.txt for CentOS and Fedora is what I had to do.</div><div><br></div><div>The required tools seem to either be too new to be right in distributions or </div><div>too poorly packaged to build our documents.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div><div class="h5"><div></div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div><div class="m_-3986803788643345611gmail-h5"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
Traceback from /tmp/sphinx-err-sQHg09.log<br>
<br>
Traceback (most recent call last):<br>
  File "/usr/local/lib/python2.7/dist<wbr>-packages/sphinx/cmdline.py",<br>
line 296, in main<br>
    app.build(opts.force_all, filenames)<br>
  File "/usr/local/lib/python2.7/dist<wbr>-packages/sphinx/application.p<wbr>y",<br>
line 333, in build<br>
    self.builder.build_update()<br>
  File "/usr/local/lib/python2.7/dist<wbr>-packages/sphinx/builders/__in<wbr>it__.py",<br>
line 246, in build_update<br>
    self.build(['__all__'], to_build)<br>
  File "/usr/local/lib/python2.7/dist<wbr>-packages/sphinx/builders/__in<wbr>it__.py",<br>
line 322, in build<br>
    self.write(docnames, list(updated_docnames), method)<br>
  File "/usr/local/lib/python2.7/dist<wbr>-packages/sphinx/builders/late<wbr>x.py",<br>
line 130, in write<br>
    docwriter.write(doctree, destination)<br>
  File "/usr/local/lib/python2.7/dist<wbr>-packages/docutils/writers/__i<wbr>nit__.py",<br>
line 80, in write<br>
    self.translate()<br>
  File "/usr/local/lib/python2.7/dist<wbr>-packages/sphinx/writers/latex<wbr>.py",<br>
line 159, in translate<br>
    visitor = self.translator_class(self.doc<wbr>ument, self.builder)<br>
  File "/usr/local/lib/python2.7/dist<wbr>-packages/sphinx/writers/latex<wbr>.py",<br>
line 366, in __init__<br>
    self.sectionnames.index(builde<wbr>r.config.latex_toplevel_sectio<wbr>ning)<br>
ValueError: 'parts' is not in list<br>
______________________________<wbr>_________________<br>
devel mailing list<br>
<a href="mailto:devel@rtems.org" target="_blank">devel@rtems.org</a><br>
<a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer" target="_blank">http://lists.rtems.org/mailman<wbr>/listinfo/devel</a><br>
</blockquote></div></div></div><br></div></div>
<br>______________________________<wbr>_________________<br>
devel mailing list<br>
<a href="mailto:devel@rtems.org" target="_blank">devel@rtems.org</a><br>
<a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer" target="_blank">http://lists.rtems.org/mailman<wbr>/listinfo/devel</a><br></blockquote></div></div></div><br></div></div>
</blockquote></div><br></div></div>