diff --git a/README-fr.md b/README-fr.md index efaf393..ddd6af2 100644 --- a/README-fr.md +++ b/README-fr.md @@ -18,19 +18,19 @@ ## Description -Un notificateur/applicateur de mises à jour pour Arch Linux qui vous assiste dans les tâches importantes d'avant/après mise à jour et qui inclut une applet systray cliquable pour une intégration facile avec n'importe quel panneau sur n'importe quel DE/WM. -Prise en charge optionnelle des paquets AUR/Flatpak et des notifications de bureau. +Un notificateur & applicateur de mises à jour pour Arch Linux qui vous assiste dans les tâches importantes d'avant / après mise à jour et qui inclut une applet systray cliquable pour une intégration facile avec n'importe quel panneau sur n'importe quel environnements de bureau / gestionnaire de fenêtres. +Prise en charge optionnelle des paquets AUR / Flatpak et des notifications de bureau. Arch-Update est conçu pour suivre les étapes usuelles de maintenance du système, telles que décrites dans le [Arch Wiki](https://wiki.archlinux.org/title/System_maintenance). Fonctionnalités : -- Inclut une applet systray cliquable qui change dynamiquement pour agir comme un notificateur/applicateur de mise à jour. Facile à intégrer avec n'importe quel panneau sur n'importe quel DE/WM. +- Inclut une applet systray cliquable qui change dynamiquement pour agir comme un notificateur & applicateur de mise à jour. Facile à intégrer avec n'importe quel panneau sur n'importe quel environnements de bureau & gestionnaire de fenêtres. - Vérification et listing automatiques de tous les paquets disponibles pour la mise à jour. - Propose d'afficher les news récentes d'Arch Linux avant d'appliquer les mises à jour. - Vérification et listing automatiques des paquets orphelins et propose de les supprimer. -- Vérification automatique de la présence d'anciens paquets et/ou paquets désinstallés dans le cache et propose de les supprimer. -- Listing et aide au traitement des fichiers pacnew/pacsave. +- Vérification automatique de la présence d'anciens paquets et / ou paquets désinstallés dans le cache et propose de les supprimer. +- Listing et aide au traitement des fichiers pacnew / pacsave. - Vérification automatique des mises à jour du noyau en attente nécessitant un redémarrage et propose de redémarrer s'il y en a une. - Vérification automatique des services nécessitant un redémarrage après mise à jour et propose de les redémarrer s'il y en a. - Support de `sudo`, `doas` et `run0`. @@ -64,7 +64,7 @@ Dépendances optionnelles supplémentaires dont vous pourriez avoir besoin ou qu Téléchargez l'archive de la [dernière version stable](https://github.com/Antiz96/arch-update/releases/latest) et extrayez la *(vous pouvez également cloner ce référentiel via `git clone`)*. -Pour installer `arch-update`, allez dans le répertoire extrait/cloné et exécutez la commande suivante : +Pour installer `arch-update`, allez dans le répertoire extrait / cloné et exécutez la commande suivante : ```bash sudo make install @@ -76,7 +76,7 @@ Si vous voulez exécuter des tests unitaires simples, vous pouvez exécuter la c make test ``` -Pour désinstaller `arch-update`, allez dans le répertoire extrait/cloné et exécutez la commande suivante : +Pour désinstaller `arch-update`, allez dans le répertoire extrait / cloné et exécutez la commande suivante : ```bash sudo make uninstall @@ -116,7 +116,7 @@ L'applet systray essaie de lire le fichier `arch-update.desktop` dans les chemin - `/usr/local/share/applications/arch-update.desktop` <-- Chemin d'installation par défaut lorsque vous installez Arch-Update [depuis la source](#depuis-la-source) - `/usr/share/applications/arch-update.desktop` <-- Chemin d'installation par défaut lorsque vous installez Arch-Update [depuis le AUR](#AUR) -Dans le cas où vous avez envie/besoin de personnaliser le fichier `arch-update.desktop`, copiez le dans un chemin qui a une priorité plus élevée que le chemin d'installation par défaut et modifier le ici (afin d'assurer que votre ficher `arch-update.desktop` personnalisé remplace celui par défaut et que vos modifications ne soient pas écrasées à chaque mise à jour). +Dans le cas où vous avez envie (ou besoin) de personnaliser le fichier `arch-update.desktop`, copiez le dans un chemin qui a une priorité plus élevée que le chemin d'installation par défaut et modifier le ici (afin d'assurer que votre ficher `arch-update.desktop` personnalisé remplace celui par défaut et que vos modifications ne soient pas écrasées à chaque mise à jour). Cela peut être utile pour forcer `Arch-Update` à se lancer avec un émulateur de terminal spécifique lorsque l'on clique sur l'applet systray. **Si cliquer sur l'applet systray ne fait rien**, veuillez lire [ce chapitre](#forcer-le-fichier-desktop-à-se-lancer-avec-un-émulateur-de-terminal-spécifique). @@ -139,7 +139,7 @@ C'est l'icône à droite de celle du wifi dans la capture d'écran ci-dessous: Avec [le systemd timer](#le-timer-systemd) activé, `Arch-Update` vérifie automatiquement les mises à jour au démarrage du système puis une fois chaque heure. La vérification peut être manuellement déclenchée en exécutant la commande `arch-update --check`. -Si de nouvelles mises à jour sont disponibles, l'icône systray affichera un cercle rouge et une notification de bureau indiquant le nombre de mises à jour disponibles sera envoyée s'il y a de nouvelles mises à jour depuis le dernier check (nécessite [libnotify/notify-send](https://archlinux.org/packages/extra/x86_64/libnotify/ "paquet libnotify") et un serveur de notification en cours d'exécution) : +Si de nouvelles mises à jour sont disponibles, l'icône systray affichera un cercle rouge et une notification de bureau indiquant le nombre de mises à jour disponibles sera envoyée s'il y a de nouvelles mises à jour depuis le dernier check (nécessite [libnotify](https://archlinux.org/packages/extra/x86_64/libnotify/ "paquet libnotify") et un serveur de notification en cours d'exécution) : ![notification-FR](https://github.com/Antiz96/arch-update/assets/53110319/28f0b95a-5b8a-43a5-bc3c-df42cd40d87b) @@ -157,22 +157,22 @@ Si aucune news n'a été publiée depuis la dernière exécution, `Arch-Update` Dans les deux cas, à partir de là, vous avez simplement à laisser `Arch-Update` vous guider à travers les différentes étapes requises pour une mise à jour complète et appropriée de votre système ! :smile: -Certaines options peuvent être activées/désactivées ou modifiées via 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. +Certaines options peuvent être activées, désactivées ou modifiées via 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. ## Documentation ### arch-update ```text -Un notificateur/applicateur de mises à jour pour Arch Linux qui vous assiste dans les -tâches importantes d'avant/après mise à jour. +Un notificateur & applicateur de mises à jour pour Arch Linux qui vous assiste dans les +tâches importantes d'avant / après mise à jour. Lancez arch-update pour exécuter la fonction principale « update » : Afficher la liste des paquets disponibles pour mise à jour, puis demander la confirmation de l'utilisateur pour procéder à l'installation. Avant d'effectuer la mise à jour, propose d'afficher les dernières Arch news. -Après la mise à jour, vérification de la présence de paquets orphelins/inutilisés, d'anciens paquets mis en cache, -de fichiers pacnew/pacsave, de mise à jour du noyau en attente ainsi que des services nécessitant un redémarrage après mise à jour +Après la mise à jour, vérification de la présence de paquets orphelins & inutilisés, d'anciens paquets mis en cache, +de fichiers pacnew & pacsave, de mise à jour du noyau en attente ainsi que des services nécessitant un redémarrage après mise à jour et, s'il y en a, propose de les traiter. Options : @@ -181,7 +181,7 @@ Options : -d, --devel Inclure les mises à jour des paquets de développement AUR -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`) -D, --debug Afficher les traces de débogage ---gen-config Générer un fichier de configuration `arch-update.conf` par défaut/exemple (voir la page de manuel arch-update.conf(5) pour plus de détails), vous pouvez optionnellement passer l'argument `--force` pour écraser un fichier de configuration `arch-update.conf` existant +--gen-config Générer un fichier de configuration `arch-update.conf` par défaut / exemple (voir la page de manuel arch-update.conf(5) pour plus de détails), vous pouvez optionnellement passer l'argument `--force` pour écraser un fichier de configuration `arch-update.conf` existant --show-config Afficher le fichier de configuration `arch-update.conf` actuellement utilisé (s'il existe) --edit-config Editer le fichier de configuration `arch-update.conf` actuellement utilisé (s'il existe) --tray Lancer l'applet systray d'Arch-Update, vous pouvez optionnellement ajouter l'argument `--enable` pour la démarrer automatiquement au démarrage du système. @@ -196,7 +196,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` +7 Aucune mise à jour en attente durant l'utilisation de l'option `-l / --list` 8 Erreur lors de la génération d'un fichier de configuration avec l'option `--gen-config` 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` @@ -208,30 +208,30 @@ Codes de sortie : ``` Pour plus d'informations, consultez la page de manuel arch-update(1). -Certaines options peuvent être activées/désactivées ou modifiées via le fichier de configuration arch-update.conf, voir la page de manuel arch-update.conf(5). +Certaines options peuvent être activées, désactivées ou modifiées via le fichier de configuration arch-update.conf, voir la page de manuel arch-update.conf(5). ### Fichier de configuration arch-update ```text Le fichier arch-update.conf est un fichier de configuration facultatif pour arch-update permettant -d'activer/désactiver ou modifier certaines options dans le script. +d'activer, désactiver ou modifier certaines options dans le script. Ce fichier de configuration doit se trouver dans "${XDG_CONFIG_HOME}/arch-update/arch-update.conf" ou "${HOME}/.config/arch-update/arch-update.conf". -Un fichier de configuration par défaut/exemple peut être généré en exécutant : `arch-update --gen-config` +Un fichier de configuration par défauti / exemple peut être généré en exécutant : `arch-update --gen-config` 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 (y compris lors de l'utilisation de l'option `-l/--list`). +- 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. +- 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. - AURHelper=[AUR Helper] # AUR helper à utiliser pour la prise en charge des paquets AUR. Les valeurs valides sont `paru` ou `yay`. Si cette option n'est pas spécifiée, Arch-Update utilisera le premier AUR helper disponible dans l'ordre suivant : `paru` puis `yay` (si aucun des deux n'est installé, Arch-Update ne prendra pas en compte les paquets AUR). - PrivilegeElevationCommand=[Cmd] # Commande à utiliser pour l'élévation de privilège. Les valeurs 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`. - 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. -- 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. -- TrayIconStyle=[Style/Color] # Style à utiliser pour l'icône de l'applet systray. Les valeurs valides sont les variantes de style/couleur disponibles pour le set d'icône, listées ici : https://github.com/Antiz96/arch-update/tree/main/src/icons. La valeur par défaut est "light". +- 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. +- TrayIconStyle=[Style / Color] # Style à utiliser pour l'icône de l'applet systray. Les valeurs valides sont les variantes de style / couleur disponibles pour le set d'icône, listées ici : https://github.com/Antiz96/arch-update/tree/main/res/icons. La valeur par défaut est "light". Les options sont sensibles à la casse, les majuscules doivent donc être respectées. ``` @@ -289,7 +289,7 @@ Par exemple, avec [alacritty](https://alacritty.org/) *(vérifier le manuel de v Exec=alacritty -e arch-update ``` -Alternativement, vous pouvez créer un lien symbolique de votre émulateur de terminal pointant vers `/usr/bin/xterm`, qui est l'option de "secours" pour `gio` (par exemple, avec [alacritty](https://alacritty.org) : `sudo ln -s /usr/bin/alacritty /usr/bin/xterm`) ou vous pouvez simplement installer un des émulateurs de terminal [connus/supportés](https://gitlab.gnome.org/GNOME/glib/-/blob/main/gio/gdesktopappinfo.c#L2694) par `gio`. +Alternativement, vous pouvez créer un lien symbolique de votre émulateur de terminal pointant vers `/usr/bin/xterm`, qui est l'option de "secours" pour `gio` (par exemple, avec [alacritty](https://alacritty.org) : `sudo ln -s /usr/bin/alacritty /usr/bin/xterm`) ou vous pouvez simplement installer un des émulateurs de terminal [supportés](https://gitlab.gnome.org/GNOME/glib/-/blob/main/gio/gdesktopappinfo.c#L2701) par `gio`. ## Contribuer diff --git a/README.md b/README.md index 6ca5ec7..890a524 100644 --- a/README.md +++ b/README.md @@ -18,19 +18,19 @@ ## Description -An update notifier/applier for Arch Linux that assists you with important pre/post update tasks and that includes a clickeable systray applet for an easy integration with any panel on any DE/WM. -Optional support for AUR/Flatpak packages and desktop notifications. +An update notifier & applier for Arch Linux that assists you with important pre / post update tasks and that includes a clickeable systray applet for an easy integration with any panel on any Desktop Environment / Window Manager. +Optional support for AUR / Flatpak packages and desktop notifications. Arch-Update is designed to follow usual system maintenance steps, as described in the [Arch Wiki](https://wiki.archlinux.org/title/System_maintenance). Features: -- Includes a clickeable systray applet that dynamically changes to act as an update notifier/applier. Easy to integrate with any panel on any DE/WM. +- Includes a clickeable systray applet that dynamically changes to act as an update notifier & applier. Easy to integrate with any panel on any Desktop Environment & Window Manager. - Automatic check and listing of every packages available for update. - Offers to display the latest Arch Linux news before applying updates. - Automatic check and listing of orphan packages and offers to remove them. -- Automatic check for old and/or uninstalled cached packages and offers to remove them. -- Lists and helps you processing pacnew/pacsave files. +- Automatic check for old and / or uninstalled cached packages and offers to remove them. +- Lists and helps you processing pacnew & pacsave files. - Automatic check for pending kernel updates requiring a reboot to be applied and offers to do so if there's one. - Automatic check for services requiring a post upgrade restart and offers to do so if there are. - Support for `sudo`, `doas` & `run0`. @@ -64,7 +64,7 @@ Additional optional dependencies you might need or want: Download the archive of the [latest stable release](https://github.com/Antiz96/arch-update/releases/latest) and extract it *(alternatively, you can clone this repository via `git clone`)*. -To install `arch-update`, go into the extracted/cloned directory and run the following command: +To install `arch-update`, go into the extracted / cloned directory and run the following command: ```bash sudo make install @@ -76,7 +76,7 @@ If you want to run simple unit tests, you can run the following command (require make test ``` -To uninstall `arch-update`, go into the extracted/cloned directory and run the following command: +To uninstall `arch-update`, go into the extracted / cloned directory and run the following command: ```bash sudo make uninstall @@ -116,7 +116,7 @@ The systray applet attempts to read the `arch-update.desktop` file at the below - `/usr/local/share/applications/arch-update.desktop` <-- Default installation path when installing Arch-Update [from source](#from-source) - `/usr/share/applications/arch-update.desktop` <-- Default installation path when installing Arch-Update [from the AUR](#AUR) -In case you want/need to customize the `arch-update.desktop` file, copy it in a path that has a higher priority than the default installation path and modify it there (to ensure that your custom `arch-update.desktop` file supersedes the default one and that your modifications are not being overwritten on updates). +In case you want (or need) to customize the `arch-update.desktop` file, copy it in a path that has a higher priority than the default installation path and modify it there (to ensure that your custom `arch-update.desktop` file supersedes the default one and that your modifications are not being overwritten on updates). This can be useful to force `Arch-Update` to launch with a specific terminal emulator when clicking the systray applet for instance. **If clicking the systray applet does nothing**, please read [this chapter](#force-the-desktop-file-to-run-with-a-specific-terminal-emulator). @@ -157,21 +157,21 @@ If no news has been published since the last run, `Arch-Update` will directly pr In both cases, from there, you just have to let `Arch-Update` guide you through the various steps required for a complete and proper update of your system! :smile: -Certain options can be enabled/disabled or modified via the `arch-update.conf` configuration file. See the [arch-update.conf documentation chapter](#arch-update-configuration-file) for more details. +Certain options can be enabled, disabled or modified via the `arch-update.conf` configuration file. See the [arch-update.conf documentation chapter](#arch-update-configuration-file) for more details. ## Documentation ### arch-update ```text -An update notifier/applier for Arch Linux that assists you with -important pre/post update tasks. +An update notifier & applier for Arch Linux that assists you with +important pre / post update tasks. Run arch-update to perform the main "update" function: Display the list of packages available for update, then ask for the user's confirmation to proceed with the installation. Before performing the update, offer to display the latest Arch Linux news. -Post update, check for orphan/unused packages, old cached packages, pacnew/pacsave files, +Post update, check for orphan & unused packages, old cached packages, pacnew & pacsave files, pending kernel update, as well as services requiring a post upgrade restart and, if there are, offers to process them. @@ -181,7 +181,7 @@ Options: -d, --devel Include AUR development packages 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`) -D, --debug Display debug traces ---gen-config Generate a default/example `arch-update.conf` configuration file (see the arch-update.conf(5) man page for more details), you can optionally pass the `--force` argument to overwrite any existing `arch-update.conf` configuration file +--gen-config Generate a default / example `arch-update.conf` configuration file (see the arch-update.conf(5) man page for more details), you can optionally pass the `--force` argument to overwrite any existing `arch-update.conf` configuration file --show-config Display the `arch-update.conf` configuration file currently used (if it exists) --edit-config Edit the `arch-update.conf` configuration file currently used (if it exists) --tray Launch the Arch-Update systray applet, you can optionally add the `--enable` argument to start it automatically at boot. @@ -196,7 +196,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 +7 No pending update when using the `-l / --list` option 8 Error when generating a configuration file with the `--gen-config` option 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 @@ -208,30 +208,30 @@ Exit Codes: ``` For more information, see the arch-update(1) man page. -Certain options can be enabled/disabled or modified via the arch-update.conf configuration file, see the arch-update.conf(5) man page. +Certain options can be enabled, disabled or modified via the arch-update.conf configuration file, see the arch-update.conf(5) man page. ### arch-update configuration file ```text -The arch-update.conf file is an optional configuration file for arch-update to enable/disable +The arch-update.conf file is an optional configuration file for arch-update to enable, disable or modify certain options within the script. This configuration file has to be located in "${XDG_CONFIG_HOME}/arch-update/arch-update.conf" or "${HOME}/.config/arch-update/arch-update.conf". -A default/example configuration file can be generated by running: `arch-update --gen-config` +A default / example configuration file can be generated by running: `arch-update --gen-config` The supported options are: - NoColor # Do not colorize output. -- NoVersion # Do not show versions changes for packages when listing pending updates (including when using the `-l/--list` option). +- 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. +- 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. - AURHelper=[AUR Helper] # AUR helper to be used for AUR packages support. Valid values are `paru` or `yay`. If this option is not set, Arch-Update will use the first available AUR helper in the following order: `paru` then `yay` (in case none of them is installed, Arch-Update will not take AUR packages into account). - PrivilegeElevationCommand=[Cmd] # Command to be used for privilege elevation. Valid values 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`. - 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. -- 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. -- TrayIconStyle=[Style/Color] # Style to be used for the systray applet icon. Valid values are the available style/color variants for the icon set, listed in https://github.com/Antiz96/arch-update/tree/main/src/icons. Defaults to "light". +- 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. +- TrayIconStyle=[Style / Color] # Style to be used for the systray applet icon. Valid values are the available style / color variants for the icon set, listed in https://github.com/Antiz96/arch-update/tree/main/res/icons. Defaults to "light". Options are case sensitive, so capital letters have to be respected. ``` @@ -289,7 +289,7 @@ For instance, with [alacritty](https://alacritty.org/) *(check your terminal emu Exec=alacritty -e arch-update ``` -Alternatively, you can create a symlink for your terminal emulator that points to `/usr/bin/xterm`, which is the fallback option for `gio` (for instance, with [alacritty](https://alacritty.org): `sudo ln -s /usr/bin/alacritty /usr/bin/xterm`) or you can simply install one of the terminal emulators [known/supported](https://gitlab.gnome.org/GNOME/glib/-/blob/main/gio/gdesktopappinfo.c#L2694) by `gio`. +Alternatively, you can create a symlink for your terminal emulator that points to `/usr/bin/xterm`, which is the fallback option for `gio` (for instance, with [alacritty](https://alacritty.org): `sudo ln -s /usr/bin/alacritty /usr/bin/xterm`) or you can simply install one of the terminal emulators [supported](https://gitlab.gnome.org/GNOME/glib/-/blob/main/gio/gdesktopappinfo.c#L2701) by `gio`. ## Contributing diff --git a/doc/man/arch-update.1 b/doc/man/arch-update.1 index bdbef4e..2a3e9b0 100644 --- a/doc/man/arch-update.1 +++ b/doc/man/arch-update.1 @@ -1,14 +1,14 @@ .TH "ARCH-UPDATE" "1" "September 2024" "Arch-Update 3.1.1" "Arch-Update Manual" .SH NAME -arch-update \- An update notifier/applier for Arch Linux that assists you with important pre/post update tasks. +arch-update \- An update notifier & applier for Arch Linux that assists you with important pre / post update tasks. .SH SYNOPSIS .B arch-update [\fI\,OPTION\/\fR] .SH DESCRIPTION -An update notifier/applier for Arch Linux that assists you with important pre/post update tasks and that includes a clickeable systray applet for an easy integration with any panel on any DE/WM. +An update notifier & applier for Arch Linux that assists you with important pre / post update tasks and that includes a clickeable systray applet for an easy integration with any panel on any Desktop Environment / Window Manager. .br .RB "Optional support for AUR packages update (through " "yay " "or " "paru" "), Flatpak packages update (through " "flatpak" ") and desktop notifications (through " "libnotify" ")." .br @@ -22,7 +22,7 @@ If no option is passed, launch the relevant series of functions to perform a com .br Before performing the update, it offers to display the latest Arch Linux news to the user. By default, Arch news are only displayed if at least a new one has been published since the last run. Arch news published since the last run or at the same date are tagged as '[NEW]'. .br -Arch-Update also checks for orphan packages, unused Flatpak packages, old and/or uninstalled cached packages in pacman's cache, pacnew/pacsave files, pending kernel update requiring a reboot to be applied as well as services requiring a post upgrade restart and, if there are, offers to process them. +Arch-Update also checks for orphan packages, unused Flatpak packages, old and / or uninstalled cached packages in pacman's cache, pacnew & pacsave files, pending kernel update requiring a reboot to be applied as well as services requiring a post upgrade restart and, if there are, offers to process them. .br Those functions are launched when you click on the systray applet. @@ -60,7 +60,7 @@ Display debug traces. .TP .B \-\-gen\-config -.RB "Generate a default/example " "arch-update.conf " "configuration file (see the " "arch-update.conf(5) " "man page for more details)." +.RB "Generate a default / example " "arch-update.conf " "configuration file (see the " "arch-update.conf(5) " "man page for more details)." .br .RB "You can optionally pass the " "--force " "argument to overwrite any existing " "arch-update.conf " "configuration file." @@ -89,7 +89,7 @@ Display version information. Display the help message. .TP -.RB "Certain options can be enabled/disabled or modified via the " "arch-update.conf " "configuration file, see the " "arch-update.conf(5) " "man page." +.RB "Certain options can be enabled, disabled or modified via the " "arch-update.conf " "configuration file, see the " "arch-update.conf(5) " "man page." .SH USAGE .TP @@ -110,7 +110,7 @@ Display the help message. .br \- /usr/share/applications/arch-update.desktop <-- Default installation path when installing Arch-Update from the AUR -.RB "In case you want/need to customize the " "arch-update.desktop " "file, copy it in a path that has a higher priority than the default installation path and modify it there (to ensure that your custom " "arch-update.desktop " "file supersedes the default one and that your modifications are not being overwritten on updates)." +.RB "In case you want (or need) to customize the " "arch-update.desktop " "file, copy it in a path that has a higher priority than the default installation path and modify it there (to ensure that your custom " "arch-update.desktop " "file supersedes the default one and that your modifications are not being overwritten on updates)." .br .RB "This can be useful to force the " "arch-update.desktop " "file to launch " "Arch-Update " "within a specific terminal emulator for instance." @@ -173,7 +173,7 @@ See https://www.freedesktop.org/software/systemd/man/latest/systemd.time.html#Pa .TP .B Force the desktop file to run with a specific terminal emulator -.BR "gio " "(which is used to launch the " "arch-update.desktop " "file when the systray applet is clicked) currently supports a limited list of terminal emulators (see https://gitlab.gnome.org/GNOME/glib/-/blob/main/gio/gdesktopappinfo.c#L2694). +.BR "gio " "(which is used to launch the " "arch-update.desktop " "file when the systray applet is clicked) currently supports a limited list of terminal emulators (see https://gitlab.gnome.org/GNOME/glib/-/blob/main/gio/gdesktopappinfo.c#L2701). .br .RB "If you don't have any of these terminal emulators installed on your system, you might face an issue where clicking the systray applet does nothing and reports the following error: " "[...] Unable to find terminal required for application". @@ -188,7 +188,7 @@ See https://www.freedesktop.org/software/systemd/man/latest/systemd.time.html#Pa .RB "Exec=" "alacritty -e " "arch-update" .br -.RB "Alternatively, you can create a symlink for your terminal emulator that points to " "/usr/bin/xterm" ", which is the fallback option for " "gio " "(for instance, with " "alacritty" ": " "sudo ln -s /usr/bin/alacritty /usr/bin/xterm" ") or you can simply install one of the terminal emulators known/supported by " "gio " "(see https://gitlab.gnome.org/GNOME/glib/-/blob/main/gio/gdesktopappinfo.c#L2694)." +.RB "Alternatively, you can create a symlink for your terminal emulator that points to " "/usr/bin/xterm" ", which is the fallback option for " "gio " "(for instance, with " "alacritty" ": " "sudo ln -s /usr/bin/alacritty /usr/bin/xterm" ") or you can simply install one of the terminal emulators supported by " "gio " "(see https://gitlab.gnome.org/GNOME/glib/-/blob/main/gio/gdesktopappinfo.c#L2701)." .SH EXIT STATUS .TP @@ -221,7 +221,7 @@ 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" +.RB "No pending update when using the " "-l / --list " "option" .TP .B 8 diff --git a/doc/man/arch-update.conf.5 b/doc/man/arch-update.conf.5 index 5f3f4ee..14990e2 100644 --- a/doc/man/arch-update.conf.5 +++ b/doc/man/arch-update.conf.5 @@ -11,7 +11,7 @@ $XDG_CONFIG_HOME/arch-update/arch-update.conf, $HOME/.config/arch-update/arch-up .RB "Arch-Update first attempts to read the file at " "$XDG_CONFIG_HOME/arch-update/arch-update.conf " "then at " "$HOME/.config/arch-update/arch-update.conf " "if " "$XDG_CONFIG_HOME " "is not set, or the file doesn't exist." .br -.RB "A default/example configuration file can be generated by running: " "arch-update --gen-config" +.RB "A default / example configuration file can be generated by running: " "arch-update --gen-config" .SH OPTIONS .PP @@ -25,7 +25,7 @@ Do not colorize output. .TP .B NoVersion -.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)." +.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 @@ -33,7 +33,7 @@ Always display Arch news before updating, regardless of whether there's a new on .TP .B NewsNum=[Num] -.RB "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." +.RB "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." .TP .B AURHelper=[AUR Helper] @@ -53,11 +53,11 @@ Number of uninstalled packages' versions to keep in pacman's cache. Defaults to .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." +.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." .TP -.B TrayIconStyle=[Style/Color] -Style to be used for the systray applet icon. Valid values are the available style/color variants for the icon set, listed in https://github.com/Antiz96/arch-update/tree/main/src/icons. Defaults to "light". +.B TrayIconStyle=[Style / Color] +Style to be used for the systray applet icon. Valid values are the available style / color variants for the icon set, listed in https://github.com/Antiz96/arch-update/tree/main/res/icons. Defaults to "light". .SH SEE ALSO .BR arch-update (1) diff --git a/doc/man/fr/arch-update.1 b/doc/man/fr/arch-update.1 index abdef7e..cabfe44 100644 --- a/doc/man/fr/arch-update.1 +++ b/doc/man/fr/arch-update.1 @@ -1,14 +1,14 @@ .TH "ARCH-UPDATE" "1" "Septembre 2024" "Arch-Update 3.1.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. +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. .SH SYNOPSIS .B arch-update [\fI\,OPTION\/\fR] .SH DESCRIPTION -Un notificateur/applicateur de mises à jour pour Arch Linux qui vous assiste dans les tâches importantes d'avant/après mise à jour et qui inclut une applet systray cliquable pour une intégration facile avec n'importe quel panneau sur n'importe quel DE/WM. +Un notificateur & applicateur de mises à jour pour Arch Linux qui vous assiste dans les tâches importantes d'avant / après mise à jour et qui inclut une applet systray cliquable pour une intégration facile avec n'importe quel panneau sur n'importe quel environnements de bureau ou gestionnaire de fenêtres. .br .RB "Prise en charge optionnelle des mises à jour des paquets AUR (via " "yay " "or " "paru" "), des mises à jour des paquets Flatpak (via " "flatpak" ") et des notifications de bureau (via " "libnotify" ")." .br @@ -22,7 +22,7 @@ Si aucune option n'est passée, lance la série de fonctions adéquates pour eff .br Avant d'effectuer la mise à jour, propose d'afficher les dernières Arch news à l'utilisateur. Par défaut, les Arch news sont seulement affichées si au moins une nouvelle news a été publiée depuis la dernière exécution. Les Arch news publiées depuis la dernière exécution ou à la même date sont étiquetées comme '[NOUVEAU]'. .br -Arch-Update vérifie aussi la présence de paquets orphelins/inutilisés, d'anciens paquets mis en cache, de fichiers pacnew/pacsave, les mises à jour du noyau en attente ainsi que les services nécessitant un redémarrage après mise à jour et, s'il y en a, propose de les traiter. +Arch-Update vérifie aussi la présence de paquets orphelins & inutilisés, d'anciens paquets mis en cache, de fichiers pacnew & pacsave, les mises à jour du noyau en attente ainsi que les services nécessitant un redémarrage après mise à jour et, s'il y en a, propose de les traiter. .br Ces fonctions sont lancées quand vous cliquez sur l'applet systray. @@ -60,7 +60,7 @@ Afficher les traces de débogage. .TP .B \-\-gen\-config -.RB "Générer un fichier de configuration " "arch-update.conf " "par défaut/exemple (voir la page de manuel " "arch-update.conf(5) " "pour plus de détails)." +.RB "Générer un fichier de configuration " "arch-update.conf " "par défaut / exemple (voir la page de manuel " "arch-update.conf(5) " "pour plus de détails)." .br .RB "Vous pouvez optionnellement passer l'argument " "--force " "pour écraser un fichier de configuration " "arch-update.conf " "existant." @@ -89,7 +89,7 @@ Afficher les informations de version. Afficher le message d'aide. .TP -.RB "Certaines options peuvent être activées/désactivées ou modifiées via le fichier de configuration " "arch-update.conf " ", voir la page de manuel " "arch-update.conf(5)". +.RB "Certaines options peuvent être activées, désactivées ou modifiées via le fichier de configuration " "arch-update.conf " ", voir la page de manuel " "arch-update.conf(5)". .SH UTILISATION .TP @@ -110,7 +110,7 @@ Afficher le message d'aide. .br \- /usr/share/applications/arch-update.desktop <-- Chemin d'installation par défaut lorsque vous installez Arch-Update depuis le AUR -.RB "Dans le cas où vous avez envie/besoin de personnaliser le fichier " "arch-update.desktop" ", copiez le dans un chemin qui a une priorité plus élevée que le chemin d'installation par défaut et modifier le ici (afin d'assurer que votre ficher " "arch-update.desktop " "personnalisé remplace celui par défaut et que vos modifications ne soient pas écrasées à chaque mise à jour)." +.RB "Dans le cas où vous avez envie (ou besoin) de personnaliser le fichier " "arch-update.desktop" ", copiez le dans un chemin qui a une priorité plus élevée que le chemin d'installation par défaut et modifier le ici (afin d'assurer que votre ficher " "arch-update.desktop " "personnalisé remplace celui par défaut et que vos modifications ne soient pas écrasées à chaque mise à jour)." .br .RB "Cela peut être utile pour forcer le fichier " "arch-update.desktop " "à lancer " "Arch-Update " "dans un émulateur de terminal spécifique par exemple." @@ -173,7 +173,7 @@ Voir https://www.freedesktop.org/software/systemd/man/latest/systemd.time.html#P .TP .B Forcer le fichier desktop à se lancer avec un émulateur de terminal spécifique -.BR "gio " "(qui est utilisé pour lancer le fichier " "arch-update.desktop " "quand l'applet systray est cliquée) ne supporte actuellement qu'une liste limitée d'émulateurs de terminal (voir https://gitlab.gnome.org/GNOME/glib/-/blob/main/gio/gdesktopappinfo.c#L2694)." +.BR "gio " "(qui est utilisé pour lancer le fichier " "arch-update.desktop " "quand l'applet systray est cliquée) ne supporte actuellement qu'une liste limitée d'émulateurs de terminal (voir https://gitlab.gnome.org/GNOME/glib/-/blob/main/gio/gdesktopappinfo.c#L2701)." .br .RB "Si vous n'avez aucun de ces émulateurs de terminal installé sur votre système, il se peut que vous soyez confronté à un problème où cliquer sur l'applet systray ne fait rien et rapporte l'erreur suivante : " "[...] Unable to find terminal required for application". @@ -188,7 +188,7 @@ Voir https://www.freedesktop.org/software/systemd/man/latest/systemd.time.html#P .RB "Exec=" "alacritty -e " "arch-update" .br -.RB "Alternativement, vous pouvez créer un lien symbolique de votre émulateur de terminal pointant vers " "/usr/bin/xterm" ", qui est l'option de 'secours' pour " "gio " "(par exemple, avec " "alacritty" ": " "sudo ln -s /usr/bin/alacritty /usr/bin/xterm" ") ou vous pouvez simplement installer un des émulateurs de terminal connus/supportés par " "gio " "(voir https://gitlab.gnome.org/GNOME/glib/-/blob/main/gio/gdesktopappinfo.c#L2694)." +.RB "Alternativement, vous pouvez créer un lien symbolique de votre émulateur de terminal pointant vers " "/usr/bin/xterm" ", qui est l'option de 'secours' pour " "gio " "(par exemple, avec " "alacritty" ": " "sudo ln -s /usr/bin/alacritty /usr/bin/xterm" ") ou vous pouvez simplement installer un des émulateurs de terminal supportés par " "gio " "(voir https://gitlab.gnome.org/GNOME/glib/-/blob/main/gio/gdesktopappinfo.c#L2701)." .SH EXIT STATUS .TP diff --git a/doc/man/fr/arch-update.conf.5 b/doc/man/fr/arch-update.conf.5 index 6b8cb92..c19ebf6 100644 --- a/doc/man/fr/arch-update.conf.5 +++ b/doc/man/fr/arch-update.conf.5 @@ -11,7 +11,7 @@ $XDG_CONFIG_HOME/arch-update/arch-update.conf, $HOME/.config/arch-update/arch-up .RB "Arch-Update tente d'abord de lire le fichier sous " "$XDG_CONFIG_HOME/arch-update/arch-update.conf " "puis sous " "$HOME/.config/arch-update/arch-update.conf " "si " "$XDG_CONFIG_HOME " "n'est pas paramétré, ou que le fichier n'existe pas." .br -.RB "Un fichier de configuration par défaut/exemple peut être généré en exécutant : " "arch-update --gen-config" +.RB "Un fichier de configuration par défaut / exemple peut être généré en exécutant : " "arch-update --gen-config" .SH OPTIONS .PP @@ -25,7 +25,7 @@ Ne pas coloriser la sortie. .TP .B NoVersion -.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)." +.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 @@ -33,7 +33,7 @@ Toujours afficher les Arch news avant de mettre à jour, peu importe s'il y en a .TP .B NewsNum=[Num] -.RB "Nombre de Arch news à afficher avant la mise à jour et avec l'option " "-n/--news " "(voir la page de man " "arch-update(1) " "pour plus de détails). La valeur par défaut est 5." +.RB "Nombre de Arch news à afficher avant la mise à jour et avec l'option " "-n / --news " "(voir la page de man " "arch-update(1) " "pour plus de détails). La valeur par défaut est 5." .TP .B AURHelper=[AUR Helper] @@ -53,11 +53,11 @@ Nombre de versions de paquets désinstallés à conserver dans le cache de pacma .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." +.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." .TP -.B TrayIconStyle=[Style/Color] -Style à utiliser pour l'icône de l'applet systray. Les valeurs valides sont les variantes de style/couleur disponibles pour le set d'icône, listées ici : https://github.com/Antiz96/arch-update/tree/main/src/icons. La valeur par défaut est "light". +.B TrayIconStyle=[Style / Color] +Style à utiliser pour l'icône de l'applet systray. Les valeurs valides sont les variantes de style / couleur disponibles pour le set d'icône, listées ici : https://github.com/Antiz96/arch-update/tree/main/res/icons. La valeur par défaut est "light". .SH VOIR AUSSI .BR arch-update (1) diff --git a/po/arch-update.pot b/po/arch-update.pot index 603231e..4de7dcd 100644 --- a/po/arch-update.pot +++ b/po/arch-update.pot @@ -68,7 +68,7 @@ msgstr "" #: src/lib/common.sh:158 #, sh-format msgid "" -"The ${diff_prog} editor set for visualizing/editing differences of pacnew " +"The ${diff_prog} editor set for visualizing / editing differences of pacnew " "files in the arch-update.conf configuration file is not found\\n" msgstr "" @@ -106,8 +106,8 @@ msgstr "" #: src/lib/help.sh:8 #, sh-format msgid "" -"An update notifier/applier for Arch Linux that assists you with important " -"pre/post update tasks." +"An update notifier & applier for Arch Linux that assists you with important " +"pre / post update tasks." msgstr "" #: src/lib/help.sh:10 @@ -132,9 +132,9 @@ msgstr "" #: src/lib/help.sh:13 #, sh-format msgid "" -"Post update, it checks for orphan/unused packages, old cached packages, " -"pacnew/pacsave files, pending kernel update as well as services requiring a " -"post upgrade restart and, if there are, offers to process them." +"Post update, it checks for orphan & unused packages, old cached packages, " +"pacnew & pacsave files, pending kernel update as well as services requiring " +"a post upgrade restart and, if there are, offers to process them." msgstr "" #: src/lib/help.sh:15 @@ -175,7 +175,7 @@ msgstr "" #: src/lib/help.sh:21 #, sh-format msgid "" -" --gen-config Generate a default/example 'arch-update.conf' " +" --gen-config Generate a default / example 'arch-update.conf' " "configuration file, you can optionally pass the '--force' argument to " "overwrite any existing 'arch-update.conf' configuration file" msgstr "" @@ -219,7 +219,7 @@ msgstr "" #: src/lib/help.sh:29 #, sh-format msgid "" -"Certain options can be enabled/disabled or modified via the ${name}.conf " +"Certain options can be enabled, disabled or modified via the ${name}.conf " "configuration file, see the ${name}.conf(5) man page." msgstr "" diff --git a/po/fr.po b/po/fr.po index 9de7ae3..71dcba9 100644 --- a/po/fr.po +++ b/po/fr.po @@ -72,10 +72,10 @@ msgstr "" #: src/lib/common.sh:158 #, sh-format msgid "" -"The ${diff_prog} editor set for visualizing/editing differences of pacnew " +"The ${diff_prog} editor set for visualizing / editing differences of pacnew " "files in the arch-update.conf configuration file is not found\\n" msgstr "" -"L'éditeur ${diff_prog} défini pour la visualisation/l'édition des différences des fichiers pacnew " +"L'éditeur ${diff_prog} défini pour la visualisation / l'édition des différences des fichiers pacnew " "dans le fichier de configuration arch-update.conf n'est pas disponible\\n" #: src/lib/edit-config.sh:9 src/lib/show-config.sh:9 @@ -118,11 +118,11 @@ msgstr "Le fichier de configuration '${config_file}' a été généré" #: src/lib/help.sh:8 #, sh-format msgid "" -"An update notifier/applier for Arch Linux that assists you with important " -"pre/post update tasks." +"An update notifier & applier for Arch Linux that assists you with important " +"pre / post update tasks." msgstr "" -"Un notificateur/applicateur de mises à jour pour Arch Linux qui vous assiste dans les " -"tâches importantes d'avant/après mise à jour." +"Un notificateur & applicateur de mises à jour pour Arch Linux qui vous assiste dans les " +"tâches importantes d'avant / après mise à jour." #: src/lib/help.sh:10 #, sh-format @@ -150,12 +150,12 @@ msgstr "" #: src/lib/help.sh:13 #, sh-format msgid "" -"Post update, it checks for orphan/unused packages, old cached packages, " -"pacnew/pacsave files, pending kernel update as well as services requiring a " -"post upgrade restart and, if there are, offers to process them." +"Post update, it checks for orphan & unused packages, old cached packages, " +"pacnew & pacsave files, pending kernel update as well as services requiring " +"a post upgrade restart and, if there are, offers to process them." msgstr "" -"Après la mise à jour, elle vérifie la présence de paquets orphelins/inutilisés, d'anciens paquets mis en cache, " -"de fichiers pacnew/pacsave, les mises à jour du noyau en attente, ainsi que les services nécessitant un " +"Après la mise à jour, elle vérifie la présence de paquets orphelins & inutilisés, d'anciens paquets mis en cache, " +"de fichiers pacnew & pacsave, les mises à jour du noyau en attente, ainsi que les services nécessitant un " "redémarrage d'après mise à jour et, s'il y en a, propose de les traiter." #: src/lib/help.sh:15 @@ -201,12 +201,12 @@ msgstr " -D, --debug Afficher les traces de débogage" #: src/lib/help.sh:21 #, sh-format msgid "" -" --gen-config Generate a default/example 'arch-update.conf' " +" --gen-config Generate a default / example 'arch-update.conf' " "configuration file, you can optionally pass the '--force' argument to " "overwrite any existing 'arch-update.conf' configuration file" msgstr "" " --gen-config Générer un fichier de configuration 'arch-update.conf' " -"par défaut/exemple, vous pouvez optionnellement passer l'argument '--force' pour " +"par défaut / exemple, vous pouvez optionnellement passer l'argument '--force' pour " "écraser un fichier de configuration 'arch-update.conf' existant" #: src/lib/help.sh:22 @@ -254,10 +254,10 @@ msgstr "Pour plus d'informations, consultez la page de manuel ${name}(1)." #: src/lib/help.sh:29 #, sh-format msgid "" -"Certain options can be enabled/disabled or modified via the ${name}.conf " +"Certain options can be enabled, disabled or modified via the ${name}.conf " "configuration file, see the ${name}.conf(5) man page." msgstr "" -"Certaines options peuvent être activées/désactivées ou modifiées via le fichier de configuration ${name}.conf, " +"Certaines options peuvent être activées, désactivées ou modifiées via le fichier de configuration ${name}.conf, " "voir la page de manuel ${name}.conf(5)." #: src/lib/invalid_option.sh:7 diff --git a/res/completions/arch-update.fish b/res/completions/arch-update.fish index a686d98..b78cbe1 100644 --- a/res/completions/arch-update.fish +++ b/res/completions/arch-update.fish @@ -5,7 +5,7 @@ complete -c arch-update -s l -l list -d 'Display the list of pending updates' complete -c arch-update -s d -l devel -d 'Include AUR development packages updates' complete -c arch-update -s n -l news -d 'Display latest Arch news' complete -c arch-update -s D -l debug -d 'Display debug traces' -complete -c arch-update -l gen-config -d 'Generate a default/example configuration file' +complete -c arch-update -l gen-config -d 'Generate a default / example configuration file' complete -c arch-update -l show-config -d 'Display the current configuration file' complete -c arch-update -l edit-config -d 'Edit the current configuration file' complete -c arch-update -l tray -d 'Launch the Arch-Update systray applet' diff --git a/res/completions/arch-update.zsh b/res/completions/arch-update.zsh index 7d93ed9..bbbb6e2 100644 --- a/res/completions/arch-update.zsh +++ b/res/completions/arch-update.zsh @@ -7,7 +7,7 @@ opts=( {-d,--devel}'[Include AUR development packages updates]' {-n,--news}'[Display latest Arch news]' {-D,--debug}'[Display debug traces]' - {--gen-config}'[Generate a default/example configuration file]' + {--gen-config}'[Generate a default / example configuration file]' {--show-config}'[Display the current configuration file]' {--edit-config}'[Edit the current configuration file]' {--tray}'[Launch the Arch-Update systray applet]' diff --git a/src/arch-update.sh b/src/arch-update.sh index 4f17e0f..cd94b87 100755 --- a/src/arch-update.sh +++ b/src/arch-update.sh @@ -1,6 +1,6 @@ #!/bin/bash -# arch-update: An update notifier/applier for Arch Linux that assists you with important pre/post update tasks +# arch-update: An update notifier & applier for Arch Linux that assists you with important pre / post update tasks # https://github.com/Antiz96/arch-update # SPDX-License-Identifier: GPL-3.0-or-later @@ -39,15 +39,15 @@ source "${libdir}/common.sh" # Source the different libraries depending on the option(s) passed case "${option}" in "") - # Source the "full_upgrade" library which executes the series of relevant functions/libraries to perform a complete and proper update of the system + # Source the "full_upgrade" library which executes the series of relevant functions / libraries to perform a complete and proper update of the system # shellcheck source=src/lib/full_upgrade.sh source "${libdir}/full_upgrade.sh" ;; -d|--devel) - # Set the "--devel" flag for AUR helpers (yay/paru) + # Set the "--devel" flag for AUR helpers (yay / paru) devel_flag+=("--devel") - # Source the "full_upgrade" library which executes the series of relevant functions/libraries to perform a complete and proper update of the system + # Source the "full_upgrade" library which executes the series of relevant functions / libraries to perform a complete and proper update of the system # shellcheck source=src/lib/full_upgrade.sh source "${libdir}/full_upgrade.sh" ;; @@ -57,7 +57,7 @@ case "${option}" in source "${libdir}/check.sh" ;; -l|--list) - # Set that the "-l/--list" option is used (required for the "list_packages" library to only print the list of packages available for update without asking for the user confirmation to apply them) + # Set that the "-l / --list" option is used (required for the "list_packages" library to only print the list of packages available for update without asking for the user confirmation to apply them) list_option="true" # Source the "list_packages" library which displays the list of packages available for updates @@ -65,7 +65,7 @@ case "${option}" in source "${libdir}/list_packages.sh" ;; -n|--news) - # Set that news should be shown and that the "-n/--news" option is used (required for the "list_news" library to only print the list of recent Arch news without looking to continue with the update process) + # Set that news should be shown and that the "-n / --news" option is used (required for the "list_news" library to only print the list of recent Arch news without looking to continue with the update process) show_news="true" news_option="true" diff --git a/src/lib/common.sh b/src/lib/common.sh index aaddeb6..4fd7c7f 100755 --- a/src/lib/common.sh +++ b/src/lib/common.sh @@ -4,7 +4,7 @@ # https://github.com/Antiz96/arch-update # SPDX-License-Identifier: GPL-3.0-or-later -# Display debug traces if the -D/--debug argument is passed +# Display debug traces if the -D / --debug argument is passed for arg in "${@}"; do case "${arg}" in -D|--debug) @@ -13,7 +13,7 @@ for arg in "${@}"; do esac done -# Reset the option var if it is equal to -D/--debug (to avoid false negative "invalid option" error) +# Reset the option var if it is equal to -D / --debug (to avoid false negative "invalid option" error) # shellcheck disable=SC2154 case "${option}" in -D|--debug) @@ -108,7 +108,7 @@ quit_msg() { read -n 1 -r -s -p $"$(info_msg "${msg}")" && echo } -# Definition of the AUR helper to use (depending on if/which one is installed on the system and if it's not already defined in arch-update.conf) for the optional AUR packages support +# Definition of the AUR helper to use (depending on if / which one is installed on the system and if it's not already defined in arch-update.conf) for the optional AUR packages support # shellcheck disable=SC2034 if [ -z "${aur_helper}" ]; then if command -v paru > /dev/null; then @@ -155,7 +155,7 @@ fi # Definition of the diff program to use (if it is set in the arch-update.conf configuration file) if [ -n "${diff_prog}" ]; then if ! command -v "${diff_prog}" > /dev/null; then - error_msg "$(eval_gettext "The \${diff_prog} editor set for visualizing/editing differences of pacnew files in the arch-update.conf configuration file is not found\n")" && quit_msg + error_msg "$(eval_gettext "The \${diff_prog} editor set for visualizing / editing differences of pacnew files in the arch-update.conf configuration file is not found\n")" && quit_msg exit 15 else if [ "${su_cmd}" == "sudo" ]; then diff --git a/src/lib/config.sh b/src/lib/config.sh index a6f4a76..d854f47 100755 --- a/src/lib/config.sh +++ b/src/lib/config.sh @@ -51,7 +51,7 @@ if [ -f "${config_file}" ]; then tray_icon_style=$(grep -E '^[[:space:]]*TrayIconStyle[[:space:]]*=[[:space:]]*(light|dark|blue)[[:space:]]*$' "${config_file}" 2> /dev/null | awk -F '=' '{print $2}' | tr -d '[:space:]') fi -# Set the default/fallback value for options that require it (if the arch-update.conf configuration file doesn't exists, if the concerned option is commented or if the set value is invalid) +# Set the default / fallback value for options that require it (if the arch-update.conf configuration file doesn't exists, if the concerned option is commented or if the set value is invalid) [ -z "${news_num}" ] && news_num="5" [ -z "${old_packages_num}" ] && old_packages_num="3" [ -z "${uninstalled_packages_num}" ] && uninstalled_packages_num="0" diff --git a/src/lib/full_upgrade.sh b/src/lib/full_upgrade.sh index 51697c5..666b68e 100755 --- a/src/lib/full_upgrade.sh +++ b/src/lib/full_upgrade.sh @@ -1,6 +1,6 @@ #!/bin/bash -# full_upgrade.sh: Execute the series of relevant functions/libraries to perform a complete and proper update of the system +# full_upgrade.sh: Execute the series of relevant functions / libraries to perform a complete and proper update of the system # https://github.com/Antiz96/arch-update # SPDX-License-Identifier: GPL-3.0-or-later diff --git a/src/lib/help.sh b/src/lib/help.sh index a4b2f17..8052394 100755 --- a/src/lib/help.sh +++ b/src/lib/help.sh @@ -5,12 +5,12 @@ # SPDX-License-Identifier: GPL-3.0-or-later cat <