commit: a3c28fc6d6cb008904c4705ff42611cc2d56c88b
Author: Michał Górny <mgorny <AT> gentoo <DOT> org>
AuthorDate: Sun Nov 3 07:43:44 2019 +0000
Commit: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Tue Nov 26 01:47:20 2019 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=a3c28fc6
ebuild-writing/variables: Indicate that HOMEPAGE is multi-valued
Indicate that HOMEPAGE can accept multiple values. Expand freshmeat
fallback suggestion into the broader idea that package trackers can
be linked in addition to main HOMEPAGE (which is a common practice
e.g. for Python packages). Simplify No_homepage suggestion to always
use it when there's no homepage, rather than when transitioning from old
homepage.
Signed-off-by: Michał Górny <mgorny <AT> gentoo.org>
Signed-off-by: Göktürk Yüksek <gokturk <AT> gentoo.org>
ebuild-writing/variables/text.xml | 11 ++++++-----
1 file changed, 6 insertions(+), 5 deletions(-)
diff --git a/ebuild-writing/variables/text.xml
b/ebuild-writing/variables/text.xml
index 6195614..8854a3a 100644
--- a/ebuild-writing/variables/text.xml
+++ b/ebuild-writing/variables/text.xml
@@ -185,11 +185,12 @@ The following variables may or must be defined by every
ebuild.
<tr>
<ti><c>HOMEPAGE</c></ti>
<ti>
- Package's homepage. Mandatory (except for virtuals). If you are
- unable to locate an official one, try to provide a link to
- <uri link="http://freshmeat.net";>freshmeat.net</uri> or a similar
- package tracking site. If the homepage of the package is unavailable
- and no new location can be found, please update it to
+ Package's homepage(s). Mandatory (except for virtuals), accepts
+ multiple values. In some contexts, it is customary to provide
+ package tracker and/or code hosting links besides the main homepage
+ (e.g. PyPI link for Python packages, GitHub link when code can't
+ easily be found on homepage) for convenience. If no homepage for
+ the package is available, please set it to
<c>https://wiki.gentoo.org/wiki/No_homepage</c>.
Never refer to a variable name in the string; include only raw text.
</ti>
