FS#40234 - [pacman] change wording of --list for -Q --help output
Attached to Project:
Pacman
Opened by tim (sudokode) - Tuesday, 06 May 2014, 05:00 GMT
Last edited by Allan McRae (Allan) - Wednesday, 25 June 2014, 13:10 GMT
Opened by tim (sudokode) - Tuesday, 06 May 2014, 05:00 GMT
Last edited by Allan McRae (Allan) - Wednesday, 25 June 2014, 13:10 GMT
|
Details
Summary and Info:
The --help output of `pacman -Q` includes a rather ambiguous statement (imho). For '-l, --list', the help information is "list the contents of the queried package". In regards to a package manager, the "contents" of a package might be something like the metadata (such as information listed with -Qi) or even the metadata files associated with the package that are stored in the database tree. Meanwhile, the manpage has a much clearer definition of the command: "List all files owned by a given package. ..." So while commands like --info, --check, and --owns have --help output that mentions 'file' or 'files', --list does not, despite it being closely related to files owned by a package. I think it would be worthwhile to change the wording of the --help output for `pacman -Q` in regards to the --list option because a very common thing to do when searching for help (besides reading the manpage) is grep such output for the words users associate with such a command ('file' or 'files' would be useful here). Steps to reproduce: 1. pacman -Qh | grep -i content vs. 1. pacman -Qh | grep -i file |
This task depends upon
Closed by Allan McRae (Allan)
Wednesday, 25 June 2014, 13:10 GMT
Reason for closing: Fixed
Additional comments about closing: git commit 4d65332c
Wednesday, 25 June 2014, 13:10 GMT
Reason for closing: Fixed
Additional comments about closing: git commit 4d65332c
While the -Ql one is obvious in the manpage, this one is rather confusing in both places.
These are actually two things asked about in #archlinux. I feel kinda silly when I point them at pacman -h and they come back with "um.. not seeing anything like that" with good reason.
Both are patches welcome!
Leaving open to track --print suggestions. Please send suggested changes...