1 | GLEP: 24
|
1 | GLEP: 24
|
2 | Title: Consistent Gentoo tool naming scheme
|
2 | Title: Consistent Gentoo tool naming scheme
|
3 | Version: $Revision: 1.1 $
|
3 | Version: $Revision: 1.2 $
|
4 | Last-Modified: $Date: 2004/03/17 14:17:26 $
|
4 | Last-Modified: $Date: 2004/03/17 14:27:06 $
|
5 | Author: Donnie Berkholz <spyderous@gentoo.org>,
|
5 | Author: Donnie Berkholz <spyderous@gentoo.org>,
|
6 | Status: Draft
|
6 | Status: Draft
|
7 | Type: Standards
|
7 | Type: Standards
|
8 | Content-Type: text/x-rst
|
8 | Content-Type: text/x-rst
|
9 | Created: 16 March 2004
|
9 | Created: 16 March 2004
|
… | |
… | |
35 | =============
|
35 | =============
|
36 |
|
36 |
|
37 | The following packages and tools are affected (gentoo- prefix removed for ease
|
37 | The following packages and tools are affected (gentoo- prefix removed for ease
|
38 | of reading, current name follows suggested name)::
|
38 | of reading, current name follows suggested name)::
|
39 |
|
39 |
|
40 | ::
|
|
|
41 |
|
|
|
42 | config-kernel
|
40 | config-kernel
|
43 | x11-base/opengl-update -> config-opengl (opengl-update)
|
41 | x11-base/opengl-update -> config-opengl (opengl-update)
|
44 | sys-devel/distcc -> config-distcc (distcc-config)
|
42 | sys-devel/distcc -> config-distcc (distcc-config)
|
45 | app-admin/zope-config -> config-zope (zope-config)
|
43 | app-admin/zope-config -> config-zope (zope-config)
|
46 | app-sci/blas-config -> config-blas (blas-config)
|
44 | app-sci/blas-config -> config-blas (blas-config)
|
… | |
… | |
57 |
|
55 |
|
58 |
|
56 |
|
59 | Rationale
|
57 | Rationale
|
60 | =========
|
58 | =========
|
61 |
|
59 |
|
62 | Three primary options were presented for the naming scheme::
|
60 | Three primary options were presented for the naming scheme:
|
63 |
|
61 |
|
64 | * The current scheme, *-config and *-update. This scheme makes finding a
|
62 | * The current scheme, \*-config and \*-update. This scheme makes finding a
|
65 | tool difficult, since there is no consistency in the beginning of the name.
|
63 | tool difficult, since there is no consistency in the beginning of the name.
|
66 | However, it may be easier for people who already know such a tool exists and
|
64 | However, it may be easier for people who already know such a tool exists and
|
67 | remember that its name correlates with the package to be configured (except
|
65 | remember that its name correlates with the package to be configured (except
|
68 | in the case of many of the *-update tools).
|
66 | in the case of many of the \*-update tools).
|
69 |
|
67 |
|
70 | * A slightly modified version of the proposed scheme, with an abbreviated
|
68 | * A slightly modified version of the proposed scheme, with an abbreviated
|
71 | prefix, shorter than gentoo-*. For example, the current gcc-config would
|
69 | prefix, shorter than gentoo-\*. For example, the current gcc-config would
|
72 | become gen-config-gcc or g-config-gcc. Although this is shorter to type, the
|
70 | become gen-config-gcc or g-config-gcc. Although this is shorter to type, the
|
73 | availability of tab completion renders that point largely moot. It may also
|
71 | availability of tab completion renders that point largely moot. It may also
|
74 | contribute to confusion through inexact specification of what it is.
|
72 | contribute to confusion through inexact specification of what it is.
|
75 |
|
73 |
|
76 | * The proposed scheme, gentoo-{config,update}-*. It provides a streamlined way
|
74 | * The proposed scheme, gentoo-{config,update}-\*. It provides a streamlined way
|
77 | to discover and use various Gentoo-specific tools, even if one does not
|
75 | to discover and use various Gentoo-specific tools, even if one does not
|
78 | remember the exact name. A minor downside is the length of the names, but
|
76 | remember the exact name. A minor downside is the length of the names, but
|
79 | again this caveat is largely moot because of tab completion.
|
77 | again this caveat is largely moot because of tab completion.
|
80 |
|
78 |
|
81 | In an example of another distribution, Red Hat moved to a redhat-config-*
|
79 | In an example of another distribution, Red Hat moved to a redhat-config-\*
|
82 | scheme within the past couple of years to provide more consistent and
|
80 | scheme within the past couple of years to provide more consistent and
|
83 | easier-to-find tools.
|
81 | easier-to-find tools.
|
84 |
|
82 |
|
85 | After two discussions on gentoo-dev, the majority favored this unified prefix
|
83 | After two discussions on gentoo-dev, the majority favored this unified prefix
|
86 | for the tools, with a minority in objection, variously favoring one of the
|
84 | for the tools, with a minority in objection, variously favoring one of the
|