EKEYWORD

NAME

ekeyword - Gentoo: modify package KEYWORDS

SYNOPSIS

ekeyword { arch|~arch|-arch|^arch } ebuild...

DESCRIPTION

This tool provides a simple way to add or update KEYWORDS in a set of ebuilds. Each command-line argument is processed in order, so that keywords are added to the current list as they appear, and ebuilds are processed as they appear.

Instead of specifying a specific arch, it's possible to use the word "all". This causes the change to apply to all keywords presently specified in the ebuild.

The ^ leader instructs ekeyword to remove the specified arch.

OPTIONS

Presently ekeyword is simple enough that it supplies no options. Probably I'll add --help and --version in the future, but for now it's enough to track the gentoolkit version.

EXAMPLES

To mark a single arch stable:

 $ ekeyword alpha metalog-0.7-r1.ebuild 
 metalog-0.7-r1.ebuild 
   -KEYWORDS="~alpha ~amd64 ~hppa ~ia64 ~mips ~ppc ~sparc ~x86" 
   +KEYWORDS="alpha ~amd64 ~hppa ~ia64 ~mips ~ppc ~sparc ~x86" 

When bumping a package, to mark all arches for testing:

 $ ekeyword ~all metalog-0.7-r2.ebuild 
 metalog-0.7-r2.ebuild 
   -KEYWORDS="alpha amd64 hppa ia64 mips ppc sparc x86" 
   +KEYWORDS="~alpha ~amd64 ~hppa ~ia64 ~mips ~ppc ~sparc ~x86" 

To signify that a package is broken for all arches except one:

 $ ekeyword ^all -* ~x86 metalog-0.7-r3.ebuild 
 metalog-0.7-r3.ebuild 
   -KEYWORDS="~alpha ~amd64 ~hppa ~ia64 ~mips ~ppc ~sparc ~x86" 
   +KEYWORDS="-* ~x86" 

To do lots of things at once:

 $ ekeyword alpha metalog-0.7-r1.ebuild  
     ~all metalog-0.7-r2.ebuild ^all -* ~x86 metalog-0.7-r3.ebuild 
 metalog-0.7-r1.ebuild 
   -KEYWORDS="~alpha ~amd64 ~hppa ~ia64 ~mips ~ppc ~sparc ~x86" 
   +KEYWORDS="alpha ~amd64 ~hppa ~ia64 ~mips ~ppc ~sparc ~x86" 
 metalog-0.7-r2.ebuild 
   -KEYWORDS="alpha amd64 hppa ia64 mips ppc sparc x86" 
   +KEYWORDS="~alpha ~amd64 ~hppa ~ia64 ~mips ~ppc ~sparc ~x86" 
 metalog-0.7-r3.ebuild 
   -KEYWORDS="~alpha ~amd64 ~hppa ~ia64 ~mips ~ppc ~sparc ~x86" 
   +KEYWORDS="-* ~x86" 

NOTES

This tool was written by Aron Griffis <>. Bugs found should be filed against me at http://bugs.gentoo.org/

2009-08-30

Thank you!