From 007ce38093c2492f62d7294cf6933643a4107ec5 Mon Sep 17 00:00:00 2001
From: Francois Bleibel <fbleibel@gmail.com>
Date: Mon, 4 Oct 2010 19:00:04 +0900
Subject: [PATCH] Separated Tracer entity documentation.

---
 doc/additionalDoc/package.h   | 38 +-------------------------------
 doc/additionalDoc/tracerdoc.h | 41 +++++++++++++++++++++++++++++++++++
 2 files changed, 42 insertions(+), 37 deletions(-)
 create mode 100644 doc/additionalDoc/tracerdoc.h

diff --git a/doc/additionalDoc/package.h b/doc/additionalDoc/package.h
index 71f7759..27b8d2b 100644
--- a/doc/additionalDoc/package.h
+++ b/doc/additionalDoc/package.h
@@ -67,43 +67,7 @@ is exposed from entities, here is a short description of all the entities contai
 this package. Note that most entities are contained in a binary file that closely matches
 the entities' names in the scripts; loading this file with the plugin loader will
 enable creation of this entity through the factory.
-\li \link dynamicgraph::Tracer Tracer \endlink (generated plugin file tracer.dll or tracer.so)\n
-The \b Tracer entity monitors a set of signals. With an input change on the entity's <trigger> signal,
-the tracked signal values are recorded and traced to a file. The behavior of the trace-to-file
-function can be changed, from printing to a file immediately after recording, to printing out
-only when asked explicitly.\n
-The \b commands that this entity exposes are (you can also type [entity name].help at the
-dynamic-graph shell command line to see this list):
-\code
-open, close (a file);
-add (a signal)
-clear (recorded values);
-record (signal values)
-trace (recorded values to file)
-start, stop (traces)
-\endcode
-\n
-For more information on the signals exposed by this entity, please check the
-code documentation of the dynamicgraph::Tracer class.
-\n\n
-\b Sample \b usage \n
-The following code creates a TracerRealTime entity, then sets the tracing buffer
-size to 10MB. It then tells the tracer to create files with names of the form:
-jl_XXX.dat where XXX is the signal name, and adds a few signals after
-clearing the traces;
-\code
-new TracerRealTime tr
-tr.bufferSize 10485760
-
-tr.open  ${TRACE_REPOSITORY} jl_ .dat
-OpenHRP.periodicCall addSignal tr.triger
-(...)
-# --- TRACE ---
-tr.clear
-tr.add OpenHRP.forceRARM
-tr.add dyn.0
-tr.add jgain.gain
-\endcode
+\li \ref tracerdoc
 \li \link dynamicgraph::TracerRealTime TracerRealTime \endlink
 \li ShellProcedure
 \li ShellFunctions
diff --git a/doc/additionalDoc/tracerdoc.h b/doc/additionalDoc/tracerdoc.h
new file mode 100644
index 0000000..d0553e7
--- /dev/null
+++ b/doc/additionalDoc/tracerdoc.h
@@ -0,0 +1,41 @@
+/**
+\page tracerdoc Tracer
+Generated plugin file tracer.dll or tracer.so.
+\section description Description
+The \b Tracer entity monitors a set of signals. With an input change on the entity's <trigger> signal,
+the tracked signal values are recorded and traced to a file. The behavior of the trace-to-file
+function can be changed, from printing to a file immediately after recording, to printing out
+only when asked explicitly.\n
+The \b commands that this entity exposes are (you can also type [entity name].help at the
+dynamic-graph shell command line to see this list):
+\code
+open, close (a file);
+add (a signal)
+clear (recorded values);
+record (signal values)
+trace (recorded values to file)
+start, stop (traces)
+\endcode
+\n
+For more information on the signals exposed by this entity, please check the
+code documentation of the dynamicgraph::Tracer class.
+\n\n
+\section sample Sample usage
+The following code creates a TracerRealTime entity, then sets the tracing buffer
+size to 10MB. It then tells the tracer to create files with names of the form:
+jl_XXX.dat where XXX is the signal name, and adds a few signals after
+clearing the traces;
+\code
+new TracerRealTime tr
+tr.bufferSize 10485760
+
+tr.open  ${TRACE_REPOSITORY} jl_ .dat
+OpenHRP.periodicCall addSignal tr.triger
+(...)
+# --- TRACE ---
+tr.clear
+tr.add OpenHRP.forceRARM
+tr.add dyn.0
+tr.add jgain.gain
+\endcode
+**/
-- 
GitLab