Difference between revisions of "Talk:Arch User Repository"

From ArchWiki
Jump to: navigation, search
(Upgrading AUR packages: rm closed idscussion)
m (Scope of the AUR4 section: rm closed discussion)
 
(233 intermediate revisions by 27 users not shown)
Line 1: Line 1:
 +
==Warning about rebuilding your AUR packages==
 +
I thought at some point there was an explicit warning to the effect that rebuilding AUR packages against new official libraries was the individual's responsibility, not pacman's. I would like to see this reinstated at the top of the page as it is a constant source of confusion for new users. [[User:Jasonwryan|Jasonwryan]] ([[User talk:Jasonwryan|talk]]) 21:57, 24 November 2016 (UTC)
  
 +
Another approach would be to add it to the top of the [[Arch_User_Repository#FAQ|FAQ]], and then split that out to a separate page, with a warning at the top of the AUR page sugesting that new users read the entirety of the FAQ 'before' installing anything from the AUR [[User:Jasonwryan|Jasonwryan]] ([[User talk:Jasonwryan|talk]]) 04:58, 27 November 2016 (UTC)
 +
 +
:Is this a user's responsibility completely or the package maintainer's to increment pkgrel to indicate that the package should be rebuilt? This might fit to the explanation when (not) to use the "Out of date" button. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 08:21, 27 November 2016 (UTC)
 +
 +
== AUR's history and future ==
 +
 +
Will part of [[Arch_User_Repository#AUR_4]] be moved to [[Arch_User_Repository#History]] in a day or two? We should also remove / archive notes about the old AUR once it's read-only.
 +
 +
The article should also mention using git as an alternative to downloading the tarball. -- [[User:Karol|Karol]] ([[User talk:Karol|talk]]) 12:06, 7 August 2015 (UTC)
 +
 +
:Part of this request has been fulfilled with [https://wiki.archlinux.org/index.php?title=Arch_User_Repository&diff=390646&oldid=389301]. — [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 14:46, 9 August 2015 (UTC)
 +
 +
== What is the correct AUR forum section? ==
 +
 +
[[Arch_User_Repository#Submitting_packages]] says it's [https://bbs.archlinux.org/viewforum.php?id=4], but we also have [https://bbs.archlinux.org/viewforum.php?id=38]. One of them should be added to [[Arch_User_Repository#I_have_a_PKGBUILD_I_would_like_to_submit.3B_can_someone_check_it_to_see_if_there_are_any_errors.3F]]. -- [[User:Karol|Karol]] ([[User talk:Karol|talk]]) 12:30, 7 August 2015 (UTC)
 +
 +
== AUR link ==
 +
 +
The link to this page from the [https://aur.archlinux.org/ AUR homepage] is outdated.
 +
 +
[https://wiki.archlinux.org/index.php/Arch_User_Repository#AUR_4 "Submitting packages"] located above the SSH keys directs to an AUR4 link, which has since become just AUR. I'm not knowledgeable of the methods to correct this.
 +
 +
-- [[User:Ctag|Ctag]] ([[User talk:Ctag|talk]]) 00:05, 23 September 2015 (UTC)
 +
 +
:You can submit a bug report for the [https://bugs.archlinux.org/index.php?project=2&do=index&switch=1 AUR web interface] project in the tracker. Or even provide a patch: sources are at [https://projects.archlinux.org/aurweb.git/]. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 11:22, 23 September 2015 (UTC)
 +
 +
== gitignore ==
 +
 +
Adding {{ic|*}} to {{ic|.gitignore}} is an ugly workaround for something (in case of dotfiles, programs not respecting standards and e.g. storing cache and config files together). There isn't much to be excluded here - the only unpredictable part is the source tarballs and VCS directories, which can be easily put away by configuring {{ic|SRCDEST}} in {{ic|makepkg.conf}}. We can still recommend to add the source files explicitly.
 +
 +
The recommendation will affect everybody using the given package, not only the user managing his personal config files, so I think an explicit blacklist is better than the {{ic|*}} wildcard here.
 +
 +
-- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 08:58, 6 March 2016 (UTC)
 +
:I agree, as per my original recommendation. The simple thing to do is {{ic|git add .}}; some packages ''do have'' an annoying variety of files. Better to explicitly exclude download directories other known cruft in .gitignore. [[User:Quequotion|quequotion]] ([[User talk:Quequotion|talk]]) 12:15, 6 March 2016 (UTC)
 +
 +
::So the concern is you'd miss to whitelist some "annoying variety" of files, which you wouldn't with {{ic|git add .}}? You might as well argue that you'd miss to blacklist a file you wouldn't want to upload to the AUR...
 +
::Either way, I'd agree configuring SRCDEST is the better (and universal) solution here. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 15:05, 6 March 2016 (UTC)
 +
:::<strike>Good point, the whole reason for posting a guide indeed is to show users how to deal with AUR4 in the way Archlinux administration expects, this seems to be the more reliable solution[</strike>
 +
::::Then I remembered what SRCDEST actually does and realized it wouldn't sufficiently resolve the issue (the source directory is not the only cruft to be avoided). [[User:Quequotion|quequotion]] ([[User talk:Quequotion|talk]]) 03:55, 13 March 2016 (UTC)
 +
 +
:::::I have SRCDEST, PKGDEST, LOGDEST, and BUILDDEST set. Suffice to say there's no cruft in my .git dirs. It's not much a bother either, since the values are commented in makepkg.conf. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 12:35, 13 March 2016 (UTC)
 +
 +
::::::What about the symlinks to the built packages and signatures? -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 13:04, 13 March 2016 (UTC)
 +
 +
:::::::Assuming only makepkg crates symlinks in the clone directory (correct me if I'm wrong), you can do something like {{ic|find -maxdepth 2 -type l -delete}} in the directory above, in my case a dedicated "AURDEST".
 +
:::::::Perhaps too specific for the general case, but the special type helps anyway. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 13:43, 13 March 2016 (UTC)
 +
 +
::::::::That's cleanup, not prevention. Anyway, the point of {{ic|.gitignore}} is not to move the "cruft" away, but to keep the repo directory clean ''in git terms'', i.e. git should not report files created by makepkg as untracked. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 11:48, 14 March 2016 (UTC)
 +
 +
:::::::::In that case, I refer to my comment below on just mentioning {{ic|.gitignore}}, but not recommending a specific method. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 19:47, 14 March 2016 (UTC)
 +
 +
::::Recommending either way is problematic since this is more a question of git usage style rather than AUR usage. The maintainer should set up the .gitignore in an intuitive way ''depending'' on their git workflow and how the package is organized. If I had to recommend anything, it would be either: don't {{ic|git add .}} (because it's lazy and can easily backfire), or always check {{ic|git status}} before you commit to make sure you know what's staged (and we already recommend checking your commits before pushing). But again, those are more general git recommendations than anything AUR-specific. [[User:Silverhammermba|Silverhammermba]] ([[User talk:Silverhammermba|talk]]) 21:58, 9 March 2016 (UTC)
 +
 +
:::::Using gitignore is useful not only for the comfort of the maintainer, but also of users building and installing the package. For example if {{ic|pkg/}}, {{ic|src/}} etc. are not gitignored, tools such as [https://github.com/kynikos/repocheck repocheck] will not work correctly. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 23:05, 9 March 2016 (UTC)
 +
 +
::::::I still don't see how that is AUR-specific information. It is certainly good practice to have a gitignore for any git repo with files you don't want to track, but it is by no means necessary nor is it a practice specific to AUR repos. Adding git tricks to this article that are just general best practices is a slippery slope to creating a duplicate git tutorial like Quequotion did. I would much rather direct users to https://git-scm.com/doc and emphasize the importance of learning git properly before contributing AUR packages. [[User:Silverhammermba|Silverhammermba]] ([[User talk:Silverhammermba|talk]]) 17:58, 10 March 2016 (UTC)
 +
 +
:::::::We know certain things could be .gitignored for every package, such as {{ic|src/}}, {{ic|pkg/}}, and {{ic|*.pkg.tar.xz}}; but we cannot know what files a packager may be using otherwise. I think having packagers create an explicit blacklist is the smallest and easiest of the available options. [[User:Quequotion|quequotion]] ([[User talk:Quequotion|talk]]) 03:55, 13 March 2016 (UTC)
 +
 +
::::::::Stuff makepkg creates can be moved automatically, as indicated above. The rest is an edge case, and the best way to handle it is subject to debate. If anything, just mention .gitignore, but not a specific approach to using it. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 12:35, 13 March 2016 (UTC)
 +
 +
:::::::::I've changed my mind, and my perspective on this issue. I realized too late, after uploading several ridiculously large .gitignore files to AUR, that it's a huge waste of space (actually, you don't ''have to'' send .gitignore to AUR at all--but subsequent clones of your package will then not have a .gitignore). Putting an asterisk in it and using {{ic|git add -f}} is a better idea for the AUR's bandwidth and storage space. [[User:Quequotion|quequotion]] ([[User talk:Quequotion|talk]]) 17:55, 17 July 2017 (UTC)
 +
 +
== AUR search takes '%' literally ==
 +
 +
[[Arch User Repository#Searching]] is marked by [[template:Accuracy]], though I couldn't see the discussion here. Did I  missed something? There are some comments at [https://bbs.archlinux.org/viewtopic.php?id=226931 this forum thread]. [[User:Regid|Regid]] ([[User talk:Regid|talk]]) 14:21, 5 June 2017 (UTC)
 +
: I haven’t started the discussion, because I assume that the first person that has something to say should do that. Since all I had to say was stated in the {{ic|reason}}, I was not re-stating the problem here. Also I can’t fix that myself, because I have no idea how exactly AUR search works internally now and if this is just a bug or the current ''official'' status is that strings are taken literally. Therefore only marking it with [[Template:Accuracy]]. --[[User:Mpan|Mpan]] ([[User talk:Mpan|talk]]) 15:56, 5 June 2017 (UTC)

Latest revision as of 12:49, 11 August 2017

Warning about rebuilding your AUR packages

I thought at some point there was an explicit warning to the effect that rebuilding AUR packages against new official libraries was the individual's responsibility, not pacman's. I would like to see this reinstated at the top of the page as it is a constant source of confusion for new users. Jasonwryan (talk) 21:57, 24 November 2016 (UTC)

Another approach would be to add it to the top of the FAQ, and then split that out to a separate page, with a warning at the top of the AUR page sugesting that new users read the entirety of the FAQ 'before' installing anything from the AUR Jasonwryan (talk) 04:58, 27 November 2016 (UTC)

Is this a user's responsibility completely or the package maintainer's to increment pkgrel to indicate that the package should be rebuilt? This might fit to the explanation when (not) to use the "Out of date" button. -- Lahwaacz (talk) 08:21, 27 November 2016 (UTC)

AUR's history and future

Will part of Arch_User_Repository#AUR_4 be moved to Arch_User_Repository#History in a day or two? We should also remove / archive notes about the old AUR once it's read-only.

The article should also mention using git as an alternative to downloading the tarball. -- Karol (talk) 12:06, 7 August 2015 (UTC)

Part of this request has been fulfilled with [1]. — Kynikos (talk) 14:46, 9 August 2015 (UTC)

What is the correct AUR forum section?

Arch_User_Repository#Submitting_packages says it's [2], but we also have [3]. One of them should be added to Arch_User_Repository#I_have_a_PKGBUILD_I_would_like_to_submit.3B_can_someone_check_it_to_see_if_there_are_any_errors.3F. -- Karol (talk) 12:30, 7 August 2015 (UTC)

AUR link

The link to this page from the AUR homepage is outdated.

"Submitting packages" located above the SSH keys directs to an AUR4 link, which has since become just AUR. I'm not knowledgeable of the methods to correct this.

-- Ctag (talk) 00:05, 23 September 2015 (UTC)

You can submit a bug report for the AUR web interface project in the tracker. Or even provide a patch: sources are at [4]. -- Lahwaacz (talk) 11:22, 23 September 2015 (UTC)

gitignore

Adding * to .gitignore is an ugly workaround for something (in case of dotfiles, programs not respecting standards and e.g. storing cache and config files together). There isn't much to be excluded here - the only unpredictable part is the source tarballs and VCS directories, which can be easily put away by configuring SRCDEST in makepkg.conf. We can still recommend to add the source files explicitly.

The recommendation will affect everybody using the given package, not only the user managing his personal config files, so I think an explicit blacklist is better than the * wildcard here.

-- Lahwaacz (talk) 08:58, 6 March 2016 (UTC)

I agree, as per my original recommendation. The simple thing to do is git add .; some packages do have an annoying variety of files. Better to explicitly exclude download directories other known cruft in .gitignore. quequotion (talk) 12:15, 6 March 2016 (UTC)
So the concern is you'd miss to whitelist some "annoying variety" of files, which you wouldn't with git add .? You might as well argue that you'd miss to blacklist a file you wouldn't want to upload to the AUR...
Either way, I'd agree configuring SRCDEST is the better (and universal) solution here. -- Alad (talk) 15:05, 6 March 2016 (UTC)
Good point, the whole reason for posting a guide indeed is to show users how to deal with AUR4 in the way Archlinux administration expects, this seems to be the more reliable solution[
Then I remembered what SRCDEST actually does and realized it wouldn't sufficiently resolve the issue (the source directory is not the only cruft to be avoided). quequotion (talk) 03:55, 13 March 2016 (UTC)
I have SRCDEST, PKGDEST, LOGDEST, and BUILDDEST set. Suffice to say there's no cruft in my .git dirs. It's not much a bother either, since the values are commented in makepkg.conf. -- Alad (talk) 12:35, 13 March 2016 (UTC)
What about the symlinks to the built packages and signatures? -- Lahwaacz (talk) 13:04, 13 March 2016 (UTC)
Assuming only makepkg crates symlinks in the clone directory (correct me if I'm wrong), you can do something like find -maxdepth 2 -type l -delete in the directory above, in my case a dedicated "AURDEST".
Perhaps too specific for the general case, but the special type helps anyway. -- Alad (talk) 13:43, 13 March 2016 (UTC)
That's cleanup, not prevention. Anyway, the point of .gitignore is not to move the "cruft" away, but to keep the repo directory clean in git terms, i.e. git should not report files created by makepkg as untracked. -- Lahwaacz (talk) 11:48, 14 March 2016 (UTC)
In that case, I refer to my comment below on just mentioning .gitignore, but not recommending a specific method. -- Alad (talk) 19:47, 14 March 2016 (UTC)
Recommending either way is problematic since this is more a question of git usage style rather than AUR usage. The maintainer should set up the .gitignore in an intuitive way depending on their git workflow and how the package is organized. If I had to recommend anything, it would be either: don't git add . (because it's lazy and can easily backfire), or always check git status before you commit to make sure you know what's staged (and we already recommend checking your commits before pushing). But again, those are more general git recommendations than anything AUR-specific. Silverhammermba (talk) 21:58, 9 March 2016 (UTC)
Using gitignore is useful not only for the comfort of the maintainer, but also of users building and installing the package. For example if pkg/, src/ etc. are not gitignored, tools such as repocheck will not work correctly. -- Lahwaacz (talk) 23:05, 9 March 2016 (UTC)
I still don't see how that is AUR-specific information. It is certainly good practice to have a gitignore for any git repo with files you don't want to track, but it is by no means necessary nor is it a practice specific to AUR repos. Adding git tricks to this article that are just general best practices is a slippery slope to creating a duplicate git tutorial like Quequotion did. I would much rather direct users to https://git-scm.com/doc and emphasize the importance of learning git properly before contributing AUR packages. Silverhammermba (talk) 17:58, 10 March 2016 (UTC)
We know certain things could be .gitignored for every package, such as src/, pkg/, and *.pkg.tar.xz; but we cannot know what files a packager may be using otherwise. I think having packagers create an explicit blacklist is the smallest and easiest of the available options. quequotion (talk) 03:55, 13 March 2016 (UTC)
Stuff makepkg creates can be moved automatically, as indicated above. The rest is an edge case, and the best way to handle it is subject to debate. If anything, just mention .gitignore, but not a specific approach to using it. -- Alad (talk) 12:35, 13 March 2016 (UTC)
I've changed my mind, and my perspective on this issue. I realized too late, after uploading several ridiculously large .gitignore files to AUR, that it's a huge waste of space (actually, you don't have to send .gitignore to AUR at all--but subsequent clones of your package will then not have a .gitignore). Putting an asterisk in it and using git add -f is a better idea for the AUR's bandwidth and storage space. quequotion (talk) 17:55, 17 July 2017 (UTC)

AUR search takes '%' literally

Arch User Repository#Searching is marked by template:Accuracy, though I couldn't see the discussion here. Did I missed something? There are some comments at this forum thread. Regid (talk) 14:21, 5 June 2017 (UTC)

I haven’t started the discussion, because I assume that the first person that has something to say should do that. Since all I had to say was stated in the reason, I was not re-stating the problem here. Also I can’t fix that myself, because I have no idea how exactly AUR search works internally now and if this is just a bug or the current official status is that strings are taken literally. Therefore only marking it with Template:Accuracy. --Mpan (talk) 15:56, 5 June 2017 (UTC)