[ovs-dev] sphinx on os x on travis?

[Ben Pfaff]

On Fri, Mar 17, 2017 at 07:44:53PM -0400, Lance Richardson wrote:
> > From: "Lance Richardson" <lrichard at redhat.com>
> > To: "Ben Pfaff" <blp at ovn.org>
> > Cc: dev at openvswitch.org
> > Sent: Friday, March 17, 2017 7:39:03 PM
> > Subject: Re: sphinx on os x on travis?
> > 
> > > From: "Ben Pfaff" <blp at ovn.org>
> > > To: dev at openvswitch.org
> > > Cc: "Lance Richardson" <lrichard at redhat.com>
> > > Sent: Friday, March 17, 2017 7:09:51 PM
> > > Subject: sphinx on os x on travis?
> > > 
> > > I'm seeing failures on Travis that boil down to this:
> > > 
> > >     /home/travis/build/blp/ovs-reviews/Documentation/intro/install/documentation.rst:34:
> > >     ERROR: Error in "note" directive:
> > >     invalid option block.
> > > 
> > >     .. note::
> > >       These instructions provide information on building the documentation
> > >       locally.
> > >       For information on writing documentation, refer to
> > >       :doc:`/internals/contributing/documentation-style`
> > > 
> > > e.g. in https://travis-ci.org/blp/ovs-reviews/jobs/212266894.
> > > 
> > > Some web searches suggest this might be due to an old python-sphinx
> > > version.  Do anyone know how to make travis use a newer version?
> > > 
> > > Thanks,
> > > 
> > > Ben.
> > > 
> > 
> > I think adding "pip install --user sphinx" to .travis/osx-prepare.sh would be
> > worth
> > a try. On the machine I just did this on, version 1.5.3 was installed.
> > 
> > FWIW, "brew install sphinx" installs the other sphinx (text search software).
> > 
> >    Lance
> 
> Or perhaps "pip install --user --upgrade sphinx" (I'm not a frequent pip user).
> 
> I can give this a try, but probably not until early next week.

I tried both of those but no luck yet.

Hmm, maybe it's not the sphinx version: now I see that the log says
"running Sphinx v1.1.3".  Still there's something up with Sphinx.