Gentoo Archives: gentoo-dev

From: "Michał Górny" <mgorny@g.o>
To: gentoo-dev-announce@l.g.o
Cc: gentoo-dev@l.g.o
Subject: [gentoo-dev] [QA] Official support for migrating ebuilds out of games.eclass
Date: Wed, 29 Jun 2016 17:11:47
Message-Id: 20160629191121.4889dafd.mgorny@gentoo.org
1 Hello, everyone.
2
3 Over half a year has passed since Council decided upon the fate of
4 games in Gentoo. Over that period, the games team has neither showed
5 any will to respect the Council decisions, nor officially appealed to
6 them.
7
8 For this reason, the QA team would like to officially start supporting
9 the migration of ebuilds out of games.eclass. Any developer wishing to
10 help is more than welcome to take any games.eclass ebuild, bump its
11 revision and remove the games.eclass-specific bits from it. Updating to
12 EAPI 6 would also be welcome. A short update guide is provided at
13 the end of mail.
14
15 Please note that since this is considered a matter of QA action with
16 a long waiting period, no explicit approval from games team is
17 necessary to commit the conversion, nor games team is allowed to reject
18 or revert such commits as long as they are valid.
19
20 If you need any help doing that and the games team refuses to provide
21 it, please do not hesitate to contact me or ask in #gentoo-qa. If you
22 are interested in helping out with games, feel free to join games team
23 since it still lacks new members.
24
25 Thank you for all the help.
26
27
28 Migration notes
29 ---------------
30
31 TL;DR: nothing special required, remove games.eclass and all
32 unnecessary games.eclass customization, and follow upstream. Make sure
33 not to break stuff.
34
35
36 The Council decisions can be summarized the following way:
37
38 1. The 'games' group, formerly used to control access to games, must
39 not be used. Games should be executable for all users like any other
40 program [1].
41
42 1a. For score files and similar writable shared data, the 'gamestat'
43 group (enewgroup gamestat 36) can be used. The old 'games' group is not
44 appropriate since sysadmins were expected to add users to it which
45 defeated its purpose.
46
47 2. Gentoo path customization for games must be removed and regular
48 install locations (without explicit control via GAMES_* variables)
49 should be used [2]:
50
51 2a. /usr/games and /etc/games directories are forbidden,
52
53 2b. /usr/share/games can be used for data if that directory is used
54 upstream,
55
56 2c. /var/games can be used for shared writable data.
57
58
59 This is mostly achieved through removing games.eclass inherit,
60 customization specific to it and replacing the helpers with generic PMS
61 helpers (e.g. egamesconf -> econf, dogamesbin -> dobin).
62 The 'gamesowners', 'gamesperms', 'prepgamesdirs' calls should be
63 removed altogether.
64
65 In some cases it will also be beneficial to remove patching added to
66 support non-standard locations.
67
68 Please remember to always rev-bump and not edit in place, to ensure
69 proper upgrade. When dealing with dependencies, please make sure to
70 check if the package does not rely on dependency installing data in
71 a specific location. If that is the case, then you need to use
72 appropriate >= deps to ensure clean upgrade.
73
74 If you would like to report bugs requesting games.eclass removal,
75 please make them block the tracker [3].
76
77
78 [1]:https://projects.gentoo.org/council/meeting-logs/20151011-summary.txt
79 [2]:https://projects.gentoo.org/council/meeting-logs/20151213-summary.txt
80 [3]:https://bugs.gentoo.org/show_bug.cgi?id=574082
81
82 --
83 Best regards,
84 Michał Górny (on behalf of QA team)
85 <http://dev.gentoo.org/~mgorny/>

Replies