2.11: remove paragraph about features reserved to some tracing domains

Technically, user space probes (new to 2.11) are still part of the
kernel tracing domain (you need to use the `--kernel` option), but it's
more confusing than anything in this context.

Closes #29
Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.11: add Arch Linux installation instructions

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.10, 2.11: fix `fine-une` typo

2.11: finalize first publishable version of the LTTng 2.11 documentation

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.10: update installation

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.10, 2.11: do not use `lttng stop`, then `lttng destroy` (implicit)

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.10, 2.11: `lttng stop` makes the trace readable

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Buildroot: installing-lttng: remove superfluous double quotes

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.10: add missing "Buildroot" section

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.9: not maintained anymore

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Document LTTng 2.11

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.10: update installation instructions

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Fix: 2.10: wildcards are supported anywhere in TP/syscall names

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Fix: broken links

The lttng-consumerd(8) man page does not exist because it's not a daemon
directly launched by the user.

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Update ST3 syntax definition

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Add ST3 syntax definition for EfficiOS AsciiDoc

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.9, 2.10: update installation

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.10: installation: LTTng 2.9 is available for Ubuntu 17.10 too

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.9: do not use xref, use <<...>> with attribute list

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.9, 2.10: update installation instructions

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.10: --blocking-timeout uses `inf` instead of -1 for infinity

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.8, 2.9, 2.10: since 2.8, LTTng keeps lost sub-buffer count in overwrite mode

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.10: --blocking-timeout is only available in --discard mode

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.10: notification API example: fix some comments and code

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.10: notification API example: indent C snippet with 4 spaces

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.10: document the notification and trigger API, --monitor-timer option

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

CONTRIBUTING.adoc: fix terminal box style in example

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.10: put full stop at the end of example's title, not colon

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.10: use relative link, without `lttng.org`

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Document LTTng 2.10

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.7, 2.8, 2.9: occurance -> occurrence

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.9: update installation instructions and availability

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.8: fix wrong OS name in some notes

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.7, 2.8, 2.9: update last modification date

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

linux-add-lttng-layer: probes/Makefile -> probes/KBuild

Fixes: #22
Reported-by: @aleixrocks
Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

welcome: reword a part

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.8, 2.0: add link to channel-switch-timer

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

copyright.txt: update years

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.8, 2.9: installation: update availability and instructions

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.8, 2.9: use `$` and `#` prompts in terminal boxes

I found a way to pick those prompts and put them in a separate,
non-selectable <pre> element on the website version so that you can see
the prompts, but you can also select all the command lines and copy them
without copying the prompts.

It's more instinctive for the typical reader to immediately recognize
command lines when they start with the classic prompts.

Also update CONTRIBUTING.adoc to indicate to use the prompts in
terminal boxes.

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Merge branch 'fix_live' of https://github.com/PSRCode/lttng-docs

Typo: intead -> instead

... to the relay daemon running on the remote system intead of flushing them to the local file system.

Closes: #20
Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

tracing-the-linux-kernel: add missing sudo commands

Fixes: #18
Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.7, 2.8, 2.9: add my-session to shm example

Other examples introducing an arguments provide a dummy session
name.

Signed-off-by: Jonathan Rajotte <jonathan.rajotte-julien@efficios.com>

2.7, 2.8, 2.9: put session name before arguments for create command

Signed-off-by: Jonathan Rajotte <jonathan.rajotte-julien@efficios.com>

2.7, 2.8, 2.9: put --live after session name

"--live" have an optional argument. The session name is treated as
"--live" argument returning an error.

Signed-off-by: Jonathan Rajotte <jonathan.rajotte-julien@efficios.com>

Merge branch 'master' of https://github.com/jgalar/lttng-docs

2.8: fix link to GCC's -finstrument-functions

Suggested-by: Ricardo Nabinger Sanchez <rnsanchez@wait4.org>
Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.9: fix link to GCC's -finstrument-functions

Signed-off-by: Ricardo Nabinger Sanchez <rnsanchez@wait4.org>

32 bit consumer build: disable build of other components

Signed-off-by: Jérémie Galarneau <jeremie.galarneau@efficios.com>

