1 |
>>>>> On Fri, 10 Apr 2015, Michał Górny wrote: |
2 |
|
3 |
> C. Repository vs tree vs overlay vs Portage... |
4 |
> ---------------------------------------------- |
5 |
|
6 |
> This one is harsh since it has a lot of historic context. Long story |
7 |
> short, none of the Gentoo package managers work in pure 'overlay' |
8 |
> logic anymore, so best to stop using that term. Also, better to |
9 |
> leave 'trees' to the forests. |
10 |
|
11 |
> And finally, Portage is the package manager and let's leave it at |
12 |
> that. No need to cause users to confuse developers even further. |
13 |
|
14 |
> Therefore: |
15 |
|
16 |
> - Don't use 'Portage', 'tree', 'overlay' or any other thing. Just |
17 |
> call it a 'repository' (or 'ebuild repository', if you want to be |
18 |
> more specific and distinguish it from 'binary package |
19 |
> repository'). |
20 |
|
21 |
> - When referring to the main Gentoo repository, call it the 'Gentoo |
22 |
> repository'. That's how it is named these days (read repo_name!), |
23 |
> and that's the least confusing name you can use. |
24 |
|
25 |
The lastest approved version of PMS defines terms as follows [1]: |
26 |
|
27 |
# stand-alone repository |
28 |
# An (ebuild) repository which is intended to function on its own |
29 |
# as the only, or primary, repository on a system. Contrast with |
30 |
# _slave_repository_ below. |
31 |
# |
32 |
# slave repository, non-stand-alone repository |
33 |
# An (ebuild) repository which is not complete enough to function |
34 |
# on its own, but needs one or more _master_repositories_ to |
35 |
# satisfy dependencies and provide repository-level support files. |
36 |
# Known in Portage as an overlay. |
37 |
# |
38 |
# master repository |
39 |
# See above. |
40 |
|
41 |
> - When referring to other repositories, you can call them |
42 |
> 'third-party repositories' or alike. No point in calling them |
43 |
> 'overlays' since they are not laid over anything anymore. |
44 |
|
45 |
Don't forget to rename "layman" to "repoman" ... wait, that's used for |
46 |
something else already. :) |
47 |
|
48 |
Ulrich |
49 |
|
50 |
|
51 |
[1] http://dev.gentoo.org/~ulm/pms/5/pms.html#x1-16200014 |