100+ ebuilds use doins [1] instead of doicon [2] or newicon [2] to install icons. doins sounds like the proper solution on [1] where it says: "doins Install a miscellaneous file" Icons are very common. I suggest to add a short example in the manual and explain why we want to use doicon/newicon. And perhaps change ^^ to "doins Install a miscellaneous file, if there is no better solution (newicon, doicon,...)" [1] https://devmanual.gentoo.org/function-reference/install-functions/index.html [2] https://devmanual.gentoo.org/eclass-reference/eutils.eclass/ Reproducible: Always
Both doicon/newicon are now in the desktop eclass: https://devmanual.gentoo.org/eclass-reference/desktop.eclass/index.html Perhaps a list of common "includable" install functions is a good solution?