Resolve #20: Added documentation for updating an existing package.

This commit is contained in:
Joshua Strobl 2017-03-02 22:12:04 +02:00
parent 39ddd0ac23
commit b5d225145f
No known key found for this signature in database
GPG Key ID: 3F6FD9A6B13E584D
1 changed files with 35 additions and 0 deletions

View File

@ -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
```