Gentoo Archives: gentoo-commits

From: "Michał Górny" <mgorny@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] repo/gentoo:master commit in: eclass/
Date: Tue, 26 Jul 2016 15:44:15
Message-Id: 1469547833.2e16c6ae5dd2ecd71625bb3b972669d21c9c7259.mgorny@gentoo
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