Add babeltrace.1 manpage

Signed-off-by: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>

diff --git a/Makefile.am b/Makefile.am
index 4fed4e8e5e533cbbee10eb5b66b85a4a2044a9f3..0a9bb9abe17d5250c3e342fac2bc9c666e70388d 100644 (file)
--- a/Makefile.am
+++ b/Makefile.am
@@ -2,7 +2,7 @@ AM_CFLAGS = $(PACKAGE_CFLAGS) -I$(top_srcdir)/include
 
 ACLOCAL_AMFLAGS = -I m4
 
 
 ACLOCAL_AMFLAGS = -I m4
 

-SUBDIRS = include types formats lib converter tests
+SUBDIRS = include types formats lib converter tests doc

 
 dist_doc_DATA = ChangeLog LICENSE mit-license.txt gpl-2.0.txt \
                std-ext-lib.txt
 
 dist_doc_DATA = ChangeLog LICENSE mit-license.txt gpl-2.0.txt \
                std-ext-lib.txt

diff --git a/configure.ac b/configure.ac
index 3ff87df49ce1e8cecf685368b1cb079a0b927412..a2d41044bd84ea93adb05df7c9605bacc536ae9b 100644 (file)
--- a/configure.ac
+++ b/configure.ac
@@ -66,6 +66,7 @@ AC_CONFIG_FILES([
        formats/bt-dummy/Makefile
        formats/ctf/metadata/Makefile
        converter/Makefile
        formats/bt-dummy/Makefile
        formats/ctf/metadata/Makefile
        converter/Makefile

+       doc/Makefile

        lib/Makefile
        lib/prio_heap/Makefile
        include/Makefile
        lib/Makefile
        lib/prio_heap/Makefile
        include/Makefile

diff --git a/doc/Makefile.am b/doc/Makefile.am
new file mode 100644 (file)
index 0000000..31ade45
--- /dev/null
+++ b/doc/Makefile.am
@@ -0,0 +1 @@
+dist_man_MANS = babeltrace.1

diff --git a/doc/babeltrace.1 b/doc/babeltrace.1
new file mode 100644 (file)
index 0000000..c9bb723
--- /dev/null
+++ b/doc/babeltrace.1
@@ -0,0 +1,130 @@
+.TH "BABELTRACE" "1" "February 6, 2012" "" ""
+
+.SH "NAME"
+babeltrace \(em Babeltrace Trace Viewer and Converter
+
+.SH "SYNOPSIS"
+
+.PP
+.nf
+babeltrace [OPTIONS] INPUT <OUTPUT>
+.fi
+.SH "DESCRIPTION"
+
+.PP
+Babeltrace is a trace viewer and converter reading and writing the
+Common Trace Format (CTF). Its main use is to pretty-print CTF traces
+into a human-readable text output.
+
+.PP
+This program follow the usual GNU command line syntax with long options
+starting with two dashes. Below is a summary of the available options.
+.PP
+
+.TP
+.BR "INPUT"
+Input trace path
+.TP
+.BR "OUTPUT"
+Output trace path (default: stdout)
+.TP
+.BR "-i, --input-format FORMAT"
+Input trace format (default: ctf)
+.TP
+.BR "-o, --output-format FORMAT"
+Output trace format (default: text)
+.TP
+.BR "-h, --help"
+This help message
+.TP
+.BR "-l, --list"
+List available formats
+.TP
+.BR "-v, --verbose"
+Verbose mode (or set BABELTRACE_VERBOSE environment variable)
+.TP
+.BR "-d, --debug"
+Debug mode (or set BABELTRACE_DEBUG environment variable)
+.TP
+.BR "--no-delta"
+Do not print time delta between consecutive events
+.TP
+.BR "-n, --names name1<,name2,...>"
+Print field names: (payload OR args OR arg), all, scope, header,
+(context OR ctx), (payload active by default).
+.TP
+.BR "-f, --fields name1<,name2,...>"
+Print additional fields: all, trace, trace:domain, trace:procname,
+trace:vpid, loglevel.
+.TP
+.BR "--clock-raw"
+Disregard internal clock offset (use raw value)
+.TP
+.BR "--clock-offset seconds"
+Clock offset in seconds
+.TP
+.BR "--clock-seconds"
+Print the timestamps as [sec.ns] (default is: [hh:mm:ss.ns])
+.TP
+.BR "--clock-date"
+Print clock date
+.TP
+.BR "--clock-gmt"
+Print clock in GMT time zone (default: local time zone)
+.TP
+
+.fi
+Formats available: ctf, dummy, text.
+
+.SH "ENVIRONMENT VARIABLES"
+
+.PP
+Note that all command line options will override environmenal variables.
+.PP
+
+.PP
+.IP "BABELTRACE_VERBOSE"
+Activate verbose Babeltrace output.
+.PP
+.IP "BABELTRACE_DEBUG"
+Activate debug Babeltrace output.
+
+.SH "SEE ALSO"
+
+.PP
+lttng-tools(1), lttng-ust(3), lttng-sessiond(8)
+.PP
+.SH "BUGS"
+
+.PP
+No knows bugs at this point.
+
+If you encounter any issues or usability problem, please report it on
+our mailing list <lttng-dev@lists.lttng.org> to help improve this
+project.
+.SH "CREDITS"
+
+Babeltrace and the babeltrace library are distributed under the MIT
+license. See the files LICENSE and mit-license.txt for details.
+.PP
+A Web site is available at http://www.efficios.com/babeltrace for more
+information on Babeltrace and the Common Trace Format. See
+http://lttng.org for more information on the LTTng project.
+.PP
+Mailing list for support and development: <lttng-dev@lists.lttng.org>.
+.PP
+You can find us on IRC server irc.oftc.net (OFTC) in #lttng.
+.PP
+.SH "THANKS"
+
+Thanks to the Linux Foundation and Ericsson for funding part of this
+work. Thanks to the Multicore Association Tool Infrastructure Working
+Group for their active role in the creation of the Common Trace Format.
+.pp
+.SH "AUTHORS"
+
+.PP
+Babeltrace was originally written by Mathieu Desnoyers, with additional
+contributions from various other people. It is currently maintained by
+Mathieu Desnoyers <mathieu.desnoyers@efficios.com>.
+.PP