1 |
commit: 2e16c6ae5dd2ecd71625bb3b972669d21c9c7259 |
2 |
Author: Michał Górny <mgorny <AT> gentoo <DOT> org> |
3 |
AuthorDate: Tue Jul 26 15:41:27 2016 +0000 |
4 |
Commit: Michał Górny <mgorny <AT> gentoo <DOT> org> |
5 |
CommitDate: Tue Jul 26 15:43:53 2016 +0000 |
6 |
URL: https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=2e16c6ae |
7 |
|
8 |
vcs-snapshot.eclass: Doc that github 'archive' URLs don't need the eclass |
9 |
|
10 |
eclass/vcs-snapshot.eclass | 10 +++++++--- |
11 |
1 file changed, 7 insertions(+), 3 deletions(-) |
12 |
|
13 |
diff --git a/eclass/vcs-snapshot.eclass b/eclass/vcs-snapshot.eclass |
14 |
index d12ff25..05c2d58 100644 |
15 |
--- a/eclass/vcs-snapshot.eclass |
16 |
+++ b/eclass/vcs-snapshot.eclass |
17 |
@@ -1,4 +1,4 @@ |
18 |
-# Copyright 1999-2013 Gentoo Foundation |
19 |
+# Copyright 1999-2016 Gentoo Foundation |
20 |
# Distributed under the terms of the GNU General Public License v2 |
21 |
# $Id$ |
22 |
|
23 |
@@ -11,7 +11,7 @@ |
24 |
# the tarballs in SRC_URI to locations matching their (local) names, |
25 |
# discarding the original parent directory. |
26 |
# |
27 |
-# The typical use case are VCS snapshots, coming from github, bitbucket |
28 |
+# The typical use case are VCS snapshots, coming from bitbucket |
29 |
# and similar services. They have hash appended to the directory name |
30 |
# which makes extracting them a painful experience. But if you just use |
31 |
# a SRC_URI arrow to rename it (which you're likely have to do anyway), |
32 |
@@ -22,6 +22,10 @@ |
33 |
# fall back to regular unpack. Support for additional formats may be |
34 |
# added at some point so please keep your SRC_URIs clean. |
35 |
# |
36 |
+# Note: this eclass is no longer needed with the new-style 'archive' |
37 |
+# GitHub URLs. They have sane directory names and stable contents, |
38 |
+# so you should really prefer them. |
39 |
+# |
40 |
# @EXAMPLE: |
41 |
# |
42 |
# @CODE |
43 |
@@ -29,7 +33,7 @@ |
44 |
# inherit vcs-snapshot |
45 |
# |
46 |
# SRC_URI="https://github.com/example/${PN}/tarball/v${PV} -> ${P}.tar.gz |
47 |
-# https://github.com/example/${PN}-otherstuff/tarball/v${PV} -> ${P}-otherstuff.tar.gz"" |
48 |
+# https://github.com/example/${PN}-otherstuff/tarball/v${PV} -> ${P}-otherstuff.tar.gz" |
49 |
# @CODE |
50 |
# |
51 |
# and however the tarballs were originally packed, all files will appear |