The make_desktop_entry helper function from eutils eclass is mentioned in Gentoo Ebuild How-to (http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&chap=1#doc_chap2) and is used in many ebuilds. eutils.eclass file also contains some sort of informal description for the function. However, it lacks proper eclass-to-man-style formatting, which prevents it from being displayed on eutils.eclass manpage. Incidentally, it's the only intended-for-public-use function from that file, that lacks such formatting.
Steps to Reproduce:
1. emerge app-portage/eclass-manpages, if necessary (that will generate man documentation from /usr/portage/eclass/*.eclass files)
2. open "man eutils.eclass"
Man page for eutils.eclass is properly opened, but description of make_desktop_entry function is nowhere to be seen.
Man page for eutils.eclass should exist and contain description of make_desktop_entry function.
Created attachment 271567 [details, diff]
Proposed documentation fix for eutils.eclass
I've taken description of make_desktop_entry from Gentoo Ebuild How-to (except for differing description of the 5th argument, which is out-of-date there), and added proper eclass-to-man formatting.
Alex, I am sorry to see that your bug report was ignored. A developer noticed the same problem you did but filed a duplicate report. This did thankfully get actioned, so the incorrect text is no longer in the portage tree.
The fixing commit was:
03 Jan 2012; Justin Lecher <firstname.lastname@example.org> eutils.eclass:
Convert make_desktop_entry() comment block to be eclass-manpages conform,
So whilst your report was first, I shall mark it as a duplicate so our records are correct.
*** This bug has been marked as a duplicate of bug 397451 ***