User:Quequotion/AUR submission guidelines: Difference between revisions
Quequotion (talk | contribs) (→Rules of submission: Combine and simplify bullet points about duplicate packages) |
Quequotion (talk | contribs) (→Orphan: Give maintainers two weeks to respond *before* sending an orphan request (policy stated in →Arch User Repository#Foo in the AUR is outdated; what should I do?: )) |
||
Line 138: | Line 138: | ||
==== Orphan ==== | ==== Orphan ==== | ||
You may request that a {{ic|''pkgbase''}} be disowned. These requests will be granted after two weeks if the current maintainer did not react. | You may request that a {{ic|''pkgbase''}} be disowned if its maintainer is unresponsive for two weeks. These requests will be granted after two weeks if the current maintainer did not react. | ||
=== Promoting packages to the community repository === | === Promoting packages to the community repository === |
Revision as of 12:48, 21 July 2019
Users can share PKGBUILDs using the Arch User Repository. It does not contain any binary packages but allows users to upload PKGBUILD
s that can be downloaded by others. These PKGBUILD
s are completely unofficial and have not been thoroughly vetted, so they should be used at your own risk.
Submitting packages
If you are unsure in any way about a package or the build/submission process even after reading this section twice, submit the PKGBUILD for review.
Rules of submission
When submitting a package to the AUR, observe the following rules:
- Submitted
PKGBUILD
s must be in compliance with the licensing terms of the content to be packaged. In cases where it is mentioned that "you may not link" to downloads, i.e. contents that are not redistributable, you may only use the file name itself as the source. This means and requires that users already have the restricted source in the build directory prior to building the package. When in doubt, ask.
- Submitted
PKGBUILD
s must not duplicate packages in any of the official repositories or the AUR. Search the official package database and the AUR.
- If an official package is out-of-date, flag it as such. If it is broken, or lacking a standard feature, file a bug report.
- If an AUR package is currently maintained, changes can be submitted in a comment. If it is out-of-date, flag it as such. If the maintainer is unresponsive, the package may be orphaned and then adopted and updated as required.
- The only exception to this is for packages with extra features enabled and/or patches in comparison, in which case
pkgbase
must be different to express that. For example, a package for GNU screen containing the sidebar patch could be namedscreen-sidebar
. Additionally theprovides=('screen')
array should be used in order to avoid conflicts with the official package.
- Make sure the package you want to upload is useful. Will anyone else want to use this package? Is it extremely specialized? If more than a few people would find this package useful, it is appropriate for submission.
- The AUR and official repositories are intended for packages which install generally software and software-related content, including one or more of the following: executable(s); config file(s); online or offline documentation for specific software or the Arch Linux distribution as a whole; media intended to be used directly by software.
- Do not use
replaces
unless the package has been renamed or deprecates another, for example when Ethereal became Wireshark. If the package is an alternate version of an existing package, useconflicts
(andprovides
when the offending package has dependents).
- Submitting binaries should be avoided if the sources are available. The AUR should not contain binary tarballs created by makepkg, nor should it contain their filelists. Consult the Nonfree applications package guidelines regarding packages that redistribute prebuilt deliverables and the Java package guidelines regarding packages that redistribute java binaries.
- Add a comment line to the top of the
PKGBUILD
file which contains information about the current maintainers and previous contributors, respecting the following format. Remember to disguise your email to protect against spam. Additional or unneeded lines are facultative.
- If you are assuming the role of maintainer for an existing
PKGBUILD
, add your name to the top like this: # Maintainer: Your Name <address at domain dot tld>
- If there were previous maintainers, list them as contributors. The same applies for the original submitter if this is not you. If you are a co-maintainer, add the names of the other current maintainers as well.
# Maintainer: Your name <address at domain dot tld> # Maintainer: Other maintainer's name <address at domain dot tld> # Contributor: Previous maintainer's name <address at domain dot tld> # Contributor: Original submitter's name <address at domain dot tld>
Verifying packages
- To avoid problems caused by your particular system configuration, build packages in a clean chroot. If the build process still fails in a clean chroot, the issue is probably with the
PKGBUILD
.
- See Creating packages#Checking package sanity about using namcap to debug packages.
- If you would like to have a
PKGBUILD
reviewed, post it on the aur-general mailing list to get feedback from the TUs and fellow AUR members, or the Creating & Modifying Packages forum. You could also seek help in the IRC channel #archlinux-aur on Freenode.
Authentication
For write access to the AUR, you need to have an SSH key pair. The content of the public key needs to be copied to your profile in My Account, and the corresponding private key configured for the aur.archlinux.org
host. For example:
~/.ssh/config
Host aur.archlinux.org IdentityFile ~/.ssh/aur User aur
You should create a new key pair rather than use an existing one, so that you can selectively revoke the keys should something happen:
$ ssh-keygen -f ~/.ssh/aur
Creating or adopting package repositories
If you are creating a new package from scratch, or adopting an orphaned package, establish a local Git repository and an AUR remote by cloning the intended pkgbase. If the package does not yet exist, the following warning is expected:
$ git clone ssh://aur@aur.archlinux.org/pkgbase.git
Cloning into 'pkgbase'... warning: You appear to have cloned an empty repository. Checking connectivity... done.
pkgbase
matches a deleted package.If you already have a package, initialize it as a Git repository if it isn't one, and add an AUR remote:
$ git remote add label ssh://aur@aur.archlinux.org/pkgbase.git
Then fetch this remote to initialize it in the AUR.
pkgbase
matches a deleted package.Publishing new package content
git config user.name "..."
and git config user.email "..."
.To upload or update a package add at least PKGBUILD and .SRCINFO then any new or modified .install files, patches or other local source files; commit with a meaningful commit message, and finally push the changes to the AUR.
For example:
$ makepkg --printsrcinfo > .SRCINFO $ git add -f PKGBUILD .SRCINFO $ git commit -m "useful commit message" $ git push
- After modifying a package, except for very minor changes (such as fixing a typo) that would not require re-installation of the package, update its version accordingly.
- Regenerate
.SRCINFO
after updating suchPKGBUILD
metadata in order to publish it in the AUR. - If
.SRCINFO
was not added before your first commit, add it by rebasing with --root or filtering the tree so the AUR will permit your initial push.
Maintaining packages
- Check for feedback and comments from other users and try to incorporate any improvements they suggest; consider it a learning process!
- Do not leave a comment containing the version number every time you update the package. This keeps the comment section usable for valuable content mentioned above.
- Do not just submit and forget about packages! It is the maintainer's job to maintain the package by checking for updates and improving the
PKGBUILD
. - Additional maintainers can be added to or removed from a package by clicking "Manage Co-Maintainers" under "Package Actions" on the right of its AUR page and editing the list.
- If you do not want to continue to maintain the package for some reason, disown the package by clicking "Disown package" under "Package Actions" on the right of its AUR page and/or post a message to the AUR Mailing List. If all maintainers of an AUR package disown it, it will become an "orphaned" package.
- Orphaned packages can be adopted by clicking on the "Adopt Package" link under "Package Actions" on the right of its AUR page.
Requests
Deletion, merge, and orphan requests can be created by clicking on the "Submit Request" link under "Package Actions" on the right hand side. This will send a notification email to the current maintainer and to the aur-requests mailing list for discussion. A Trusted User will then either accept or reject the request.
Deletion
You may request to unlist a pkgbase
from the AUR. A short note explaining the reason for deletion is required, as well as supporting details (like when a package is provided by another package, if you are the maintainer yourself, it is renamed and the original owner agreed, etc).
Merge
You may request to delete a pkgbase
and transfer its votes and comments to another pkgbase
. The name of the package to merge into is required.
Orphan
You may request that a pkgbase
be disowned if its maintainer is unresponsive for two weeks. These requests will be granted after two weeks if the current maintainer did not react.
Promoting packages to the community repository
When AUR packages receive enough community interest and the support of a Trusted User, they may be adopted into the community repository (maintained by the TUs), from which binary packages can be installed using pacman.
Usually, at least 10 votes are required for something to move into community. However, if a TU wants to support a package, it will often be found in the repository.
Sufficient votes are not the only requirement; there has to be a TU willing to maintain the package. TUs are not required to adopt a package even if it has thousands of votes.
Usually, when a very popular package stays in the AUR it is because:
- Arch Linux already has another version of a package in the repositories.
- Its license prohibits redistribution.
- It helps retrieve user-submitted
PKGBUILD
s (AUR helpers).