Thanks,

I am using Yocto 1.9/2.0 and a quick grep doesn't seems to indicate support for 
this DISTRO_FEATURE.

In my case, the package I care about all use CMake and have a similar structure

        /CMakeLists.txt # A dev doc target exists here
        /doc
                /CMakeLists.txt
                /Doxyfile.in

As such, I can have a single script to handle them, using "make devdoc".  I may 
not be able to push this upstream but I'll see what I can do.

Maybe the "target" to build doc could be per-recipe.  

--
Yannick Koehler

-----Message d'origine-----
De : Alexander Kanavin [mailto:[email protected]] 
Envoyé : 21 novembre 2017 04:56
À : Koehler, Yannick <[email protected]>; [email protected]
Objet : Re: [yocto] Generating Package/Image Developer Documentation

On 11/20/2017 09:53 PM, Koehler, Yannick wrote:
>    The image would then install those documentation in the sysroot under some 
> folder, maybe /usr/share/devdoc/<packagename>/ and potentially create a 
> tarball of this documentation.
> 
>     Anyway, let me know if something similar pre-exists or if such a project 
> has been started somehow please, as I would like to contribute/participate.


Yes. Add "api-documentation" to DISTRO_FEATURES and you will get manpages and 
gtk-doc based documentation generated, packaged and added to SDKs. It will slow 
down the build significantly, so use with care.

I considered adding doxygen support as well, but generating and installing that 
needs to be hand-crafted for each recipe, and so it wasn't done. You are 
welcome to work on that, subject to api-documentation being enabled. I have a 
recipe for doxygen itself here:

http://git.yoctoproject.org/cgit/cgit.cgi/poky-contrib/log/?h=akanavin/enable-doxygen

Alex
-- 
_______________________________________________
yocto mailing list
[email protected]
https://lists.yoctoproject.org/listinfo/yocto

Reply via email to