Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Man page updates #5842

Merged
merged 6 commits into from
Dec 26, 2023
Merged

Conversation

clebergnu
Copy link
Contributor

This is a collection of updates to the man page in preparation for the 103.0 LTS release.

Fixes: #5050

When registering an option and setting a metavar, and then later
adding a command line option, the metavar will get reset (to None) if
one is not given again.

Let's respect the previously set metavar, if one exists.

As an example where this manifests, the "--show" option of the
"avocado" command line option, currently lacks a metavar even with one
being set for the setting itself.

Signed-off-by: Cleber Rosa <[email protected]>
This updates the man page to cover all current commands, and its
options.

Signed-off-by: Cleber Rosa <[email protected]>
Instead of having documentation only on the man page, or duplicated
that will often bitrot, let's have most of it in the main
documentation section.

In the case of the distro plugin, the only documentation available was
on the man page, which is very often not consulted by users.

Signed-off-by: Cleber Rosa <[email protected]>
Wrapper support was removed back in d4b365a.  Let's sync the man
page.

Signed-off-by: Cleber Rosa <[email protected]>
There are a number of small differences between the behavior and
output depicted in the man page and the current status.  This syncs
them all.

Signed-off-by: Cleber Rosa <[email protected]>
@mr-avocado
Copy link

mr-avocado bot commented Dec 26, 2023

Dear contributor,
Avocado is currently under sprint #103, which is due to release an LTS (Long Term Stability) release.
Please avoid merging changes that do not fall into these categories:

  • Bug fixes
  • Usability Improvements
  • Documentation updates

As for the Avocado utility modules (“avocado.utils”) it is OK to introduce new functionality,
but changes to the existing APIs (including interface and behavior) should be avoided.
These kind of changes should wait until sprint #104.

@clebergnu clebergnu requested a review from richtja December 26, 2023 19:32
Copy link
Contributor

@richtja richtja left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM thanks

@richtja richtja merged commit 8006aef into avocado-framework:master Dec 26, 2023
65 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

2 participants