Bug 606854

Summary:	Installation of icons (doins vs. doicon, newicon)
Product:	Documentation	Reporter:	Jonas Stein <jstein>
Component:	Devmanual	Assignee:	Gentoo Devmanual Team <devmanual>
Status:	CONFIRMED ---
Severity:	normal	Keywords:	NeedPatch
Priority:	Normal
Version:	unspecified
Hardware:	All
OS:	Linux
See Also:	https://bugs.gentoo.org/show_bug.cgi?id=606848
Whiteboard:
Package list:		Runtime testing required:	---

Description Jonas Stein gentoo-dev

2017-01-22 22:29:55 UTC

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

Comment 1 Wim Muskee 2019-10-23 18:10:42 UTC

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?