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>

opensuse: new section

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

ubuntu-ppa: add LTTng-UST agents command lines

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

ubuntu: add Java and Python agent packages

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

preface: update copyright notice

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

Make sure install instructions target LTTng 2.7

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

python-application: add `logging.basicConfig()` to example

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

lttng-adaptation-layer: add required header (since 2.6)

Signed-off-by: Julien Desfossez <jdesfossez@efficios.com>

python-application: missing import in Python example

pid-tracking: copy+paste error in lttng untrack --pid --all

Fix: update UST helper provider and event names

Helpers from LTTng UST, for libdl, libc, and pthread have had their
providers renamed to use a "lttng_" prefix between 2.6 and 2.7. The
libdl helper also had its events renamed from "push" and "pop" to the
more intuitive "dlopen" and "dlclose", respectively.

Signed-off-by: Antoine Busque <abusque@efficios.com>

Fix grammar in "Tracing your own user application"

whats-new: link to announcement blog post

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

whats-new: remove LTTng-modules clock plugin

This feature is for LTTng 2.8.

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

Document PID tracking feature

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

Document Python application logging

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

Document persistent memory file system tracing

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

Fix: CTF and Babeltrace links

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

checkdocs.py: check "int" class before warning

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

controlling-tracing: minor fixes

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

Document tracelog() facility

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

tracef: minor fixes

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

Document kernel events filtering

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

whats-new: update for LTTng 2.7

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

Add sinces

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

java-application: split

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

plumbing 2.6 -> plumbing 2.7

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

Add captions to figures

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

contrib-guide.md: update Images section

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

<div class="img"> -> <figure>

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

lttng-live: fix diagram

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

lttng-relayd: add diagram

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

plumbing-overview: minor fixes

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