From 43f3482adf5eee657e5ba922733dfff6600c4e14 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?H=C3=A5kan=20Mattsson?= Date: Wed, 3 Feb 2010 08:59:06 +0000 Subject: OTP-8058 The GUI parts are rewritten to use wxWidgets. Thanks Olle Mattsson! For the time being it is still possible to use the old GS based version of the tool, but it is deprecated. The wxWidgets based version is started by default. A new tutorial has been added to the documentation. It is based on Jayson Vantuyl's article http://souja.net/2009/04/making-sense-of-erlangs-event-tracer.htm l. The functions et:trace_me/4 and et:trace_me/5 has been introduced in order to replace the deprecated functions et:report_event/4 and et:report_event/5. Hopefully the new names makes it a little more obvious what the intended usage of the functions are. A print function has been added to the GUI, in order to enable printing of sequence charts. More functionality for hiding unwanted events has been added to the GUI. The max_events, hide_unknown and display_mode configuration parameters to et_viewer is not used any more. Now the event cache in the Viewer only contains those events that actually are displayed in the GUI. --- lib/et/doc/src/et_intro.xml | 82 +++++++++++++++++++++++++++++---------------- 1 file changed, 53 insertions(+), 29 deletions(-) (limited to 'lib/et/doc/src/et_intro.xml') diff --git a/lib/et/doc/src/et_intro.xml b/lib/et/doc/src/et_intro.xml index 8dfa678b11..0c5fb14d55 100644 --- a/lib/et/doc/src/et_intro.xml +++ b/lib/et/doc/src/et_intro.xml @@ -4,7 +4,7 @@
- 20022009 + 20022010 Ericsson AB. All Rights Reserved. @@ -13,12 +13,12 @@ compliance with the License. You should have received a copy of the Erlang Public License along with this software. If not, it can be retrieved online at http://www.erlang.org/. - + Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License. - + Introduction @@ -31,65 +31,89 @@ %VSN% et_intro.xml
-

The Event Tracer (ET) uses the built-in trace mechanism in Erlang - and provides tools for collection and graphical viewing of trace - data.

-

The viewed trace data is normally collected from Erlang trace ports - or files.

+ +

The Event Tracer (ET) uses the built-in trace mechanism in + Erlang and provides tools for collection and graphical viewing of + trace data.

+ +

The viewed trace data is normally collected from Erlang trace + ports or files.

- Scope and Purpose -

This manual describes the Event Tracer (ET) application, as a component - of the Erlang/Open Telecom Platform development environment. It - is assumed that the reader is familiar with the Erlang - Development Environment, which is described in a separate User's - Guide.

+ Scope and Purpose' + +

This manual describes the Event Tracer (ET) application, + as a component of the Erlang/Open Telecom Platform development + environment. It is assumed that the reader is familiar with the + Erlang Development Environment, which is described in a separate + User's Guide.

Prerequisites +

The following prerequisites is required for understanding the - material in the Event Tracer (ET) User's Guide:

+ material in the Event Tracer (ET) User's Guide:

+ -

familiarity with the Erlang system and Erlang programming in - general and the especially the art of Erlang tracing.

+

familiarity with the Erlang system and Erlang programming + in general and the especially the art of Erlang tracing.

-

The application requires Erlang/OTP release R7B or later.

+ +

The application requires Erlang/OTP release R13BB or later. If + you use the old GS based GUI it does suffice with R7B.

+
About This Manual -

In addition to this introductory chapter, the Megaco User's - Guide contains the following chapters:

+ +

In addition to this introductory chapter, the Event + Tracers User's Guide contains the following chapters:

+ -

Chapter 2: "Usage" describes the architecture - and typical usage of the application.

+

Chapter 2: "Tutorial" provides a walk-through of the + various parts of the application. The tutorial is based on + Jayson Vantuyl's article + http://souja.net/2009/04/making-sense-of-erlangs-event-tracer.html.

+
+ + +

Chapter 3: "Description" describes the architecture and typical + usage of the application.

+ -

Chapter 3: "Examples" gives some usage examples

+

Chapter 4: "Advanced examples" gives some usage examples

+
Where to Find More Information +

Refer to the following documentation for more information about - Event Tracer (ET) and about the Erlang/OTP development system:

+ Event Tracer (ET) and about the Erlang/OTP development system:

+

the Reference Manual of the Event Tracer (ET).

+ -

documentation of basic tracing in erlang:trace/4 and - erlang:trace_pattern/3 and then the utilities derived from - these: dbg, observer and et.

+

documentation of basic tracing in erlang:trace/4 and + erlang:trace_pattern/3 and then the utilities derived + from these: dbg, observer, invisio and + et.

+ -

Concurrent Programming in Erlang, 2nd Edition (1996), - Prentice-Hall, ISBN 0-13-508301-X.

+

Programming Erlang: Software for a Concurrent World by Joe + Armstrong; ISBN: 978-1-93435-600-5

-- cgit v1.2.3