Difference between revisions of "Talk:VCS package guidelines"
(→Updating a CVS repo) |
(→More on git pkgver()'s) |
||
Line 86: | Line 86: | ||
:::::Well, that's what's being suggested.. | :::::Well, that's what's being suggested.. | ||
:::::--[[User:Det|Det]] ([[User talk:Det|talk]]) 05:57, 19 May 2013 (UTC) | :::::--[[User:Det|Det]] ([[User talk:Det|talk]]) 05:57, 19 May 2013 (UTC) | ||
+ | |||
+ | :I have the same issue with tup--git package that bumped its version from {{ic|0.6}} to {{ic|0.6.5}}. previously generated version was {{ic|0.6.350.gfoobar}} now it became {{ic|0.6.5}} that is smaller than previous. Generated version should split upstream version from 'git describe' version. My vote is goes to '~' delimiter proposed above. Or maybe we can use '-' as delimiter? | ||
+ | :--[[User:Anatolik|Anatolik]] ([[User talk:Anatolik|talk]]) 11:43, 17 Jun 2013 (UTC) | ||
== Clarifying the first Git function == | == Clarifying the first Git function == |
Revision as of 18:44, 17 June 2013
Contents
https:// vs git://
Could we consider a guideline to use firewall-friendly protocols when possible (e.g. https://github.com/matplotlib/matplotlib.git instead of git://github.com/matplotlib/matplotlib.git)? --Mitch feaster 14:34, 15 November 2011 (EST)
- It shouldn't be too hard to just mention that. As I haven't heard of anybody else ever bringing it up, it'd probably be enough.
- --Det (talk) 22:51, 2 May 2013 (UTC)
Updating a CVS repo
I don't use cvs. How can you describe the pkgver for cvs (for pacman 4.1)?
-- Dracorp (talk) 09:31, 6 April 2013 (UTC)
- CVS is not supported in pacman 4.1 like the other VCS tools. You will need to update pkgver manually until CVS support is added.
- -- Jstjohn (talk) 22:44, 15 April 2013 (UTC)
- The download example can still be found in
/usr/share/pacman/
. The next version of the ABS package should update it a bit so the download happens in the prepare function where it belongs. As for pkgver, I think the generic example using date covers that, as there's not a way to get a version number from a CVS repo. Maybe a note to that effect? - -- Scimmia (talk) 07:17, 15 May 2013 (UTC)
- The download example can still be found in
- That makes the most sense, but it might also be a good idea to rename the "Fallback" section to something like "Fallback / CVS" to make it more obvious even when you're just checking out the table of contents.
- Hmm, there were a number of patches submitted last month for cleaning up the prototypes, looks like none have been committed yet. I do remember a discussion (IRC maybe?) questioning the proper place for the prototypes, so maybe that's why? Looking at the patches, I was mistaken anyway; they didn't update the darcs or cvs prototypes. Simple enough, I'll send in a patch myself.
- --Scimmia (talk) 08:22, 19 May 2013 (UTC)
- I use this dirty hack:
cvs history -c -a | cut -d' ' -f2 | sort -u | tail -n 1 | sed 's|-||g"
; could probably be improved. --Buhman (talk) 18:00, 6 June 2013 (UTC)
Checking out branches/tags needs clarification
The #fragment
part of the VCS source URL has a different meaning for each type of VCS.
This can be confusing for people, especially when they are trying to checkout a specific branch or tag.
Examples would reduce the chance for confusion a lot.
fictional examples for git and svn (don't have experience with bzr or HG)
check out branch git_test
of git://myproject.com into folder my_git_code
:
my_git_code::git://myproject.com/#branch=git_test
Check out branch svn_test
of svn://myproject.com into folder my_svn_code
:
my_svn_code::svn://myproject.com/branches/svn_test
Lone_Wolf (talk) 20:49, 16 April 2013 (UTC)
More on git pkgver()'s
I would also like to see packages use pkgver
functions like this:
git describe --always --long | sed -E 's/([^-]*-g)/r\1/;s/-/./g'
so they are more friendly to vercmp
.
Current behaviour using git-git as an example:
current ver: 1.8.2.210.g123abc-1
next ver: 1.8.2.1.50.g123abc-1
vercmp 1.8.2.210.g123abc 1.8.2.1.50.g123abc 1 # the first is greater than the second
Right now, the current version is actually greater than the new version, causing a downgrade. If r
is appended to the patch level (the numbers just before the g<hex>
bit), then vercmp
would order the versions correctly.
current ver: 1.8.2.r210.g123abc-1
next ver: 1.8.2.1.r50.g123abc-1
vercmp 1.8.2.r210.g123abc 1.8.2.1.r50.g123abc -1 # the first is less than the second
KaiSforza (talk) 20:42, 18 April 2013 (UTC)
- So Git makes some projects jump down from
x.x.x.210
tox.x.x.x.50
? Is that really intended behavior? - --Det (talk) 22:48, 2 May 2013 (UTC)
- I have the same issue with tup--git package that bumped its version from
0.6
to0.6.5
. previously generated version was0.6.350.gfoobar
now it became0.6.5
that is smaller than previous. Generated version should split upstream version from 'git describe' version. My vote is goes to '~' delimiter proposed above. Or maybe we can use '-' as delimiter? - --Anatolik (talk) 11:43, 17 Jun 2013 (UTC)
Clarifying the first Git function
Instead of just sed 's|-|.|g'
it'd probably be better to give some example with cut
(which you're probably gonna end up using anyway) and tr
(which is simpler than sed
). Then you could either explain it like this or just mention the man pages: "cut -d "-" -f2-
cuts from the first hyphen (-) to the end, tr - .
converts hyphens to dots (.) and tr -d -
removes the hyphens".
Example:
pkgver() { cd local_repo git describe --always | cut -d "-" -f2- | tr - . }
2.0.6.a17a017
--Det (talk) 00:22, 3 May 2013 (UTC)
- Did you test this before posting? It doesn't do anything like you think it does. Scimmia (talk) 22:29, 4 May 2013 (UTC)
- Well, my friend, that's what makes it an example. The reason I'm using
cut
is to remove the actual project names that are often included in their tags. All the sed example does is change the hyphens (-
) to dots (.
), which is simpler to do withtr - .
anyway.
- Well, my friend, that's what makes it an example. The reason I'm using
- What _makes_ it so hard is that there isn't a single solution that somehow magicly worked on all scenarios. Even if you decided to be clever and started cutting the output up until the first number (with something like
$ sed 's/\([^0-9]*\)\(.*\)/\2/g'
), you'd still end up with the wrong result whenever the "version" starts with a letter or the project name ends with a number. - --Det (talk) 21:04, 7 May 2013 (UTC)
- What _makes_ it so hard is that there isn't a single solution that somehow magicly worked on all scenarios. Even if you decided to be clever and started cutting the output up until the first number (with something like
- Ah, I see now, you were addressing a special case. You're right, there isn't a single solution. You're also right that
tr
is simpler and should probably be used in the example if that's all the example is going to show. It seems to be fairly common, though, to include a "v" at the beginning of the version number, in which case you'd already be usingsed
anyway so you can just dosed 's/^v//;s/-/./g'
So many ways of doing the same job. Scimmia (talk) 02:15, 8 May 2013 (UTC)
- Ah, I see now, you were addressing a special case. You're right, there isn't a single solution. You're also right that
- That only works when they do. It doesn't remove the names from the tags, which are included in things like Wine and the entire X stack.
git describe --always | sed 's/\([^0-9]*\)\(.*\)/\2/g; s/-/./g'
is the most universal approach I can think of. But it's totally unreadable and a damn lot harder to edit than somecut
/tr
example.- --Det (talk) 20:37, 14 May 2013 (UTC)
- Yeah, my example was a special case as well. I'm really thinking that this is a situation where it's best just to include a very simple example and let the maintainer customize it as needed instead of trying to find a convoluted solution that works everywhere.
- -- Scimmia (talk) 07:11, 15 May 2013 (UTC)
Use --long insead of --always in git describe
--always is for returning something even when it can't find a tag. It just returns the short hash of the commit, which is kind of useless in this example. On the other hand --long is needed to get the output we want if HEAD has a tag. By default, git describe would just return the name of the tag, --long forces it to return the full output we want, ie "2.0-0-g123abcd" instead of just "2.0". --Scimmia (talk) 09:40, 22 May 2013 (UTC)