The help for perf subcommands that a user gets when using 'perf <subcommand> help' relies on manpage support for those subcommands. Support for 'man' isn't installed by default - we should add a dependency to add manpage support when perf is included in an image. root@crownbay:~# perf help record Warning: failed to exec 'man': No such file or directory Fatal: no man viewer handled the request
I assume we'll make this optional on a flag somehow ? (sort of like the script support). I'm just thinking that some small images might want perf, but not man and it's dependencies .. but maybe it's really small and wouldn't make a difference.
Well, the manpages are pretty extensive so I wouldn't call them small, though I kind of assumed that images that included perf meant -sdk images mainly, where it wouldn't be much of an issue. But it wouldn't be a big deal to add an option that turned it off if - the fact that it you're mentioning it means it's likely to be important to someone, so let's consider such a flag as part of fixing this.
I just had a quick look at this in case it was trivial to at least get the man pages into perf-doc. It won't work out of the box: we'd need to copy (at least) xmlto from meta-oe, and add a recipe for asciidoc.
Minor update - we do at least have xmlto in OE-Core as of recently.
This is because that the help man pages of perf depends on the asciidoc tools. Steps: 1. Add the recipe for asciidoc. 2. Add the RDEPENDS_${PN}-doc += "man" for perf recipe. 3. Add the DEPENDS += "xmlto-native asciidoc-native" Explain: The first make sure the asciidco tools exist. The second make sure the man command when using 'perf help <subcommand>' The third make sure the man pages's correct produce.
Can this bug be closed? The documentation still refers to it, and I would like to remove the reference to it... Thanks in advance Michael.
Re-opening this bug. When I add "perf" to the image and its "manpages" feature to local.conf: IMAGE_INSTALL_append = " perf" PACKAGECONFIG_append_pn-perf = " manpages" Then I build core-image-minimal: bitbake core-image-minimal However, I still don't get the expected behaviour: root@qemux86-64:~# perf help record failed to exec 'man': No such file or directoryno man viewer handled the request But do we really want to add manpages to the image? We could also drop this idea. What do you think?
Reset the default assigned as dengke.du@windriver.com doesn't seem to be active any more. Also added that a documentation change is needed (because this bug is referred to in the documentation)
Did you add "api-documentation" to DISTRO_FEATURES? See manpages.bbclass
See Richards question
Just tried to add: DISTRO_FEATURES_append = " api-documentation" But getting the exact same error. Thanks for your help!
Still stuck here, help appreciated. Thanks in advance Michael.
I can have a look at this later in August (I'm heading on vacation), and confirm whether we can get this working, or just close the bug.
Great, thanks Bruce!
Shouldn't this be: IMAGE_INSTALL_append = " perf-doc" ?
I confirmed that the configuration that makes this work is: IMAGE_INSTALL_append = " perf perf-doc" DISTRO_FEATURES_append = " api-documentation"
I confirm that this solution works. I can close this bug and update the documentation. Many thanks!