X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=README.md;h=ff1d159340e29e8e2fb1e751649257b88835ae56;hp=daeb740f05136fe5d2942909a47d039496f87dd4;hb=509a8fb5e4689594d88f51d2cb800dc76aebac2a;hpb=adf4e918ebd23dd313553f0b11753f8d6b369d9e

diff --git a/README.md b/README.md
index daeb740f0..ff1d15934 100644
--- a/README.md
+++ b/README.md
@@ -20,22 +20,26 @@ components:
     that, the kernel version may probably be older, but we can't provide
     any guarantee. Please let us know if you are able to go lower
     without any problems.
-  - **[`liburcu`](http://urcu.so/) >= 0.8.0**: userspace RCU library,
+  - **[`liburcu`](http://www.liburcu.org/) >= 0.8.0**: userspace RCU library,
     by Mathieu Desnoyers and Paul E. McKenney.
   - **`libpopt` >= 1.13**:  command line arguments parsing library.
     - Debian/Ubuntu package: `libpopt-dev`
   - **`libuuid`**: universally unique ID library
     - Debian/Ubuntu package: `uuid-dev`
+  - **`libxml2` >= 2.7.6**:  XML document parsing library. Needed for
+    tracing session configuration saving/loading and machine interface
+    output support.
+    - Debian/Ubuntu package: `libxml2-dev`
+
 
 The following items are _optional_ dependencies:
 
   - **[Babeltrace](https://lttng.org/babeltrace)**: trace viewer.
     Enables the use of `lttng view` command.
     - Debian/Ubuntu package: `babeltrace`
-  - **`libxml2` >= 2.7.6**:  XML document parsing library. Needed for
-    tracing session configuration saving/loading and machine interface
-    output support.
-    - Debian/Ubuntu package: `libxml2-dev`
+  - **[LTTng UST](https://lttng.org) (same minor version as LTTng Tools)**:
+    userspace tracer. Enables the tracing of userspace applications.
+    - Debian/Ubuntu package: `liblttng-ust-dev`
   - **Perl**: needed for `make check` and tests.
   - **Python >= 3.0**: needed for `make check` and tests.
     - Debian/Ubuntu package: `python3`
@@ -46,7 +50,21 @@ The following items are _optional_ dependencies:
   - **modprobe**: needed for automatic LTTng kernel modules loading
     (kernel tracing).
   - **bash**: needed for running `make check`.
-
+  - **man** (manual pager): needed to view LTTng-tools commands' man
+    pages with the `--help` option or with the `lttng help` command.
+    Note that without `man`, you cannot get offline help with
+    LTTng-tools commands, not even their usage.
+
+LTTng-tools supports both the [LTTng Linux Kernel tracer](https://lttng.org)
+and [LTTng user space tracer](https://lttng.org) released as part of the same
+**minor** release series. While some releases do not change the tracer ABIs and
+should work with, no testing is performed to ensure cross-version compatibility
+is maintained.
+
+Note that applications instrumented with older versions of the LTTng UST project
+do not have to be rebuilt or modified to work with the latest LTTng-tools.
+For more information on versioning, please refer to the
+[LTTng documentation](https://lttng.org/docs).
 
 Building
 --------
@@ -55,17 +73,24 @@ This source tree is based on the Autotools suite from GNU to simplify
 portability. Here are some things you should have on your system in
 order to compile the Git repository tree:
 
-  - GNU Autotools (Automake >= 1.10, Autoconf >= 2.50,
-    Autoheader >= 2.50; make sure your system-wide `automake` points to
-    a recent version!)
-  - [GNU Libtool](http://www.gnu.org/software/autoconf/) >= 2.2
-  - Flex >= 2.5.35
-  - Bison >= 2.4
+  - **GNU Autotools** (**Automake >= 1.10**, **Autoconf >= 2.64**,
+    **Autoheader >= 2.50**; make sure your system-wide `automake` points
+    to a recent version!)
+  - **[GNU Libtool](http://www.gnu.org/software/autoconf/) >= 2.2**
+  - **Flex >= 2.5.35**
+  - **Bison >= 2.4**
+
+Optional packages to build LTTng-tools man pages:
+
+  - **AsciiDoc >= 8.4.5** (previous versions may work, but were
+    not tested)
+  - **xmlto >= 0.0.21** (previous versions may work, but were
+    not tested)
 
 If you use GNU gold, which is _not_ mandatory, make sure you have this
 version:
 
-  - GNU gold >= 2.22
+  - **GNU gold >= 2.22**
 
 Before this version of GNU gold, we hit a
 [known bug](http://sourceware.org/bugzilla/show_bug.cgi?id=11317).
@@ -115,7 +140,7 @@ understand how to use the Python module to control LTTng.
 Contact
 -------
 
-Maintainer: [David Goulet](mailto:dgoulet@efficios.com)
+Maintainer: [Jérémie Galarneau](mailto:jeremie.galarneau@efficios.com)
 
 Mailing list: [`lttng-dev@lists.lttng.org`](https://lttng.org/cgi-bin/mailman/listinfo/lttng-dev)
 
@@ -129,6 +154,7 @@ This package contains the following elements:
   - `include`: the public header files that will be installed on the system.
   - `src/bin`: source code of LTTng-tools programs.
     - `lttng-consumerd`: consumer daemon.
+    - `lttng-crash`: crash trace viewer.
     - `lttng-relayd`: relay daemon.
     - `lttng-sessiond`: session daemon.
     - `lttng`: command line interface for LTTng tracing control.