Re: Problem re-building RTEMS docs

[Andrew Butterfield]

HI Sebastian,

 reading https://docs.rtems.org/branches/master/eng/vc-users.html 
 (Sec 6.1.3 Making 
Changes),
I found the following sequence that fixed things.

git checkout master
git pull
git checkout 
git rebase master

Now the documents all build, off  6.8fe0da2-modified (27th October 2020) 

- thanks for you support

Andrew

> On 3 Nov 2020, at 18:12, Andrew Butterfield  
> wrote:
> 
> Hi Sebastian,
> 
>  I thought `git submodule update` would do it -  my bad
> 
> I tried `git submodule sync`, but this still leaves me back in 3rd July 2020
> 
> Doing a `git pull`  afterwards, in rtems-docs makes no change. What do I need 
> to do to bring all the submodules up to date?
> 
> Thanks, Andrew
> 
>> On 3 Nov 2020, at 18:01, Sebastian Huber > > wrote:
>> 
>> On 03/11/2020 18:47, Andrew Butterfield wrote:
>> 
>>> $ ./waf
>>> Waf: Entering directory 
>>> `/Users/butrfeld/REPOS/rtems-central/modules/rtems-docs/build'
>>> Build: 6.0c13e94-modified (3rd July 2020)
>> 
>> This is an extremely out dated version. You should see something like this:
>> 
>> Waf: Entering directory 
>> `/home/EB/sebastian_h/src/rtems-central/modules/rtems-docs/build'
>> Build: 6.9628dfd (1st October 2020)
>> 
>> -- 
>> 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.hu...@embedded-brains.de 
>> 
>> PGP : Public key available on request.
>> 
>> Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.
>> 
> 
> 
> Andrew Butterfield Tel: +353-1-896-2517 Fax: +353-1-677-2204
> Lero@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/ 
> 
> 
> 
> ___
> devel mailing list
> devel@rtems.org
> http://lists.rtems.org/mailman/listinfo/devel


Andrew Butterfield Tel: +353-1-896-2517 Fax: +353-1-677-2204
Lero@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/


___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: Problem re-building RTEMS docs

[Andrew Butterfield]

Hi Sebastian,

 I thought `git submodule update` would do it -  my bad

I tried `git submodule sync`, but this still leaves me back in 3rd July 2020

Doing a `git pull`  afterwards, in rtems-docs makes no change. What do I need 
to do to bring all the submodules up to date?

Thanks, Andrew

> On 3 Nov 2020, at 18:01, Sebastian Huber  
> wrote:
> 
> On 03/11/2020 18:47, Andrew Butterfield wrote:
> 
>> $ ./waf
>> Waf: Entering directory 
>> `/Users/butrfeld/REPOS/rtems-central/modules/rtems-docs/build'
>> Build: 6.0c13e94-modified (3rd July 2020)
> 
> This is an extremely out dated version. You should see something like this:
> 
> Waf: Entering directory 
> `/home/EB/sebastian_h/src/rtems-central/modules/rtems-docs/build'
> Build: 6.9628dfd (1st October 2020)
> 
> -- 
> 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.hu...@embedded-brains.de
> PGP : Public key available on request.
> 
> Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.
> 


Andrew Butterfield Tel: +353-1-896-2517 Fax: +353-1-677-2204
Lero@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/


___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: Problem re-building RTEMS docs

[Andrew Butterfield]

Hi Sebatian,

sorry - a typo - the line was

. env/bin/active

as it says in the rtems-central README.md file.

I was running in the venv - I just edited out all the (env) indicators...

> On 3 Nov 2020, at 17:59, Sebastian Huber  
> wrote:
> 
> On 03/11/2020 18:47, Andrew Butterfield wrote:
> 
>> cp git-hooks/sanity-check.sh .git/hooks/pre-push
>> git submodule update
>> make env
>> env/bin/activate
> 
> This doesn't active the virtual environment. You need:
> 
> source env/bin/activate
> 
> -- 
> 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.hu...@embedded-brains.de
> PGP : Public key available on request.
> 
> Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.
> 


Andrew Butterfield Tel: +353-1-896-2517 Fax: +353-1-677-2204
Lero@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/


___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: Problem re-building RTEMS docs

[Sebastian Huber]

On 03/11/2020 18:47, Andrew Butterfield wrote:


$ ./waf
Waf: Entering directory 
`/Users/butrfeld/REPOS/rtems-central/modules/rtems-docs/build'

Build: 6.0c13e94-modified (3rd July 2020)


This is an extremely out dated version. You should see something like this:

Waf: Entering directory 
`/home/EB/sebastian_h/src/rtems-central/modules/rtems-docs/build'

Build: 6.9628dfd (1st October 2020)

--
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.hu...@embedded-brains.de
PGP : Public key available on request.

Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.

___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: Problem re-building RTEMS docs

[Sebastian Huber]

On 03/11/2020 18:47, Andrew Butterfield wrote:


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


This doesn't active the virtual environment. You need:

source env/bin/activate

--
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.hu...@embedded-brains.de
PGP : Public key available on request.

Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.

___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Re: Problem re-building RTEMS docs

[Andrew Butterfield]

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 

Re: Problem re-building RTEMS docs

[Sebastian Huber]

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 
 import sphinx_rtd_theme_rtems
   File 
"/Users/butrfeld/REPOS/rtems-central/modules/rtems-docs/common/sphinx_rtd_theme_rtems/__init__.py",
 line 9, in 
 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.hu...@embedded-brains.de
PGP : Public key available on request.

Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.

___
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel