[OE-core] [PATCH 2/2] perf: enable man pages for 'help' functionality

[Burton, Ross]

Hi,

On 27 July 2016 at 06:02, Dengke Du <dengke.du at windriver.com> wrote:

> When using 'perf help <subcommand>', it can't find 'man' command and
> pages for
> perf.
> The perf man pages depends on the xmlto-native and asciidoc-native, so we
> just
> need to add the two packages to the DEPENDS variable and add 'man'to
> RDEPENDS_perf-doc.
>

Whilst I like the idea of supporting more documentation, and have long
wanted to integrate doxygen/gtk-doc/etc into Yocto for building SDKs with
API documentation, I'm not sure we should be making random packages depend
on tooling to always generate documentation.

What do people think of a distro feature / global environment variable for
"recipe should build the documentation"?  For perf this would mean adding
asciidoc so it can build the man pages, for GLib it would mean depending on
gtk-doc so the API docs can be generated, and so on.  But if they're not
needed then they can be disabled to improve build speeds.

Ross
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openembedded.org/pipermail/openembedded-core/attachments/20160802/a6449c9b/attachment-0002.html>