From 85c7e0a1ee1e20ed80d48a7de58fcf7a0e0e0c9c Mon Sep 17 00:00:00 2001 From: Robin Candau Date: Wed, 21 Feb 2024 18:31:15 +0100 Subject: [PATCH] Add documentation for the '--news' option --- README-fr.md | 4 +++- README.md | 4 +++- doc/man/arch-update.1 | 6 +++++- doc/man/fr/arch-update.1 | 6 +++++- po/arch-update.pot | 2 +- po/fr.po | 4 ++-- src/script/arch-update.sh | 2 +- 7 files changed, 20 insertions(+), 8 deletions(-) diff --git a/README-fr.md b/README-fr.md index cf08deb..5d2dd76 100644 --- a/README-fr.md +++ b/README-fr.md @@ -115,6 +115,7 @@ Sélectionnez la news à lire en tapant le numéro associé. Après avoir lu une news, `arch-update` vous proposera à nouveau d'afficher les dernières Arch news, afin que vous puissiez lire plusieurs news à la fois. Appuyez simplement sur « Entrée » sans saisir de chiffre pour procéder à la mise à jour : +*Les Arch news peuvent être affichées à tout moment en exécutant la commande `arch-update --news`* *Le listing/affichage des Arch news peut être ignoré avec l'option `NoNews` dans le fichier de configuration `arch-update.conf`.* *Notez que l'utilisation de cette option générera un message d'avertissement pour rappeler que les utilisateurs sont censés consulter régulièrement les Arch news.* *Voir le [chapitre de documentation arch-update.conf](#Fichier-de-configuration-arch-update) pour plus de détails.* @@ -168,7 +169,8 @@ 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é) --h, --help Afficher ce message et quitter +-n, --news Afficher les dernières Arch News +-h, --help Afficher ce message d'aide et quitter -V, --version Afficher les informations de version et quitter Codes de sortie : diff --git a/README.md b/README.md index a0b834d..9fdae13 100644 --- a/README.md +++ b/README.md @@ -113,6 +113,7 @@ Select which news to read by typing its associated number. After your read a news, `arch-update` will once again offers to display latest Arch Linux news, so you can read multiple news at once. Simply press "enter" without typing any number to proceed with update: +*Arch news can be displayed at any time by running the `arch-update --news` command.* *The Arch news listing/displaying can be skipped with the `NoNews` option in the `arch-update.conf` configuration file.* *Note that using this option will generate a warning message as a reminder that users are expected to regularly check Arch news.* *See the [arch-update.conf documentation chapter](#arch-update-configuration-file) for more details.* @@ -166,7 +167,8 @@ 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) --h, --help Display this message and exit +-n, --news Display latest Arch News +-h, --help Display this help message and exit -V, --version Display version information and exit Exit Codes: diff --git a/doc/man/arch-update.1 b/doc/man/arch-update.1 index 511c414..fdfd3a4 100644 --- a/doc/man/arch-update.1 +++ b/doc/man/arch-update.1 @@ -1,4 +1,4 @@ -.TH "ARCH-UPDATE" "1" "January 2024" "Arch-Update 1.11.0" "Arch-Update Manual" +.TH "ARCH-UPDATE" "1" "February 2024" "Arch-Update 1.11.0" "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 @@ An update notifier/applier for Arch Linux that assists you with important pre/po .br .B systemctl \-\-user enable \-\-now arch-update.timer +.TP +.B \-n, \-\-news +Display latest Arch news. + .TP .B \-v, \-\-version Display version information. diff --git a/doc/man/fr/arch-update.1 b/doc/man/fr/arch-update.1 index 63c6383..3bb444d 100644 --- a/doc/man/fr/arch-update.1 +++ b/doc/man/fr/arch-update.1 @@ -1,4 +1,4 @@ -.TH "ARCH-UPDATE" "1" "Janvier 2024" "Arch-Update 1.11.0" "Manuel de Arch-Update" +.TH "ARCH-UPDATE" "1" "Février 2024" "Arch-Update 1.11.0" "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 @@ Un notificateur/applicateur de mises à jour pour Arch Linux qui vous assiste da .br .B systemctl \-\-user enable \-\-now arch-update.timer +.TP +.B \-n, \-\-news +Afficher les dernières Arch news. + .TP .B \-v, \-\-version Afficher les informations de version. diff --git a/po/arch-update.pot b/po/arch-update.pot index 506c4df..79cec52 100644 --- a/po/arch-update.pot +++ b/po/arch-update.pot @@ -79,7 +79,7 @@ msgstr "" #: src/script/arch-update.sh:135 #, sh-format -msgid " -h, --help Display this message and exit" +msgid " -h, --help Display this help message and exit" msgstr "" #: src/script/arch-update.sh:136 diff --git a/po/fr.po b/po/fr.po index 9fcc63b..27cf994 100644 --- a/po/fr.po +++ b/po/fr.po @@ -90,8 +90,8 @@ msgstr "" #: src/script/arch-update.sh:135 #, sh-format -msgid " -h, --help Display this message and exit" -msgstr " -h, --help Afficher ce message et quitter" +msgid " -h, --help Display this help message and exit" +msgstr " -h, --help Afficher ce message d'aide et quitter" #: src/script/arch-update.sh:136 #, sh-format diff --git a/src/script/arch-update.sh b/src/script/arch-update.sh index 4834eb4..2b8fa62 100755 --- a/src/script/arch-update.sh +++ b/src/script/arch-update.sh @@ -132,7 +132,7 @@ $(eval_gettext "Post update, check for orphan/unused packages, old cached packag $(eval_gettext "Options:") $(eval_gettext " -c, --check Check for available updates, send a desktop notification containing the number of available updates (if libnotify is installed)") -$(eval_gettext " -h, --help Display this message and exit") +$(eval_gettext " -h, --help Display this help message and exit") $(eval_gettext " -V, --version Display version information and exit") $(eval_gettext "For more information, see the \${name}(1) man page.")