[OE-core] [PATCH 1/2] gtk-doc: update to 1.27

[Alexander Kanavin]

On 02/07/2018 11:34 PM, Mark Asselstine wrote:
> Alexander. When things move to python you can almost always bet on them
> requiring additional libraries and as such the lack of RDEPENDS here is a bit
> surprising. As you can see from the top of some of the py files in gtk-doc we
> have:
> 
> import logging
> import os
> import re
> import subprocess
> import sys
> import six
> import codecs
> 
> Some of which are python stdlibs but others are external modules, such as
> 'six'. As such I am now getting a build failure:
> 
>       -- Installing ../../../libunique-1.1.6/doc/reference/html/up.png
>       Traceback (most recent call last):
>        File "/home/mark/build/overc/tmp/work/core2-64-overc-linux/libunique/
>        1.1.6-r7/recipe-sysroot-native/usr/bin/gtkdoc-rebase", line 28, in
>         <module>
>       from gtkdoc import common, config, rebase
>       File "/home/mark/build/overc/tmp/work/core2-64-overc-linux/libunique/
>       1.1.6-r7/recipe-sysroot-native/usr/share/gtk-doc/python/gtkdoc/
>       common.py", line 31, in <module>
>       import six
>   ImportError: No module named 'six'
> 
> So we need to RDEPENDS on "python-six" here for starters. We do have a recipe
> for python-six but it is in meta-openembedded. So we either need to move this
> recipe there or the python-six recipe to oe-core or...

Thanks for the failure report Mark, but the diagnosis is way off :-)

First of all, for what purpose are you even building libunique? It's a 
very old, unmaintained library for gtk 2.x apps from gnome stack (last 
release: 2011), and here's what gnome has to say about it: "Unique is 
now in maintenance mode and its usage is strongly discouraged".

It's coming from the gnome section of meta-oe, which is badly suffering 
from lack of maintenance and general bitrot. I think much of it was 
about to be removed a few months ago at last, but for some reason it 
hasn't happened.

This specific failure is because libunique recipe neither inherits 
gtk-doc class (which correctly sets things up) nor explicitly disables 
gtk-doc. I'm now building the rest of meta-oe to check if anything else 
needs to be fixed up, and will send a patch in a moment.

Alex