diff --git a/manual/tracy.tex b/manual/tracy.tex index 793bc7c8..3d11f42e 100644 --- a/manual/tracy.tex +++ b/manual/tracy.tex @@ -940,6 +940,10 @@ Use the \texttt{ZoneText(text, size)} macro to add a custom text string that wil If you want to set zone name on a per-call basis, you may do so using the \texttt{ZoneName(text, size)} macro. This name won't be used in the process of grouping the zones for statistical purposes (sections~\ref{statistics} and~\ref{findzone}). +\subsubsection{Manual management of zone scope} + +The zone markup macros automatically report when they end, through the RAII mechanism\footnote{\url{https://en.cppreference.com/w/cpp/language/raii}}. This is very helpful, but sometimes you may want to mark the zone start and end points yourself, for example if you want to have a zone that crosses the function's boundary. This can be achieved by using the C API, which is described in section~\ref{capi}. + \subsubsection{Multiple zones in one scope} \label{multizone} @@ -1026,10 +1030,6 @@ void Graphics::Render() } \end{lstlisting} -\subsubsection{Manual management of zone scope} - -The zone markup macros automatically report when they end, through the RAII mechanism\footnote{\url{https://en.cppreference.com/w/cpp/language/raii}}. This is very helpful, but sometimes you may want to mark the zone start and end points yourself, for example if you want to have a zone that crosses the function's boundary. This can be achieved by using the C API, which is described in section~\ref{capi}. - \subsubsection{Exiting program from within a zone} At the present time exiting the profiled application from inside a zone is not supported. When the client calls \texttt{exit()}, the profiler will wait for all zones to end, before a program can be truly terminated. If program execution stopped inside a zone, this will never happen, and the profiled application will seemingly hang up. At this point you will need to manually terminate the program (or simply disconnect the profiler server).