Piped input and positional parameters are largely undocumented
For dialogs that work with piped input and/or positional parameters (--list
, --progress
, --text-info
… I think --help
output (including specialized help, i.e. --help-list
), nor in the manual (man zenity
), nor in the website documentation – aside from example code itself (mostly found on the said website, one example per dialog). In fact, if not for those examples, I would have serious trouble figuring out how to use these dialogs at all.
I strongly suggest adding mentions of piped input & positional parameters in CLI help (even the Usage line always says zenity [OPTION…]
, which isn't particularly informative TBH), as well as describing them in the man file (i.e. in subsections for respective dialogs), and similarly providing proper explanation for them on the website.