Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 606854 - Installation of icons (doins vs. doicon, newicon)
Summary: Installation of icons (doins vs. doicon, newicon)
Status: CONFIRMED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Devmanual (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Gentoo Devmanual Team
URL:
Whiteboard:
Keywords: NeedPatch
Depends on:
Blocks:
 
Reported: 2017-01-22 22:29 UTC by Jonas Stein
Modified: 2020-08-28 18:48 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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?