docs: Give some love to progress bar docs.

Differential Revision: https://phab.enlightenment.org/D11112

2 files changed, 24 insertions, 7 deletions

diff --git a/src/lib/efl/interfaces/efl_ui_range_display.eo b/src/lib/efl/interfaces/efl_ui_range_display.eo
index 4b8cade311..2a9a75abb7 100644
--- a/src/lib/efl/interfaces/efl_ui_range_display.eo
+++ b/src/lib/efl/interfaces/efl_ui_range_display.eo
@@ -4,7 +4,7 @@ interface Efl.Ui.Range_Display
 
      A value range contains a value restricted between specified minimum and maximum
      limits at all times.
-     This can be used for progressbars, sliders or spinners, for example.
+     This can be used for progress bars, sliders or spinners, for example.
 
      @since 1.23
    ]]
diff --git a/src/lib/elementary/efl_ui_progressbar.eo b/src/lib/elementary/efl_ui_progressbar.eo
index 1bc55057f3..3f6917b95c 100644
--- a/src/lib/elementary/efl_ui_progressbar.eo
+++ b/src/lib/elementary/efl_ui_progressbar.eo
@@ -2,24 +2,41 @@ class @beta Efl.Ui.Progressbar extends Efl.Ui.Layout_Base implements Efl.Ui.Rang
                           Efl.Ui.Layout_Orientable, Efl.Access.Value,
                           Efl.Text, Efl.Content, Efl.Text_Markup
 {
-   [[Elementary progressbar class]]
+   [[Progress bar widget.
+
+     It shows a graphical indication of the current progress of some lengthy operation,
+     typically as a bar that gradually fills or a pointer that moves from one side of the
+     bar to the other. The bar can be horizontal or vertical, controlled with @Efl.Ui.Layout_Orientable.
+
+     The minimum and maximum values (or starting and ending values), along with the current
+     value can be set using the @Efl.Ui.Range_Display interface.
+
+     @.infinite_mode can be set when the progress state is unknown.
+     An optional textual label can be shown to indicate the exact numerical value of the progress.
+   ]]
    methods {
       @property infinite_mode {
-         [[Start/stop a given progress bar "pulsing" animation, if this mode is enabled.]]
+         [[When this mode is enabled the progress bar indicates that there is an operation
+           going on, but does not give information about its progress.
+           This is typically shown as a "pulsing" animation or an endless spinning bar,
+           depending on the theme.
+         ]]
          set {
          }
          get {
          }
          values {
-           state: bool; [[$true if the progressbar should animate infinitely,
-                          $false if the progressbar should animate based on a fixed endpoint.]]
+           state: bool; [[$true if the progress bar should animate infinitely.]]
          }
       }
       @property show_progress_label {
-         [[Whether a textual progress label is shown alongside the progressbar to give an exact
-           numerical indication of the current progress.
+         [[Whether a textual progress label is shown alongside the progress bar to give an exact
+           numerical indication of the current progress. Control the conversion of the numerical
+           value to a text string using @Efl.Ui.Format.
 
            Not to be confused with the widget label set through @Efl.Text.text.
+
+           The exact location and appearance of the progress label depend on the theme.
          ]]
          values {
            show: bool; [[$true to show the progress label.]]