Commit 93ddcfe8 authored by Seblu's avatar Seblu
Browse files

Refresh README

parent de3923ad
Loading
Loading
Loading
Loading
+12 −17
Original line number Original line Diff line number Diff line
@@ -5,14 +5,13 @@ ArchVersion


INTRODUCTION
INTRODUCTION
============
============
*archversion* is an upstream version of packages tracker against
*archversion* is a tool used to compare upstream and downstream versions of archlinux packages.


Downstream packages version can be found in:
- the *Archlinux* web site [#]_;
- the *Archlinux* web site [#]_;
- the *Archlinux* User Repository [#]_;
- the *Archlinux* User Repository [#]_;
- a local pacman databases;
- a local pacman databases;
- a local abs sync;
- a local abs sync.
- an ad-hoc local cache;
- nothing.


You can also use it to update a PKGBUILD to the upstream version.
You can also use it to update a PKGBUILD to the upstream version.


@@ -34,12 +33,14 @@ official repositories
You can find more complete examples in the misc/ directory.
You can find more complete examples in the misc/ directory.


Basically, you can run:
Basically, you can run:
*archversion check -d* to only display version which differ with cache.
*archversion sync* to fetch last versions from upstream and downstream.
*archversion check -n* to only display new verions.
*archversion report -n* to display new verions.
*archversion check -nd* to display new versions not in cache.
*archversion report -S acpid* to sync and display version report of the acpid package.
*archversion update* to update the current PKGBUILD to the last upstream version.


You can add the last one in a cron job to get a daily report of which packages
You can use systemd timers to get a report of packages which need updates:
need updates.
$ systemctl enable archversion.timer
$ systemctl start archversion.timer


To update a PKGBUILD to the last upstream version, run:
To update a PKGBUILD to the last upstream version, run:
$ archversion update
$ archversion update
@@ -50,8 +51,8 @@ As simple as possible! *archversion* retrieve the content of the provided upstre
webpage and search for well-known pattern. And then compare it to the reference.
webpage and search for well-known pattern. And then compare it to the reference.




COMPARING MODES
DOWNSTREAM MODES
===============
================


pacman
pacman
------
------
@@ -83,12 +84,6 @@ This is not responsible of syncing ABS tree. Please do it yourself.
This is **DANGEROUS** because PKGBUILD are *partially* executed to guess the package version!
This is **DANGEROUS** because PKGBUILD are *partially* executed to guess the package version!
So, prefer pacman mode!
So, prefer pacman mode!


cache
-----
This mode compare a remote upstream version against a local cached value from a
previous call. This mode could be called memory.
It can be useful to check package upgrades without having a package in repository.

none
none
----
----
This mode is a fake one, it only retrieves upstream version without any comparaison.
This mode is a fake one, it only retrieves upstream version without any comparaison.