Resolve #20: Added documentation for updating an existing package.
This commit is contained in:
parent
39ddd0ac23
commit
b5d225145f
|
@ -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
|
||||||
|
```
|
Reference in New Issue