From b5d225145f89b7eab8f8877c95e57612d7cc4af4 Mon Sep 17 00:00:00 2001 From: Joshua Strobl Date: Thu, 2 Mar 2017 22:12:04 +0200 Subject: [PATCH] Resolve #20: Added documentation for updating an existing package. --- packaging/updating-an-existing-package/en.md | 35 ++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 packaging/updating-an-existing-package/en.md diff --git a/packaging/updating-an-existing-package/en.md b/packaging/updating-an-existing-package/en.md new file mode 100644 index 0000000..736d66d --- /dev/null +++ b/packaging/updating-an-existing-package/en.md @@ -0,0 +1,35 @@ ++++ +title = "Updating an Existing Package" ++++ +# Updating an Existing Package + +This article will go over updating a package that is already in the Solus git repository. + +The instructions below assume you have cloned the package's repository using the http link provided on the respective git page, [for example nano](https://git.solus-project.com/packages/nano). The process for submitting an updated package is the same as if it is a new package. Follow the steps [here](/articles/packaging/submitting-a-package/en). + +## Bumping a packaging + +Bumping a package is typically done when rebuilding against a changed dependency, such as `imagemagick` needing to be rebuilt if `libwebp` changes. Additionally, it is done if changes are being made to the package, such as additional new dependencies or other modifications. + +This can be achieved by doing `make bump`, which increments the release number by 1. + +## Updating a package + +To update the package to a newer version, use the `yupdate` too. This tool is located at `/usr/share/ypkg/yupdate.py` and while you can use it directly, we generally recommend setting an alias via your `.bashrc`, `.zshrc`, etc. + +``` bash +alias updatePackage='/usr/share/ypkg/yupdate.py' +``` + +This script takes two arguments, in the following order: + +1. Version +2. Source URL + +If you're updating the package to a newer version, naturally you would change both the version and source. If you're merely changing the source URL for the existing version, just pass the same version number and the new source URL. + +Example: + +``` bash +/usr/share/ypkg/yupdate.py 1.0 http://example.com/example-1.0.tar.xz +``` \ No newline at end of file