Use double quotes for full section names

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

diff --git a/common/acknowledgements.txt b/common/acknowledgements.txt
index 3234875f57f124d7fa5acd75fec0a8abf6cd421d..932de9ce5256b712fc492c7949f016381e34ce81 100644 (file)
--- a/common/acknowledgements.txt
+++ b/common/acknowledgements.txt
@@ -4,16 +4,15 @@
 A few people made the online LTTng Documentation possible.
 
 http://eepp.ca/[Philippe Proulx] wrote most of the content, created
-the diagrams, and formatted the document. He is the current maintainer
+the diagrams, and formatted the document. He's the current maintainer
 of the LTTng Documentation.
 
 Daniel U. Thibault, from the DRDC, wrote
-http://cradpdf.drdc-rddc.gc.ca/PDFS/unc246/p804561_A1b.pdf[LTTng:
-The Linux Trace Toolkit Next Generation{nbsp}—{nbsp}A
-Comprehensive User's Guide (version 2.3 edition)] which was used
-to complete parts of the <<core-concepts,Core concepts>> and
-<<plumbing,Components of LTTng>> sections and for a few passages here
-and there.
+``http://cradpdf.drdc-rddc.gc.ca/PDFS/unc246/p804561_A1b.pdf[LTTng: The
+Linux Trace Toolkit Next Generation{nbsp}&#8212;{nbsp}A Comprehensive
+User's Guide (version 2.3 edition)]'' which was used to complete parts
+of the ``<<core-concepts,Core concepts>>'' and ``<<plumbing,Components
+of LTTng>>'' sections and for a few passages here and there.
 
 The entire http://www.efficios.com/[EfficiOS] team made essential reviews
 of the whole document.

diff --git a/common/convention.txt b/common/convention.txt
index edb6174b553389279ac921aca8fce8a8375276c4..a7274c2eebbf846479f911c7bc8f25d23d93aa62 100644 (file)
--- a/common/convention.txt
+++ b/common/convention.txt
@@ -10,14 +10,14 @@ following sentence.
 Practical tips and notes are given throughout the document using the
 following style:
 
-TIP: Make sure you read the tips.
+TIP: Read the tips.
 
 Terminal boxes are used to show command lines:
 
 [role="term"]
 ----
 $ echo Command line as a regular user
-# echo Command line as a priviledged user
+# echo Command line as a the `root` user
 ----
 
 Command lines which you need to execute as a priviledged user start with

diff --git a/common/welcome.txt b/common/welcome.txt
index ac73634548db7ff294787f62fc38952437f8a59b..0c3fc741d3e671a258e94d57fdc9ab17d77fafad 100644 (file)
--- a/common/welcome.txt
+++ b/common/welcome.txt
@@ -4,13 +4,13 @@
 Welcome to the **LTTng Documentation**!
 
 The _Linux Trace Toolkit: next generation_ is an open source software
-toolkit which you can use to simultaneously trace the Linux kernel, user
-applications, and user libraries.
+toolkit which you can use to trace the Linux kernel, user applications,
+and user libraries at the same time.
 
 LTTng consists of:
 
 * Kernel modules to trace the Linux kernel.
-* Shared libraries to trace user applications written in C or C++.
+* Shared libraries to trace C/$$C++$$ user applications.
 * Java packages to trace Java applications which use `java.util.logging`
   or Apache log4j 1.2.
 * A Python package to trace Python applications which use the standard