From 4d3b32d9f36e8a304e2c71503c7c824376425b0d Mon Sep 17 00:00:00 2001
From: Alexander Wenzel <Alexander.AW.Wenzel@bmw.de>
Date: Thu, 11 Oct 2012 17:39:25 +0200
Subject: Modfied documentation using asciibook.

Signed-off-by: Alexander Wenzel <Alexander.AW.Wenzel@bmw.de>
---
 doc/dlt-convert.1.txt | 87 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 87 insertions(+)
 create mode 100644 doc/dlt-convert.1.txt

(limited to 'doc/dlt-convert.1.txt')

diff --git a/doc/dlt-convert.1.txt b/doc/dlt-convert.1.txt
new file mode 100644
index 0000000..37d4886
--- /dev/null
+++ b/doc/dlt-convert.1.txt
@@ -0,0 +1,87 @@
+DLT-CONVERT(1)
+=============
+:doctype: manpage
+
+NAME
+----
+dlt-convert - Convert DLT Logging files into ASCII
+
+SYNOPSIS
+--------
+*dlt-convert* [-h] [-a] [-x] [-m] [-s][-o filename] [-v] [-c] [-b number] [-e number] [-w] file1 [file2] [file3]
+
+DESCRIPTION
+-----------
+Read DLT files, print DLT messages as ASCII and store the messages again.
+Use Ranges and Output file to cut DLT files.
+Use two files and Output file to join DLT files. 
+
+OPTIONS
+-------
+*-h*::
+    Display a short help text.
+
+*-a*::
+    Print DLT file; payload as ASCII.
+
+*-x*::
+    Print DLT file; payload as hex.
+ 
+*-m*::
+    Print DLT file; payload as hex and ASCII.
+
+*-s*::
+    Print DLT file; only headers.
+
+*-o*::
+    Output messages in new DLT file.
+
+*-v*::
+    Verbose mode.
+
+*-c*::
+    Count number of messages.
+
+*-b*::
+    First messages to be handled.
+
+*-e*::
+    Last message to be handled.
+
+*-w*::
+    Follow dlt file while file is increasing.
+
+EXAMPLES
+--------
+Start DLT daemon in background mode::
+    *dlt-daemon -d*
+
+Start DLT daemon with own configuration::
+    *dlt-daemon -c ~/my-dlt-configuration.cfg*
+
+Convert DLT file into ASCII::
+    *dlt-convert -a mylog.dlt*
+
+Cut a specific range, e.g. from message 1 to message 3 from a file called log.dlt and store the result to a file called newlog.dlt::
+    *dlt-convert -b 1 -e 3 -o newlog.dlt log.dlt*
+
+Paste two dlt files log1.dlt and log2.dlt to a new file called newlog.dlt::
+    *dlt-convert -o newlog.dlt log1.dlt log2.dlt*
+
+EXIT STATUS
+-----------
+Non zero is returned in case of failure.
+
+AUTHOR
+------
+Alexander Wenzel (alexander.aw.wenzel (at) bmw.de)
+
+RESOURCES
+---------
+Main web site: <http://projects.genivi.org/diagnostic-log-trace> +
+Mailinglist: <https://lists.genivi.org/mailman/listinfo/genivi-diagnostic-log-and-trace>
+
+SEE ALSO
+--------
+dlt-daemon(1)
+
-- 
cgit v1.2.1