feat: Add the "DiffProg" option in arch-update.conf

README-fr.md

@@ -182,6 +182,7 @@ Codes de sortie :
 9  Erreur lors de la lecture du fichier de configuration avec l'option `--show-config`
 10 Erreur lors de la creation du fichier desktop autostart pour l'applet systray avec l'option `--tray --enable`
 11 Erreur lors du redémarrage des services nécessitant un redémarrage après mise à jour
+12 Erreur lors du traitement des fichiers pacnew
 ```
 
 Pour plus d'informations, consultez la page de manuel arch-update(1).  
@@ -206,6 +207,7 @@ Les options prises en charge sont :
 - KeepOldPackages=[Num] # Nombre d'anciennes versions de paquets à conserver dans le cache de pacman. La valeur par défaut est 3.
 - KeepUninstalledPackages=[Num] # Nombre de versions de paquets désinstallés à conserver dans le cache de pacman. La valeur par défaut est 0.
 - PrivilegeElevationCommand=[Cmd] # Commande à utiliser pour l'élévation de privilège. Les options valides sont `sudo`, `doas` ou `run0`. Si cette option n'est pas spécifiée, Arch-Update utilisera la première commande disponible dans l'odre suivant: `sudo`, `doas` puis `run0`.
+- DiffProg=[Editeur] # Editeur à utiliser pour visualiser/editer les différences durant le traitement des fichiers pacnew. La valeur par défaut est la valeur de la variable d'environnement `$DIFFPROG` (ou `vimdiff` si `$DIFFPROG` n'est pas paramétrée). Notez qu'en raison de l'absence d'option pour préserver les variables d'environnement dans `doas`, cette option sera ignorée lors de l'utilisation de `doas` comme méthode d'élévation de privilèges.
 
 Les options sont sensibles à la casse, les majuscules doivent donc être respectées.
 ```

README.md

@@ -182,6 +182,7 @@ Exit Codes:
 9  Error when reading the configuration file with the `--show-config` option
 10 Error when creating the autostart desktop file for the systray applet with the `--tray --enable` option
 11 Error when restarting services that require a post upgrade restart
+12 Error during the pacnew files processing
 ```
 
 For more information, see the arch-update(1) man page.  
@@ -206,6 +207,7 @@ The supported options are:
 - KeepOldPackages=[Num] # Number of old packages' versions to keep in pacman's cache. Defaults to 3.
 - KeepUninstalledPackages=[Num] # Number of uninstalled packages' versions to keep in pacman's cache. Defaults to 0.
 - PrivilegeElevationCommand=[Cmd] # Command to be used for privilege elevation. Valid options are `sudo`, `doas` or `run0`. If this option is not set, Arch-Update will use the first available command in the following order: `sudo`, `doas` then `run0`.
+- DiffProg=[Editor] # Editor to use to visualize/edit differences during the pacnew files processing. Defaults to the `$DIFFPROG` environment variable's value (or `vimdiff` if `$DIFFPROG` isn't set). Note that, due to the lack of option to preserve environment variable in `doas`, this option will be ignored when using `doas` as the privilege elevation method.
 
 Options are case sensitive, so capital letters have to be respected.
 ```

doc/man/arch-update.conf.5

@@ -1,4 +1,4 @@
-.TH "ARCH-UPDATE.CONF" "5" "June 2024" "Arch-Update 2.2.0" "Arch-Update Manual"
+.TH "ARCH-UPDATE.CONF" "5" "July 2024" "Arch-Update 2.2.0" "Arch-Update Manual"
 
 .SH NAME
 arch-update.conf \- arch-update configuration file.
@@ -47,6 +47,10 @@ Number of uninstalled packages' versions to keep in pacman's cache. Defaults to
 .B PrivilegeElevationCommand=[Cmd]
 Command to be used for privilege elevation. Valid options are sudo, doas or run0. If this option is not set, Arch-Update will use the first available command in the following order: sudo, doas then run0.
 
+.TP
+.B DiffProg=[Editor]
+.RB "Editor to use to visualize/edit differences during the pacnew files processing. Defaults to the " "$DIFFPROG " "environment variable's value (or " "vimdiff " "if " "$DIFFPROG " "isn't set). Note that, due to the lack of option to preserve environment variable in " "doas " ", this option will be ignored when using " "doas " " as the privilege elevation method."
+
 .SH SEE ALSO
 .BR arch-update (1)
 

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

@@ -1,4 +1,4 @@
-.TH "ARCH-UPDATE.CONF" "5" "Juin 2024" "Arch-Update 2.2.0" "Manuel de Arch-Update"
+.TH "ARCH-UPDATE.CONF" "5" "Juillet 2024" "Arch-Update 2.2.0" "Manuel de Arch-Update"
 
 .SH NAME
 arch-update.conf \- fichier de configuration pour arch-update.
@@ -47,6 +47,10 @@ Nombre de versions de paquets désinstallés à conserver dans le cache de pacma
 .B PrivilegeElevationCommand=[Cmd]
 Commande à utiliser pour l'élévation de privilège. Les options valides sont sudo, doas ou run0. Si cette option n'est pas spécifiée, Arch-Update utilisera la première commande disponible dans l'ordre suivant: sudo, doas puis run0.
 
+.TP
+.B DiffProg=[Editeur]
+.RB "Editeur à utiliser pour visualiser/editer les différences durant le traitement des fichiers pacnew. La valeur par défaut est la valeur de la variable d'environnement " "$DIFFPROG " "(ou " "vimdiff " "si " "$DIFFPROG " "n'est pas paramétrée). Notez qu'en raison de l'absence d'option pour préserver les variables d'environnement dans " "doas " ", cette option sera ignorée lors de l'utilisation de " "doas " "comme méthode d'élévation de privilèges."
+
 .SH VOIR AUSSI
 .BR arch-update (1)