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
 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
 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.
 
 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:
 
 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
 
 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
 ----
 
 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
 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.
 
 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
 * 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