Re: new waitbar function

[Rik]

11/3/11

John,

I just checked in some useful changes here
(http://hg.savannah.gnu.org/hgweb/octave/rev/b3cdef33ac0e).

Summary :
The docstring has been expanded and now more of the possible calling forms
are listed
The created handle, h, is no longer returned if nargout is 0 (just calling
waitbar(...) on command line)
The calling forms 'waitbar (FRAC)' or 'waitbar (FRAC, H)' no longer delete
the text message.  This allows
you to set the text message once at the start and then just adjust the fill
value of the slider.
Added input validation tests for completeness.

Matlab's documentation for the function is here:
http://www.mathworks.com/help/techdoc/ref/waitbar.html.

One calling form they allow is 'waitbar (FRAC)' which updates the length of
the *current* waitbar.  It would be nice to support that, but I'm not sure
how they are doing it.  Are they using a persistent variable to remember
the waitbar handle?  Or do they always just use the current figure and
check whether there is a waitbar for updating?

--Rik