Problem re-building RTEMS docs

Tue Nov 3 17:47:34 UTC 2020

Hi Sebastian,

 I went back up to rtems-central and started over 

cp git-hooks/sanity-check.sh .git/hooks/pre-push
git submodule update
make env
env/bin/activate
cd modules/rtems-docs/

I made more progress, being able to complete ./waf configure

$ ./waf configure
Setting top to                           : /Users/butrfeld/REPOS/rtems-central/modules/rtems-docs 
Setting out to                           : /Users/butrfeld/REPOS/rtems-central/modules/rtems-docs/build 
Checking for program 'git'               : /usr/local/bin/git 
Checking for program 'sphinx-build'      : /Users/butrfeld/REPOS/rtems-central/env/bin/sphinx-build 
Checking for program 'aspell'            : /usr/local/bin/aspell 
Checking if Sphinx is at least 1.3       : yes (3.0) 
Checking Sphinx Options                  : none 
Checking Sphinx Nit-Pick mode            : no 
Checking for 'sphinx.ext.autodoc'        : found 
Checking for 'sphinx.ext.coverage'       : found 
Checking for 'sphinx.ext.doctest'        : found 
Checking for 'sphinx.ext.graphviz'       : found 
Checking for 'sphinx.ext.intersphinx'    : found 
Checking for 'sphinx.ext.mathjax'        : found 
Checking for 'sphinxcontrib.bibtex'      : found 
'configure' finished successfully (5.133s)

However, ./waf failed 

$ ./waf          
Waf: Entering directory `/Users/butrfeld/REPOS/rtems-central/modules/rtems-docs/build'
Build: 6.0c13e94-modified (3rd July 2020)
[1/4] Compiling common/_static/my-styles.css
[2/4] Compiling common/_static/favicon.ico
[3/4] Compiling common/_static/style.css
[4/4] Compiling common/_static/logo.png
[5/5] Compiling common/_templates/layout.html
[ 6/10] Processing /Users/butrfeld/REPOS/rtems-central/modules/rtems-docs/build/user/html/index.html: user/bsps/arm/altera-cyclone-v.rst user/bsps/arm/atsam.rst user/bsps/arm/beagle.rst user/bsps/arm/bsp-csb337.rst user/bsps/arm/bsp-stm32f4.rst user/bsps/arm/csb336.rst user/bsps/arm/edb7312.rst user/bsps/arm/gumstix.rst user/bsps/arm/imx.rst user/bsps/arm/lm3s69xx.rst user/bsps/arm/lpc176x.rst user/bsps/arm/lpc24xx.rst user/bsps/arm/raspberrypi.rst user/bsps/arm/realview-pbx-a9.rst user/bsps/arm/rtl22xx.rst user/bsps/arm/smdk2410.rst user/bsps/arm/tms570.rst user/bsps/arm/xen.rst user/bsps/arm/xilinx-zynq.rst user/bsps/arm/xilinx-zynqmp.rst user/bsps/bsps-aarch64.rst user/bsps/bsps-arm.rst user/bsps/bsps-bfin.rst user/bsps/bsps-epiphany.rst user/bsps/bsps-i386.rst user/bsps/bsps-lm32.rst user/bsps/bsps-m68k.rst user/bsps/bsps-microblaze.rst user/bsps/bsps-mips.rst user/bsps/bsps-moxie.rst user/bsps/bsps-nios2.rst user/bsps/bsps-or1k.rst user/bsps/bsps-powerpc.rst user/bsps/bsps-riscv.rst user/bsps/bsps-sh.rst user/bsps/bsps-sparc.rst user/bsps/bsps-sparc64.rst user/bsps/bsps-v850.rst user/bsps/bsps-x86_64.rst user/bsps/index.rst user/exe/debugging.rst user/exe/device-tree.rst user/exe/executables.rst user/exe/execution.rst user/exe/index.rst user/exe/initialization.rst user/exe/loader.rst user/glossary/index.rst user/hardware/architectures.rst user/hardware/index.rst user/hardware/targets.rst user/hardware/tiers.rst user/hosts/index.rst user/hosts/macos.rst user/hosts/os.rst user/hosts/posix.rst user/hosts/windows.rst user/index.rst user/installation/developer.rst user/installation/index.rst user/installation/kernel.rst user/installation/project-sandboxing.rst user/installation/releases.rst user/migration/index.rst user/migration/v4_11-to-v5.rst user/overview/index.rst user/rsb/bug-reporting.rst user/rsb/commands.rst user/rsb/configuration.rst user/rsb/cross-canadian-cross.rst user/rsb/deployment.rst user/rsb/history.rst user/rsb/index.rst user/rsb/project-sets.rst user/rsb/third-party-packages.rst user/rsb/why-build-from-source.rst user/start/app.rst user/start/bootstrap.rst user/start/bsp-build.rst user/start/bsp-test.rst user/start/gsoc.rst user/start/index.rst user/start/prefixes.rst user/start/preparation.rst user/start/rsb-packages.rst user/start/sources.rst user/start/tools.rst user/support/bugs.rst user/support/contrib.rst user/support/index.rst user/support/support-commercial.rst user/support/support-project.rst user/testing/configuration.rst user/testing/consoles.rst user/testing/coverage.rst user/testing/gdb-jtag.rst user/testing/index.rst user/testing/simulation.rst user/testing/tests.rst user/testing/tftp.rst user/tools/boot-image.rst user/tools/bsp-builder.rst user/tools/exeinfo.rst user/tools/index.rst user/tools/linker.rst user/tools/symbols.rst user/tools/tester.rst user/tools/tftp-proxy.rst user/tracing/captureengine.rst user/tracing/eventrecording.rst user/tracing/examples.rst user/tracing/index.rst user/tracing/introduction.rst user/tracing/tracelinker.rst -> build/user/html/index.html
[ 7/10] Compiling common/_static/favicon.ico
[ 8/10] Compiling common/_static/my-styles.css
[ 9/10] Compiling common/_static/logo.png
[10/10] Compiling common/_static/style.css

Extension error:
Could not import extension rtemsdomain (exception: cannot import name 'l_' from 'sphinx.locale' (/Users/butrfeld/REPOS/rtems-central/env/lib/python3.8/site-packages/sphinx/locale/__init__.py))

Waf: Leaving directory `/Users/butrfeld/REPOS/rtems-central/modules/rtems-docs/build'
Build failed
 -> task in '/Users/butrfeld/REPOS/rtems-central/modules/rtems-docs/build/user/html/index.html' failed with exit status 2 (run with -v to display more information)

ANy ideas?

Note that I can run  Sphinx based document builds in the ESA gitlab folders without any difficulties, and no virtual envs.

Regards, Andrew

> On 3 Nov 2020, at 16:10, Sebastian Huber <sebastian.huber at embedded-brains.de> wrote:
> 
> On 03/11/2020 17:00, Andrew Butterfield wrote:
> 
>>  I am trying to edit RTEMS docs to fix an error regarding large comments (ticket #4163).
>> 
>> I'm working out of the rtems-doc submodule of rtems-central,
>> and following instructions in the Soft Eng manual (6.1 Soft Devpt (Git users)
>> 
>> I have created a branch and edited rtems-docs/eng/coding-80cols.rts
>> 
>> Before creating/emailing patches, I want to rebuild the eng document.
>> 
>> However ./waf configure fails in rtems-docs
>> 
>> :- ./waf configure
>> Waf: The wscript in '/Users/butrfeld/REPOS/rtems-central/modules/rtems-docs' is unreadable
>> Traceback (most recent call last):
>> ... stuff deleted
>>   File "/Users/butrfeld/REPOS/rtems-central/modules/rtems-docs/common/conf.py", line 86, in <module>
>>     import sphinx_rtd_theme_rtems
>>   File "/Users/butrfeld/REPOS/rtems-central/modules/rtems-docs/common/sphinx_rtd_theme_rtems/__init__.py", line 9, in <module>
>>     import sphinx
>> ImportError: No module named sphinx
>> 
>> I tried messing around with python/pip versions, virtual environments,
>> and using pip(3) to re-install sphinx and sphinxcontrib-bibtex.
>> 
>> Pip can see these packages - why can't waf?
> 
> This is strange. I use the virtual environment of rtems-central to build the docs. Did you activate the virtual environment? What is the output of
> 
> which python
> 
> ?
> 
> -- 
> Sebastian Huber, embedded brains GmbH
> 
> Address : Dornierstr. 4, D-82178 Puchheim, Germany
> Phone   : +49 89 189 47 41-16
> Fax     : +49 89 189 47 41-09
> E-Mail  : sebastian.huber at embedded-brains.de
> PGP     : Public key available on request.
> 
> Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.
> 
> _______________________________________________
> devel mailing list
> devel at rtems.org
> http://lists.rtems.org/mailman/listinfo/devel

--------------------------------------------------------------------
Andrew Butterfield     Tel: +353-1-896-2517     Fax: +353-1-677-2204
Lero at TCD, Head of Software Foundations & Verification Research Group
School of Computer Science and Statistics,
Room G.39, O'Reilly Institute, Trinity College, University of Dublin
                         http://www.scss.tcd.ie/Andrew.Butterfield/
--------------------------------------------------------------------

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/devel/attachments/20201103/7029e992/attachment-0001.html>