Hi Russel,
In the mass of Python 2 stuff that ran by, did you get an error when it
tried to install Sphinx? We rely on Sphinx heavily for our generation
of html documentation, so if it isn't present then very little will
work. We aren't aware of any issues with the current build for python
2.7, but that doesn't mean we are necessarily robust in our set up. We
have taken strides to be, but there's always some use case that we
didn't think of.
For context that might help you to sort out the source of your build
issue - we build chpldoc in a homemade virtual environment that we work
within when trying to generate the output. We do this due to licensing
issues - Sphinx was the best solution available to us for handling the
html (a previous iteration of chpldoc tried to implement that stuff by
hand, which was unmaintainable in the long run), and one of Sphinx's
dependencies is under the GPL license. Since we have users that don't
want to get the GPL license imposed upon their work for various reasons,
as a compromise we have made it so that only opt-in tools like chpldoc
build with it - keeping that environment set up locked away in a virtual
environment until necessary is helpful in that regard.
Since I know via our previous correspondence that your virtual
environment set up is different than what we expect, I think this is
likely to be the source of your issue.
If sorting those build issues out is too much trouble, I believe our
text mode (chpldoc --text-only) currently does not rely on Sphinx at
all. This will not generate html output (and will thus lose the visual
appeal and handy links created by Sphinx), but it should be still usable.
Thanks,
Lydia
On 09/08/2016 12:10 AM, Russel Winder wrote:
I ran "make chpldoc" in my clone of the Git repository using master
HEAD. It did lots of stuff with Python 2 (boo hiss). I then tried to
run this on a file:
|> chpldoc factorial.chpl
Traceback (most recent call last):
File "/home/Checkouts/Git/Chapel/third-party/chpl-
venv/install/linux64/py2.7/chpl-virtualenv/bin/sphinx-build", line 10,
in <module>
from sphinx import main
ImportError: No module named 'sphinx'
error: building html output from chpldoc sphinx project
Clearly I am doing something wrong, but this isn't what I was hoping
for to happen.
------------------------------------------------------------------------------
_______________________________________________
Chapel-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/chapel-users
------------------------------------------------------------------------------
_______________________________________________
Chapel-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/chapel-users
