When autotools detect that xmlto or xstlproc available then it usually doesn't check if there are working stylesheets for it, so many recipes with enabled doc/man building fail like this: http://lists.linuxtogo.org/pipermail/openembedded-devel/2011-December/037066.html or newer example: http://lists.linuxtogo.org/pipermail/openembedded-core/2012-May/021942.html would be nice to provide working xmlto-native/xsltproc-native/stylesheets-native and then enable doc/man building in recipes where we had to explicitly disable it. meta/recipes-support/libxslt/libxslt_1.1.26.bb already provides native version xmlto can be imported from meta-oe/recipes-support/xmlto/xmlto_0.0.25.bb docbook-sgml-dtd-4.3-native.bb can be imported from oe-core-contrib/jansa/test more info: http://lists.linuxtogo.org/pipermail/openembedded-devel/2011-December/037106.html
Old links to oe-devel/oe-core ML are not working anymore, here are the right ones "[oe] [PATCH v2 meta-oe 1/7] xmlto: add version 0.0.25" http://lists.openembedded.org/pipermail/openembedded-devel/2011-December/082225.html "[OE-core] [PATCHv3] xserver-xorg-lite: disable xmlto like full xserver-xorg does" http://lists.openembedded.org/pipermail/openembedded-core/2012-May/061330.html "[oe] [PATCH v2 meta-oe 1/7] xmlto: add version 0.0.25" http://lists.openembedded.org/pipermail/openembedded-devel/2011-December/082264.html Before enabling the docs we should make sure that the -native tools are fixes to look for stylesheets in sysroot and only in sysroot, because otherwise it will work for most people (stylesheets are usually installed in host distro) and especially when upgrading some recipe, people won't notice that upstream updated docs to use dtd-4.4 instead of dtd-4.3.
Test Steps: 1. vim local.conf ... IMAGE_FEATURES += "ssh-server-dropbear" PACKAGECONFIG_pn-alsa-utils = "xmlto" IMAGE_INSTALL_append = " xmlto" ... 2. bitbake alsa-utils If the build is ok, it means xmlto-native could work. 3. bitbake core-image-minimal 4. start qemu target and ssh the target 5. copy a manual source to target ssh tmp/work/i586-poky-linux/alsa-utils/1.0.27.2-r0/alsa-utils-1.0.27.2/alsactl/alsactl_init.xml root@192.168.7.2:/home/root 6. on target root@qemux86:~# xmlto man alsactl_init.xml Note: Writing alsactl_init.7 //Hongxu
Merged into master xserver-xorg.inc: add PACKAGECONFIG for xmlto Support xmlto for documentation generation and disable it by default. [YOCTO #2416] (From OE-Core rev: c2d8322b3e3d1c2cb1ed7ccff59c7e86ab7af751)