--- xml/htdocs/proj/en/glep/glep-0024.html 2006/07/07 06:08:10 1.3 +++ xml/htdocs/proj/en/glep/glep-0024.html 2006/10/10 20:25:14 1.4 @@ -8,9 +8,252 @@ --> - + GLEP 24 -- Consistent Gentoo tool naming scheme - + -
- +
@@ -33,9 +275,9 @@ - + - + @@ -43,7 +285,7 @@ - + @@ -52,8 +294,8 @@
Title:Consistent Gentoo tool naming scheme
Version:1.3
Version:1.5
Last-Modified:2004/10/25 16:53:16
Last-Modified:2006/07/07 06:08:10
Author:Donnie Berkholz <dberkholz at gentoo.org>,
Type:Standards
Content-Type:text/x-rst
Content-Type:text/x-rst
Created:16 March 2004

-
-

Contents

+
+

Contents

-
-

Abstract

+
+

Abstract

This GLEP proposes to create a more consistent, logical and usable naming scheme for Gentoo-specific configuration and update tools. It proposes changing the scheme to gentoo-config-<toolname> and gentoo-update-<toolname>.

-
-

Status Update

+
+

Status Update

The author notes that this GLEP "needs significant work", which is unlikely to occur until either winter vacation or next summer. Marking as deferred for the time being.

-
-

Motivation

+
+

Motivation

A consistent prefix on these tools will allow users to easily find them on the system by merely entering "gentoo-<tab><tab>" for a complete listing or "gentoo-config-<tab><tab>" or "gentoo-update-<tab><tab>" to get a listing of @@ -87,8 +329,8 @@ reads a portage log of installed files for a package. Revamping the naming scheme would enable users to find these tools more easily.

-
-

Specification

+
+

Specification

The following packages and tools are affected (gentoo- prefix removed for ease of reading, current name follows suggested name):

@@ -109,8 +351,8 @@
 sys-apps/baselayout -> config-rc (rc-update)
 
-
-

Rationale

+
+

Rationale

Three primary options were presented for the naming scheme:

  • The current scheme, *-config and *-update. This scheme makes finding a @@ -135,8 +377,8 @@ for the tools, with a minority in objection, variously favoring one of the first two schemes above.

-
-

Backwards Compatibility

+
+

Backwards Compatibility

To ensure a smooth transition, a wrapper script will be provided in the old location. This wrapper will print a warning, sleep 5 seconds, then run the tool from its new location. The wrapper script should be provided for the next @@ -146,21 +388,22 @@ new ebuilds. They will run in one more ebuild beyond removal of the wrapper script.

-
-

Reference Implementation

+ - - +