2.9: document LTTng-UST agent instrumentation points

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.8: document LTTng-UST agent instrumentation points

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.8, 2.9: add release names and descriptions

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Makefile: add automatic view targets

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.8, 2.9: getting-started: fix and update procedures

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.8, 2.9: fix and add links to tracing-group

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.8, 2.9: add links to distribution websites

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.8: installation: reorder sections to match table order

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.8, 2.9: LTTng 2.8 available for Buildroot 2016.11

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.5, 2.6: installation steps are outdated

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Document LTTng 2.9

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.7: not supported anymore

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

"line" -> "lines" when more than one line

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.8: update installation instructions

Fedora 25 is out. The AUR has the packages for
LTTng 2.9 now. Drop links to the obsolete LTTng 2.7.

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

acknowledgements: add link to DRDC's document

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

ubuntu: LTTng-UST Python agent only for Python 3

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.7: mention LTTng 2.8 on AUR alternative

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

alpine-linux: split LTTng-tools and LTTng-UST names

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Add install instructions for Arch Linux

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Fix nbsp for Ubuntu names

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Fix validation tool

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

installing-lttng: update alternatives for Fedora

LTTng-modules is not packaged for Fedora.

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

addr2line: link to man page

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Add legend for build scenario diagram symbols

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.8: whats-new: add link to metadata-regenerate

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.8: Update OE/Yocto version

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

2.7: update OE/Yocto version

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Document LTTng 2.8

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Convert documentation to AsciiDoc

This huge patch converts the LTTng Documentation sources to the
AsciiDoc format. A few advantages of this move are:

* The AsciiDoc language is much more complete and semantically
  correct than Markdown (or even kramdown). Labeled lists,
  source file inclusion, admonition blocks, custom block and
  inline elements, and complex table layouts are just a few
  of the many features that Markdown lacks and which are needed
  for a high quality technical documentation. The previous
  solution to have those features was to embed HTML elements in
  the Markdown source files, which is a bad idea for an
  appropriate separation of presentation and content.
* The asciidoc(1) tool can convert an AsciiDoc input file to
  a DocBook XML file, making it possible to render the LTTng
  Documentation in any desired format thanks to XSLT and/or
  custom scripts.
* The asciidoc(1) tool can also convert an AsciiDoc input file
  to an HTML5 file, so that the LTTng Documentation can be
  previewed by anyone with tools that are available for all
  the major distributions.

The actual content of the documentation is also completely altered
here. A major overhaul was necessary after two years of untouched
content. The text of v2.7 now follows the Microsoft Manual of Style
(4th Edition), as it is clearly stated in the new
CONTRIBUTING.adoc file. Various improvements are introduced to this
documentation, including:

* Diagrams are redesigned and updated, and new diagrams are
  added.
* The "What's new" section presents the new features as categorized
  lists instead of flat paragraphs.
* The "What is tracing?" section was proofread by a professional.
* LTTng alternatives are added.
* More tables are used.
* New LTTng availability in major distributions.
* Clear examples.
* New glossary section.

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

domain: add Python domain to list

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

online-manpages: add link to man pages index

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

online-lttng-manpages: add missing lttng-crash(1)

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Update man pages links to v2.7

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

lttng-modules-tp-fields: add since note

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

instrumenting-linux-kernel-itself: document LTTNG_TRACEPOINT_EVENT_CODE()

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

lttng-modules-tp-fields: since 2.7

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

CONTRIBUTING.md: remove note about impersonal tense

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Update LTTng-modules API

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

docs2json: no errors/warnings with simple anchors

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Rename contrib-guide.md -> CONTRIBUTING.md

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Fix Ubuntu install documentation regarding the PPA

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Add dotlinks.py

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Create docs2json.py and remove checkdocs.py

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Remove weird hyphens from files

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Add links to Java/Python application sections

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

checkdocs.py: fix NoneType error

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

Add instructions about getting LTTng-UST agents

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

archlinux: add Python agent packages

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

opensuse: zypper -> `zypper`

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

installing-lttng: fix internal link

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>