Skip to content

Add contextual help to Yay operations - #2921

Open
jdholtz wants to merge 1 commit into
Jguer:nextfrom
jdholtz:contextual-help
Open

Add contextual help to Yay operations#2921
jdholtz wants to merge 1 commit into
Jguer:nextfrom
jdholtz:contextual-help

Conversation

@jdholtz

@jdholtz jdholtz commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

This is a proposal to add #2780. I thought this would be a good addition to yay because it's exactly how pacman operates. Happy to discuss this further too.

Instead of yay -<op> --help printing the entire help message, it will now print a contextual help message based on the operation being performed.

The top-level help message shows available operations and global flags as before. It no longer shows operation-specific flags and pacman -S --help output. Like the pacman output, it shows that you can get operation-specific help by running yay -<op> --help.

The operation-specific help message shows the operation's flags and all pacman operation flags pass through to pacman.

Specifying -V and --version now always shows the version rather than having yay -V --help show the help message.

Instead of `yay -<op> --help` printing the entire help message, it will
now print a contextual help message based on the operation being
performed. The top-level help message shows available operations and
global flags as before. It no longer shows operation-specific flags and
`pacman -S --help` output. Like the pacman output, it shows that you can
get operation-specific help by running `yay -<op> --help`.

The operation-specific help message shows the operation's flags and all
pacman operation flags pass through to pacman.
@jdholtz
jdholtz requested a review from Jguer as a code owner July 19, 2026 20:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant