error in example in zenity man page

[Chris Moore]

The 'zenity' man page has this example:

       Display a progress dialog while searching for all the postscript files
       in your home directory

       find `echo $HOME` '*.ps' | zenity --progress --pulsate

That's not how find works. You need to use "-name" if you want find to find .ps
files. And what is the point of the backticks and the echo? Just "find $HOME"
is the same as "find `echo $HOME`".

This would be a better example:

       find $HOME -name '*.ps' | zenity --progress --pulsate

[era (era)]

I don't find that it does anything useful, still; it throws away the results from the find, and if you press "cancel" while the dialog box is up, the script (or interactive shell) where this is run from gets a SIGHUP.

 bash$ bash
 bash$ PS1='in subshell> '
 in subshell> find / | zenity --progress --pulsate
 find: /etc/lvm/archive: Permission denied
 find: /etc/lv[ Progress ]sion denied
 find: /etc/ss| [ |||| ] |n denied
 find: /var/li| [Cancel] |mission denied
 find: /var/lib/gdm: Permission denied
 find: /var/lib/slocate: Permission denied
 find: /var/lock/lvm: Permission denied
 find: /var/run/fetchmail: Permission denied
 find: /var/run/sudo: Permission denied
 Hangup
 bash$ # yes, the subshell exited with "Hangup"

(I was going to post the same bug report about the superfluous backticks, but just happened to notice this additional flaw.)

[Chris Moore (dooglus)]

You should really raise a new bug report for this. It's a completely different issue than the documentation bug.

[Daniel Holbach (dholbach)]

Thanks Chris for your suggestion, I forwarded it upstream and will fix it in our next upload.

[Daniel Holbach (dholbach)]

upload after flight-6-freeze

[Daniel Holbach (dholbach)]

 zenity (2.14.0-0ubuntu2) dapper; urgency=low
 .
   * debian/patches/fix-manpage.patch:
     - fix Malone: #21683 ("error in example in zenity man page")

[era (era)]

For what it's worth, the HUP problem seems to be fixed too (for me on Feisty/amd64 at least)