The ebuild manpage doesn't mention the mirror:// syntax. This is confusing to users trying to understand their ebuilds. It also does not inform ebuild-authors of the possibility to use the mirror URI shortcut if the don't know of the possibility via other means. I would expect the ebuild manpage to contain a short note in the SRC_URI description mentioning sth. like: "Valid URI's are ftp:// http:// or rsync:// sources or URIs of the type mirror://name which is a shorthand for all URIs defined under name in ${PORTDIR}/profiles/thirdpartymirrors". Maybe i have just missed where in the portage documentation that information can be found, in that case the bug report would be void. Reproducible: Always
I don't see it documented anywhere in the portage docs. We can document it with an example like is done here: http://devmanual.gentoo.org/quickstart/index.html#information-variables
Sounds good. I would, however, add a remark on where those mirrors are defined, as in my original remark. For example I don't know myself wether ${PORTDIR}/profiles/thirdpartymirrors is the only place where mirror shortcuts can be defined. I expect that to be mentioned somewhere. Also I wonder wether rsync, ftp and http are the only normal URI types allowed, I think that should be mentioned, too.