Re: [PATCH 00/18] Complete moving media documentation to ReST format

[Mauro Carvalho Chehab <mchehab@s-opensource.com>]

Em Tue, 19 Jul 2016 16:49:16 -0600
Jonathan Corbet <corbet@lwn.net> escreveu:

> On Tue, 19 Jul 2016 11:53:19 -0300
> Mauro Carvalho Chehab <mchehab@s-opensource.com> wrote:
> 
> > So, I guess we should set the minimal requirement to 1.2.x.  
> 
> *sigh*.
> 
> I hate to do that; things are happening quickly enough with Sphinx that
> it would be nice to be able to count on a newer version.  That said, one
> of my goals in this whole thing was to make it *easier* for developers to
> generate the docs; the DocBook toolchain has always been notoriously
> difficult in that regard.  Forcing people to install a newer sphinx by
> hand is not the way to get there.
> 
> So I guess we need to make sure things work with 1.2 for now.  I'd hope
> we could push that to at least 1.3 before too long, though, once the
> community distributions are there.  I think we can be a *bit* more
> aggressive with the docs than with the kernel as a whole.

Yeah, that seems to be the right strategy, IMHO. With the patch I sent,
the media books will again build fine with 1.2.


Thanks,
Mauro