From 0645d610a7c900e8c0a7d68dcd46bf14b8e2b1e9 Mon Sep 17 00:00:00 2001
From: Dmitry Karasik <dmitry@karasik.eu.org>
Date: Tue, 17 Sep 2024 15:51:50 +0200
Subject: [PATCH] document Gauge's .indeterminate and .sliderLength

---
 Prima/Sliders.pm | 21 ++++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

diff --git a/Prima/Sliders.pm b/Prima/Sliders.pm
index 45e967341..5d04c9e7d 100644
--- a/Prima/Sliders.pm
+++ b/Prima/Sliders.pm
@@ -893,21 +893,17 @@ sub indeterminate    {
 
 	# Create the timer for the motion in indeterminate mode
 	# if it is not still created
-	unless ( $self->{timer} ) {
-		$self->{timer} = $self->insert( Timer =>
+	$self->{timer} //= $self->insert( Timer =>
 		name	    => 'Timer',
 		timeout     => 25,
 		delegations => ['Tick'],
-		);
-	}
+	);
 
 	# When the style property is changed, reset the timer frequency
 	# and the start_angle and for style circle the end_angle, too
 	if ( $indeterminate) {
 		$self->{timer}->start;
-	}
-
-	else {
+	} else {
 		$self->{timer}->stop;
 	}
 	$self->{indeterminate} = $indeterminate;
@@ -2988,6 +2984,11 @@ Selects the width of the border around the widget.
 
 Default value: 1
 
+=item indeterminate BOOLEAN
+
+If set, the gauge doesn't show the percentage, but shows a moving color strip,
+to hint that there's no know percentage. The strip width is C<sliderLength> percents.
+
 =item max INTEGER
 
 Sets the upper limit for C<value>.
@@ -3000,6 +3001,10 @@ Sets the lower limit for C<value>.
 
 Default value: 0
 
+=item sliderLength INTEGER
+
+See L<indeterminate>.
+
 =item relief INTEGER
 
 Selects the style of the border around the widget. Can be one of the
@@ -3027,6 +3032,8 @@ eventual text.
 
 Default value: 0.
 
+See also: L<indeterminate>
+
 =item vertical BOOLEAN
 
 If 1, the widget is drawn vertically and the progress bar moves from bottom to top.