Add the new -l/--list option to simply get the list of pending updates

README-fr.md

@@ -104,6 +104,7 @@ Si de nouvelles mises à jour sont disponibles, l'icône affichera une cloche et
 Lorsque l'on clique sur l'icône, cela lance la série de fonctions adéquates pour effectuer une mise à jour complète et correcte, en commençant par actualiser la liste des paquets disponibles pour la mise à jour, en l'affichant dans un terminal et en demandant la confirmation de l'utilisateur pour procéder à l'installation (elle peut également être lancée en exécutant la commande `arch-update`, nécessite [yay](https://aur.archlinux.org/packages/yay "yay") ou [paru](https://aur.archlinux.org/packages/paru "paru") pour la prise en charge de la mise à jour des paquets AUR et [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak/) pour la prise en charge de la mise à jour des paquets Flatpak) :
 
 *La sortie colorée peut être désactivée avec l'option `NoColor` dans le fichier de configuration `arch-update.conf`.*  
+*La liste des mises à jour en attente peut être affichées à tout moment en exécutant `arch-update -l` ou `arch-update --list`.*  
 *Les changements de versions dans la listing des paquets peuvent être masqués avec l'option `NoVersion` dans le fichier de configuration `arch-update.conf`.*  
 *Voir le [chapitre de documentation arch-update.conf](#Fichier-de-configuration-arch-update) pour plus de détails.*
 
@@ -170,6 +171,7 @@ de fichiers pacnew/pacsave et de mise à jour du noyau en attente et, s'il y en
 
 Options :
 -c, --check       Vérifier les mises à jour disponibles, envoyer une notification de bureau contenant le nombre de mises à jour disponibles (si libnotify est installé)
+-l, --list        Afficher la liste des mises à jour en attente
 -n, --news [Num]  Afficher les dernieres Arch News, vous pouvez optionellement spécifier le nombre de Arch news à afficher avec `--news [Num]` (e.g. `--news 10`)
 -h, --help        Afficher ce message d'aide et quitter
 -V, --version     Afficher les informations de version et quitter
@@ -182,6 +184,7 @@ Codes de sortie :
 4  L'utilisateur n'a pas donné la confirmation de procéder
 5  Erreur lors de la mise à jour des paquets
 6  Erreur lors de l'appel de la commande reboot pour appliquer une mise à jour du noyau en attente
+7  Aucune mise à jour en attente durant l'utilisation de l'option `-l/--list`
 ```
 
 Pour plus d'informations, consultez la page de manuel arch-update(1).  
@@ -199,7 +202,7 @@ ou "${HOME}/.config/arch-update/arch-update.conf".
 Les options prises en charge sont :
 
 - NoColor # Ne pas coloriser la sortie.
-- NoVersion # Ne pas afficher les modifications de versions des paquets lors du listing des mises à jour en attente.
+- NoVersion # Ne pas afficher les modifications de versions des paquets lors du listing des mises à jour en attente (y compris lors de l'utilisation de l'option `-l/--list`).
 - AlwaysShowNews # Toujours afficher les Arch news avant de mettre à jour, peu importe s'il y en a une nouvelle depuis la dernière exécution ou non.
 - NewsNum=[Num] # Nombre de Arch news à affcher avant la mise à jour et avec l'option `-n/--news` (voir la page de manuel arch-update(1) pour plus de details). La valeur par défaut est 5.
 - KeepOldPackages=[Num] # Nombre d'anciennes versions de paquets à conserver dans le cache de pacman. La valeur par défaut est 3.

README.md

@@ -102,6 +102,7 @@ If there are new available updates, the icon will show a bell sign and a desktop
 When the icon is clicked, it launches the relevant series of functions to perform a complete and proper update starting by refreshing the list of packages available for updates, display it inside a terminal window and asks for the user's confirmation to proceed with the installation (it can also be launched by running the `arch-update` command, requires [yay](https://aur.archlinux.org/packages/yay "yay") or [paru](https://aur.archlinux.org/packages/paru "paru") for AUR packages update support and [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak/) for Flatpak packages update support):
 
 *The colored output can be disabled with the `NoColor` option in the `arch-update.conf` configuration file.*  
+*The list of pending updates can be displayed at anytime by running `arch-update -l` or `arch-update --list`.*  
 *The versions changes in the packages listing can be hidden with the `NoVersion` option in the `arch-update.conf` configuration file.*  
 *See the [arch-update.conf documentation chapter](#arch-update-configuration-file) for more details.*
 
@@ -167,6 +168,7 @@ and pending kernel update and, if there are, offers to process them.
 
 Options:
 -c, --check       Check for available updates, send a desktop notification containing the number of available updates (if libnotify is installed)
+-l, --list        Display the list of pending updates
 -n, --news [Num]  Display latest Arch News, you can optionally specify the number of Arch news to display with `--news [Num]` (e.g. `--news 10`)
 -h, --help        Display this help message and exit
 -V, --version     Display version information and exit
@@ -179,6 +181,7 @@ Exit Codes:
 4  User didn't gave the confirmation to proceed
 5  Error when updating the packages
 6  Error when calling the reboot command to apply a pending kernel update
+7  No pending update when using the `-l/--list` option
 ```
 
 For more information, see the arch-update(1) man page.  
@@ -196,7 +199,7 @@ or "${HOME}/.config/arch-update/arch-update.conf".
 The supported options are:
 
 - NoColor # Do not colorize output.
-- NoVersion # Do not show versions changes for packages when listing pending updates.
+- NoVersion # Do not show versions changes for packages when listing pending updates (including when using the `-l/--list` option).
 - AlwaysShowNews # Always display Arch news before updating, regardless of whether there's a new one since the last run or not.
 - NewsNum=[Num] # Number of Arch news to display before updating and with the `-n/--news` option (see the arch-update(1) man page for more details). Defaults to 5.
 - KeepOldPackages=[Num] # Number of old packages' versions to keep in pacman's cache. Defaults to 3.

doc/man/arch-update.1

@@ -1,4 +1,4 @@
-.TH "ARCH-UPDATE" "1" "February 2024" "Arch-Update 1.12.1" "Arch-Update Manual"
+.TH "ARCH-UPDATE" "1" "March 2024" "Arch-Update 1.12.1" "Arch-Update Manual"
 
 .SH NAME
 arch-update \- An update notifier/applier for Arch Linux that assists you with important pre/post update tasks. 
@@ -38,6 +38,10 @@ Check for available updates and change the (.desktop) icon accordingly if there
 .br
 .B systemctl \-\-user enable \-\-now arch-update.timer
 
+.TP
+.B \-l, \-\-list
+Display the list of pending updates.
+
 .TP
 .B \-n, \-\-news
 Display latest Arch news.
@@ -136,6 +140,10 @@ Error when updating the packages
 .B 6
 Error when calling the reboot command to apply a pending kernel update
 
+.TP
+.B 7
+.RB "No pending update when using the " "-l/--list " "option"
+
 .SH SEE ALSO
 .BR checkupdates (8),
 .BR pacman (8),

doc/man/arch-update.conf.5

@@ -1,4 +1,4 @@
-.TH "ARCH-UPDATE.CONF" "5" "February 2024" "Arch-Update 1.12.1" "Arch-Update Manual"
+.TH "ARCH-UPDATE.CONF" "5" "March 2024" "Arch-Update 1.12.1" "Arch-Update Manual"
 
 .SH NAME
 arch-update.conf \- arch-update configuration file.
@@ -23,7 +23,7 @@ Do not colorize output.
 
 .TP
 .B NoVersion
-Do not show versions changes for packages when listing pending updates.
+.RB "Do not show versions changes for packages when listing pending updates (including when using the " "-l/--list " "option, see the " "arch-update(1) " "man page for more details)."
 
 .TP
 .B AlwaysShowNews

doc/man/fr/arch-update.1

@@ -1,4 +1,4 @@
-.TH "ARCH-UPDATE" "1" "Février 2024" "Arch-Update 1.12.1" "Manuel de Arch-Update"
+.TH "ARCH-UPDATE" "1" "Mars 2024" "Arch-Update 1.12.1" "Manuel de Arch-Update"
 
 .SH NAME
 arch-update \- Un notificateur/applicateur de mises à jour pour Arch Linux qui vous assiste dans les tâches importantes d'avant/après mise à jour.
@@ -38,6 +38,10 @@ Vérifier les mises à jour disponibles and changer l'icône (.desktop) en cons
 .br
 .B systemctl \-\-user enable \-\-now arch-update.timer
 
+.TP
+.B \-l, \-\-list
+Afficher la liste des mises à jour en attente.
+
 .TP
 .B \-n, \-\-news
 Afficher les dernières Arch news.
@@ -136,6 +140,10 @@ Erreur lors de la mise à jour des paquets
 .B 6
 Erreur lors de l'appel de la commande reboot pour appliquer une mise à jour du noyau en attente
 
+.TP
+.B 7
+.RB "Aucune mise à jour en attente durant l'utilisation de l'option " "-l/--list"
+
 .SH VOIR AUSSI
 .BR checkupdates (8),
 .BR pacman (8),

doc/man/fr/arch-update.conf.5

@@ -1,4 +1,4 @@
-.TH "ARCH-UPDATE.CONF" "5" "Février 2024" "Arch-Update 1.12.1" "Manuel de Arch-Update"
+.TH "ARCH-UPDATE.CONF" "5" "Mars 2024" "Arch-Update 1.12.1" "Manuel de Arch-Update"
 
 .SH NAME
 arch-update.conf \- fichier de configuration pour arch-update.
@@ -23,7 +23,7 @@ Ne pas coloriser la sortie.
 
 .TP
 .B NoVersion
-Ne pas afficher les modifications de versions des paquets lors du listing des mises à jour en attente.
+.RB "Ne pas afficher les modifications de versions des paquets lors du listing des mises à jour en attente (y compris lors de l'utilisation de l'option " "-l/--list" ", voir la page de man " "arch-update(1) " "pour plus de détails)."
 
 .TP
 .B AlwaysShowNews