X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/9c824f2977a2e8a502b0570c5301caa2a547833a..73e54eb489b9f7b0379f5cf1f788516059054073:/docs/latex/wx/stopwtch.tex

diff --git a/docs/latex/wx/stopwtch.tex b/docs/latex/wx/stopwtch.tex
index 98b60ed19f..f80cf86175 100644
--- a/docs/latex/wx/stopwtch.tex
+++ b/docs/latex/wx/stopwtch.tex
@@ -1,6 +1,19 @@
 \section{\class{wxStopWatch}}\label{wxstopwatch}
 
-The wxStopWatch class allow you to measure time intervalls. 
+The wxStopWatch class allow you to measure time intervals. For example, you may
+use it to measure the time elapsed by some function:
+
+\begin{verbatim}
+    wxStopWatch sw;
+    CallLongRunningFunction();
+    wxLogMessage("The long running function took %ldms to execute",
+                 sw.Time());
+    sw.Pause();
+    ... stopwatch is stopped now ...
+    sw.Resume();
+    CallLongRunningFunction();
+    wxLogMessage("And calling it twice took $ldms in all", sw.Time());
+\end{verbatim}
 
 \wxheading{Include files}
 
@@ -12,7 +25,7 @@ The wxStopWatch class allow you to measure time intervalls.
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
-\membersection{wxStopWatch::wxStopWatch}
+\membersection{wxStopWatch::wxStopWatch}\label{wxstopwatchctor}
 
 \func{}{wxStopWatch}{\void}
 
@@ -25,21 +38,26 @@ Constructor. This starts the stop watch.
 Pauses the stop watch. Call \helpref{wxStopWatch::Resume}{wxstopwatchresume} to resume 
 time measuring again.
 
-\membersection{wxStopWatch::Start}
-
-\func{void}{Start}{\param{long}{ milliseconds = 0}}
-
-(Re)starts the stop watch with a given initial value.
+If this method is called several times, {\tt Resume()} must be called the same
+number of times to really resume the stop watch. You may, however, call 
+\helpref{Start}{wxstopwatchstart} to resume it unconditionally.
 
 \membersection{wxStopWatch::Resume}\label{wxstopwatchresume}
 
 \func{void}{Resume}{\void}
 
-Resumes the stop watch after having been paused with \helpref{wxStopWatch::Pause}{wxstopwatchpause}.
+Resumes the stop watch which had been paused with 
+\helpref{wxStopWatch::Pause}{wxstopwatchpause}.
+
+\membersection{wxStopWatch::Start}\label{wxstopwatchstart}
+
+\func{void}{Start}{\param{long}{ milliseconds = 0}}
+
+(Re)starts the stop watch with a given initial value.
 
-\membersection{wxStopWatch::Time}
+\membersection{wxStopWatch::Time}\label{wxstopwatchtime}
 
-\func{long}{Time}{\void}\label{wxstopwatchtime}
+\constfunc{long}{Time}{\void}\label{wxstopwatchtime}
 
 Returns the time in milliseconds since the start (or restart) or the last call of 
 \helpref{wxStopWatch::Pause}{wxstopwatchpause}.