Bug 471388 – Please document installation policies for openrc init files, logrotate files and systemd unit files

• Status: CONFIRMED
• Product: Documentation

[Description Markos Chandras (RETIRED) 2013-05-27 09:07:35 UTC]

This is a matter of documenting already-made decisions so new and old developers can be aware of that


OpenRC init:
- Always install them

Logrotate files:
- Always install them. *NO* use flag

Systemd unit:
- Always install them if they are provided upstream. At maintainers discretion if there is no unit file upstream. If a maintainer wants to add support but he can't test the changes, CC the systemd team. Users/devs can opt-out installing these files using INSTALL_MASK.

[Comment 1 Pacho Ramos 2013-05-27 18:54:00 UTC]

I guess, a note telling that, in general, USE flags for controlling installation of one kind of file is discouraged (for example, I think we now opt for not controlling bash-completion files installations using USE flags)

[Comment 2 William Hubbs 2013-05-29 00:32:56 UTC]

What about zsh completions? We install them with a use flag in several
places in the tree.

[Comment 3 Sam James 2022-03-01 10:05:19 UTC]

QA policy guide covers this at least: https://projects.gentoo.org/qa/policy-guide/installed-files.html#pg0301