From c5ce93136fc8a8d22b8eeee24da9defaa9f16754 Mon Sep 17 00:00:00 2001
From: Bartosz Taudul <wolf.pld@gmail.com>
Date: Mon, 16 Dec 2019 19:24:02 +0100
Subject: [PATCH] Update manual.

---
 manual/tracy.tex | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/manual/tracy.tex b/manual/tracy.tex
index 5eb5de07..e4d540d9 100644
--- a/manual/tracy.tex
+++ b/manual/tracy.tex
@@ -2372,6 +2372,22 @@ This window lists all annotations marked on the timeline. Each annotation is pre
 \label{figannlist}
 \end{figure}
 
+\section{Importing external profiling data}
+
+Tracy can import data generated by other profilers. This external data cannot be directly loaded, but must be converted first. Currently there's only support for converting chrome:tracing data (only in JSON Array format), through the \texttt{import-chrome} utility.
+
+\begin{bclogo}[
+noborder=true,
+couleur=black!5,
+logo=\bcattention
+]{Limitations}
+\begin{itemize}
+\item Tracy is a single-process profiler. There is no differentiation between data coming from different pids.
+\item Tracy uses thread identifiers assigned by the operating system. This means that no two concurrent threads can have the same tid. Be aware that some external data formats may encourage usage of duplicated thread identifiers.
+\item The imported data may be severely limited, either by not mapping directly to the data structures used by Tracy, or by following undocumented practices.
+\end{itemize}
+\end{bclogo}
+
 \section{Configuration files}
 
 While the client part doesn't read or write anything to the disk (with the exception of accessing the \texttt{/proc} filesystem on Linux), the server part has to keep some persistent state. The naming conventions or internal data format of the files are not meant to be known by profiler users, but you may want to do a backup of the configuration, or move it to another machine.
@@ -2441,6 +2457,7 @@ The following libraries are included with and used by the Tracy Profiler:
 \begin{itemize}
 \item Dear ImGui -- \url{https://github.com/ocornut/imgui}
 \item ImGuiColorTextEdit -- \url{https://github.com/BalazsJako/ImGuiColorTextEdit}
+\item JSON for Modern C++ -- \url{https://github.com/nlohmann/json}
 \end{itemize}
 
 \item Apache license 2.0