From ce68f57a0a0f1e46a09fde51df6919a6ea146f05 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ale=C5=A1=20Mat=C4=9Bj?= Date: Wed, 27 Sep 2023 09:26:35 +0200 Subject: [PATCH] advisory: document advisory command changes and few clean ups Closes: https://github.com/rpm-software-management/dnf5/issues/919 --- doc/changes.rst | 24 +++++++++++++++++------- 1 file changed, 17 insertions(+), 7 deletions(-) diff --git a/doc/changes.rst b/doc/changes.rst index 2e7df98b1..876f0a411 100644 --- a/doc/changes.rst +++ b/doc/changes.rst @@ -52,14 +52,14 @@ This allows using a list of authentication methods in configuration files and th Changes on the command line: ============================ -Commands cannot have optional subcommands and optional arguments. Is some cases subcommand can have the same string as -an argument. It means there is a difficulty to find advisory for package with the name `list`, `info`, or `summary`. -`dnf history info ` -> `dnf history --info ` -`dnf updateinfo info` -> `dnf updateinfo --info` +Commands cannot have optional subcommands and optional arguments. Optional subcommands were ambiguous, it wasn't clear +whether the input is a command argument or a subcommand. If present, subcommands are now mandatory. +`dnf history ` -> `dnf history info ` +`dnf updateinfo` -> `dnf updateinfo summary` -Options that cannot be applied to all command or can be applied but without any effect should be removed from general -options and implemented only for related commands -`--best`, `--nobest` are only related several transaction commands +Options that cannot be applied to all commands or can be applied but without any effect should be removed from general +options and implemented only for related commands. +For example: `--best`, `--nobest` are related to only several transaction commands. Renaming boolean options to format `--