Variabili predefinite in sola lettura

Le seguenti variabili vengono predefinite per l'utente e non dovrebbero essere sovrascritte.

Variabili richieste

Le seguenti variabili devono essere definite in ogni ebuild.

Variabili opzionali

L'uso delle seguenti variabili è opzionale:

SLOT

Quando non è necessario alcuno slot, usare SLOT="0". Non usare SLOT="" che disabiliterà lo slotting per questo pacchetto.

KEYWORDS

ll solo costrutto valido riguardante un * in KEYWORDS è un -*. Non usare KEYWORDS="*" o KEYWORDS="~*".

Vedere Keywording per sapere come gestire questa variabile.

SRC_URI

SRC_URI="http://example.com/files/${P}-core.tar.bz2
    x86?   ( http://example.com/files/${P}/${P}-sse-asm.tar.bz2 )
    ppc?   ( http://example.com/files/${P}/${P}-vmx-asm.tar.bz2 )
    sparc? ( http://example.com/files/${P}/${P}-vis-asm.tar.bz2 )
    doc?   ( http://example.com/files/${P}/${P}-docs.tar.bz2 )"

SRC_URI="http://example.com/files/${P}-core.tar.bz2
        examplecards_foo?  ( http://example.com/files/${P}-foo.tar.bz2 )
        examplecards_bar?  ( http://example.com/files/${P}-bar.tar.bz2 )
        examplecards_baz?  ( http://example.com/files/${P}-baz.tar.bz2 )
    !examplecards_foo? ( !examplecards_bar? ( !examplecards_baz? (
        http://example.com/files/${P}-foo.tar.bz2
        http://example.com/files/${P}-bar.tar.bz2
        http://example.com/files/${P}-baz.tar.bz2 ) ) )"

IUSE

Notare che la variabile IUSE è cumulativa, per questo non è necessario specificare flag USE usati solo nelle eclass ereditate all'interno della IUSE dell'ebuild.

Flag USE per architettura (sparc, mips, x86-fbsd, etc.) non dovrebbero essere elencati così come flag auto-extend (linguas_en, etc.).

LICENSE

E' possibile specificare LICENSE multiple e voci che si applicano solo su un particolare flag USE impostato. Il formato è lo stesso di DEPEND.

Questione inerente la formattazione della versione

Spesso il formato della versione dei tarball non segue le convenzioni usate da Gentoo. Differenze riguardanti l'uso dei caratteri di sottolineatura e trattini sono particolarmente comuni. Per esempio, quello che Gentoo chiama foo-1.2.3b potrebbe avere un tarball chiamato foo-1.2-3b.tar.bz2. Piuttosto che codificare i numeri di versione è preferibile usare una variabile MY_PV. Il modo più semplice per farlo è usare l'eclass versionator:

inherit versionator
MY_PV=$(replace_version_separator 2 '-')

Questo codice ha il vantaggio che funzionerà anche se il tarball avesse un formato come foo-1.3-4.5.tar.bz2.

E' possibile usare anche i metodi di sostituzione della bash per ottenere lo stesso effetto (questo è il metodo utilizzato da internamente versionator), ma è complicato, passibile di errori e difficile da leggere.

Alcuni ebuild usano chiamate a sed, awk e / o cut, ma questo non dovrebbe più essere fatto per ogni nuovo codice e dovrebbe essere sostituito sia da versionator che dai metodi di bash substitution dove possibile.

L'eclass versionator può anche essere usato per estrarre particolari componenti da una stringa di versione. Ecco un breve sommario delle funzioni.