Add Finalize to the test to ensure we always get the end message, and update the doc string

Author: Jlalond

lldb/bindings/interface/SBProgressDocstrings.i

@@ -11,7 +11,15 @@ The Progress class helps make sure that progress is correctly reported
 and will always send an initial progress update, updates when
 Progress::Increment() is called, and also will make sure that a progress
 completed update is reported even if the user doesn't explicitly cause one
-to be sent.") lldb::SBProgress;
+to be sent.
+
+Progress can either be deterministic, incrementing up to a known total or non-deterministic
+with an unbounded total. Deterministic is better if you know the items of work in advance, but non-deterministic
+exposes a way to update a user during a long running process that work is taking place.
+
+For non-deterministic 
+
+") lldb::SBProgress;
 
 %feature("docstring",
 "Finalize the SBProgress, which will cause a progress end event to be emitted. This 

lldb/test/API/tools/lldb-dap/progress/Progress_emitter.py

@@ -39,7 +39,7 @@ def create_options(cls):
         parser.add_option(
             "--total",
             dest="total",
-            help="Total to count up, use None to identify as indeterminate",
+            help="Total items in this progress object. When this option is not specified, this will be an indeterminate progress.",
             type="int",
             default=None,
         )
@@ -101,6 +101,9 @@ def __call__(self, debugger, command, exe_ctx, result):
                 progress.Increment(1, f"Step {i}")
             time.sleep(cmd_options.seconds)
 
+        # Not required for deterministic progress, but required for indeterminate progress.
+        progress.Finalize()
+
 
 def __lldb_init_module(debugger, dict):
     # Register all classes that have a register_lldb_command method

lldb/test/API/tools/lldb-dap/progress/TestDAP_Progress.py

@@ -19,7 +19,7 @@ def verify_progress_events(
         expected_not_in_message=None,
         only_verify_first_update=False,
     ):
-        self.dap_server.wait_for_event("progressEnd", 15)
+        self.dap_server.wait_for_event("progressEnd", 5)
         self.assertTrue(len(self.dap_server.progress_events) > 0)
         start_found = False
         update_found = False