Bug 471388

Summary:	Please document installation policies for openrc init files, logrotate files and systemd unit files
Product:	Documentation	Reporter:	Markos Chandras (RETIRED) <hwoarang>
Component:	Devmanual	Assignee:	Gentoo Devmanual Team <devmanual>
Status:	CONFIRMED ---
Severity:	normal	CC:	aklhfex, dschridde+gentoobugs, nikoli, sam, wizardedit
Priority:	Normal
Version:	unspecified
Hardware:	All
OS:	Linux
Whiteboard:
Package list:		Runtime testing required:	---

Description Markos Chandras (RETIRED) gentoo-dev

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 gentoo-dev

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 gentoo-dev

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 archtester

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