% -*- texinfo -*-
% @deftypefn {Function File} @var{h} = zenity_progress(@var{title}, @var{option1}, @var{option2})
% @deftypefnx {Function File} zenity_progress(@var{h}, @var{progress})
% @deftypefnx {Function File} zenity_progress(@var{h}, @var{progress}, @var{text})
% Displays a graphical progress bar.
% If the first argument is either non-present or a string, a new progress bar is
% created and a handle is returned. If the first argument is a string it will be
% used as the title of the progress bar. The two optional arguments @var{option1}
% and @var{option2} can be
% @table @samp
% @item auto-close
% The progress bar will be closed when it reaches 100.
% @item pulsate
% The progress bar will pulsate.
% @end table
%
% If the first argument is a handle to a progress bar and the second
% argument is an integer, the progress bar will set its current value
% to the given integer. If the second argument is a string, the text
% of the progress bar will be set to the given string.
% It is possible to pass both an integer and a string to the function
% in one function call.
%
% @seealso{zenity_calendar, zenity_list, zenity_entry, zenity_message,
% zenity_text_info, zenity_file_selection, zenity_notification}
% @end deftypefn