=====
NOTES
=====


To build docs (on windows)
==========================
:date: September 29, 2016

Run::

   > cd .../pathways-r-d/docs

   > sphinx-build.exe -q -c . -b html   doc/ __result/html
   Using std_conf
   ...\pathways-r-d\docs\doc\PathwaysFramework\index.rst:44: WARNING: toctree glob pattern 'apidoc/*' didn't match any documents
   ...\pathways-r-d\docs\doc\PathwaysFramework\index.rst:34: WARNING: image file not readable: PathwaysFramework\./pyreverse/classes_Pathways_Framework.svg
   ...\pathways-r-d\docs\doc\PathwaysFramework\index.rst:40: WARNING: image file not readable: PathwaysFramework\./pyreverse/packages_Pathways_Framework.svg
   ...\pathways-r-d\docs\doc\index.rst:84: WARNING: toctree contains reference to nonexisting document 'symlinks/examples.doc/index'
   ...\pathways-r-d\docs\doc\index.rst:93: WARNING: toctree contains reference to nonexisting document 'symlinks/calculators.doc.nl/index'

   # OPTIONAL: (Not needed, although some cross-links may be invalided)
   > sphinx-build.exe -q -c . -b slides doc/ __result/slides
   (Similar messages as above)


Errors, to solve
================

* BUG: Add the "external" std stuff to repro!

  - now, it a symlinks

* install sphinx extension (for docs)

  > pip install -r requirements.txt

* Symlinks 

  Images (deleted for now)

  - docs/doc/_static/Needle_Tower_doorzichtig.png
  - docs/doc/_static/SwBMnl.png

  ??

  - docs/doc/_static/exports

  For the sidebar; delete seems to solve it :-)

  - docs/_templates/globaltoc.html
  - docs/_templates/relations.html
  - docs/_templates/searchbox.html
  - docs/_templates/sourcelink.html


VerifySelenium_Firefox.py (on windows)
========================================
:date: October 7, 2017

* geckodriver-v0.9.0 works
* geckodriver-v0.10.0 **DOES NOT**. However, the TIP/message is not correct::

    $ python3 ./pathways/bin/VerifySelenium_Firefox.py  TMP/geckodriver-v0.10.0.exe
    Starting browser ...
    Selenium reported an error: Message: Service TMP/geckodriver-v0.10.0.exe unexpectedly exited. Status code was: 1
    . Possible, your url is incorrect?
    However, selenium might be working. Fix your URL to be sure