[gentoo-dev] Re: RFC: Forbid using versions in DESCRIPTION

[Tiziano Müller]

Petteri Räty schrieb:
> Currently there are some ebuilds in the tree that use ${PV} 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.html
> 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 ${PV} (and ${P}, ...) in the DESCRIPTION.

Cheers,
Tiziano