docs-rst: conf.py: only setup notice box colors if Sphinx < 1.6
authorMauro Carvalho Chehab <mchehab@s-opensource.com>
Sun, 3 Sep 2017 19:12:46 +0000 (16:12 -0300)
committerJonathan Corbet <corbet@lwn.net>
Fri, 8 Sep 2017 16:02:44 +0000 (10:02 -0600)
commit9fdcd6afd8990889aeebcfa93ef79b402cdeb8a3
treeb7d6998c063989f169017568905ccd3b7e0e74f0
parentc4b326e1a6b40ee403d37acd1363ade36e9b6fbe
docs-rst: conf.py: only setup notice box colors if Sphinx < 1.6

Sphinx 1.5 added a new way to change backward colors for note
boxes, but kept backward compatibility with 1.4. On Sphinx 1.6,
the old way stopped working, in favor of a new less hackish
way.

Unfortunately, this is currently too buggy to be used, and
the old way doesn't work anymore. So, we have no option but
to stick with boring notice boxes.

One example of such bug is the notice that it is inside
struct v4l2_plane, at the "bytesused" field.

At least, add a notice about how to use, as maybe some day
the bug will vanish.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/conf.py