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

[Lance Richardson]

----- Original Message -----
> From: "Ben Pfaff" <blp at ovn.org>
> To: "Lance Richardson" <lrichard at redhat.com>
> Cc: dev at openvswitch.org
> Sent: Friday, March 17, 2017 10:08:38 PM
> Subject: Re: sphinx on os x on travis?
> 
> 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.
> 

Maybe I'm misreading, but for this one it seems the OSX build passed
but the first Ubuntu build failed with a similar error to the one above:

https://travis-ci.org/blp/ovs-reviews/builds/212345029

I can take a deeper look in the morning.

   Lance