PETTERI RäTY SCHRIEB:
> CURRENTLY THERE ARE SOME EBUILDS IN THE TREE THAT USE
$ IN
> DESCRIPTION WHICH LEADS TO RESULTS LIKE:
> DESCRIPTION: DOCUMENTATION (INCLUDING API
JAVADOCS) FOR
> JAVA SDK VERSION 1.6.0
>
> I DID SEE ANYTHING IN DEVMANUAL TAKING A STANCE ON THIS
ISSUE:
>
HTTP://DEVMANUAL.GENTOO.ORG/EBUILD-WRITING/VARIABLES/INDEX.H
TML
> WHAT DO YOU THINK ABOUT ADDING A SENTENCE OR TWO SAYING
THAT YOU SHOULD
> NOT USE VERSION NUMBERS IN DESCRIPTION? THIS COULD EVEN
BE ADDED TO REPOMAN.
AS FAR AS I UNDERSTOOD IT, HAVING DESCRIPTION IN THE EBUILD
ITSELF
(RATHER THAN IN METADATA) MEANS THAT DESCRIPTION IS ALLOWED
TO CHANGE
BETWEEN VERSIONS, WHETHER "AUTOMATICALLY" BY USING
A VERSION-DEPENDENT
VARIABLE OR "MANUALLY".
I'D THEREFORE ONLY ADD A NOTE IN THE DEVMANUAL WHICH
RECOMMENDS NOT TO
USE $ (AND $, ...) IN THE DESCRIPTION.
CHEERS,
TIZIANO
|
