Doc: Fix broken XRefs

[lilypond.git] / Documentation / included / compile.itexi

diff --git a/Documentation/included/compile.itexi b/Documentation/included/compile.itexi
index 7253087c70ef2588492cb7155dc6c0aa25abc1d1..5568fb5daebd5392e680a29c667791be986be745 100644 (file)
--- a/Documentation/included/compile.itexi
+++ b/Documentation/included/compile.itexi
@@ -159,8 +159,9 @@ check and a full make doc. - James
 @node Fedora
 @unnumberedsubsubsec Fedora
 
-The following instructions were tested on @q{Fedora 22} and include all
-the software to both compile LilyPond and build the documenation.
+The following instructions were tested on @q{Fedora} versions 22 & 23
+and will download all the software required to both compile LilyPond and
+build the documentation.
 
 @itemize
 
@@ -213,7 +214,7 @@ it is recommended that you also need to install @code{git}.
 sudo dnf install git
 @end example
 
-Also see @ruser{Starting with Git}.
+Also see @rcontrib{Starting with Git}.
 
 @item
 To use the @code{lily-git.tcl} GUI;
@@ -222,18 +223,31 @@ To use the @code{lily-git.tcl} GUI;
 sudo dnf install tk
 @end example
 
-See @ruser{lily-git}.
+See @rcontrib{lily-git}.
 
 @end itemize
 
+@warning{By default, when building LilyPond's documentation,
+@code{pdfTeX} is be used.  However ligatures (fi, fl, ff etc.) may not
+be printed in the PDF output.  In this case XeTeX can be used instead.
+Download and install the @code{texlive-xetex} package.
+
+@example
+sudo dnf install texlive-xetex
+@end example
+
+The scripts used to build the LilyPond documentation will use
+@code{XeTex} instead of @code{pdfTex} to generate the PDF documents if
+it is available.  No additional configuration is required.}
+
 
 
 @node Linux Mint
 @unnumberedsubsubsec Linux Mint
 
 The following instructions were tested on @q{Linux Mint 17.1} and
-@q{LMDE - Betsy} and include all the software to both compile LilyPond
-and build the documenation.
+@q{LMDE - Betsy} and will download all the software required to both
+compile LilyPond and build the documentation..
 
 @itemize
 
@@ -283,7 +297,7 @@ it is recommended that you also need to install @code{git}.
 sudo apt-get install git
 @end example
 
-Also see @ruser{Starting with Git}.
+Also see @rcontrib{Starting with Git}.
 
 @item
 To use the @code{lily-git.tcl} GUI;
@@ -292,16 +306,30 @@ To use the @code{lily-git.tcl} GUI;
 sudo apt-get install tk
 @end example
 
-Also see @ruser{lily-git}.
+Also see @rcontrib{lily-git}.
 
 @end itemize
 
+@warning{By default, when building LilyPond's documentation,
+@code{pdfTeX} is be used.  However ligatures (fi, fl, ff etc.) may not
+be printed in the PDF output.  In this case XeTeX can be used instead.
+Download and install the @code{texlive-xetex} package.
+
+@example
+sudo apt-get install texlive-xetex
+@end example
+
+The scripts used to build the LilyPond documentation will use
+@code{XeTex} instead of @code{pdfTex} to generate the PDF documents if
+it is available.  No additional configuration is required.}
+
 
 @node OpenSUSE
 @unnumberedsubsubsec OpenSUSE
 
-The following instructions were tested on @q{OpenSUSE 13.2} and include
-all the software to both compile LilyPond and build the documenation.
+The following instructions were tested on @q{OpenSUSE 13.2} and will
+download all the software required to both compile LilyPond and build
+the documentation.
 
 @itemize
 
@@ -334,10 +362,10 @@ contribute to LilyPond (codebase or help improve the documentation) then
 it is recommended that you also need to install @code{git}.
 
 @example
-sudo apt-get install git
+sudo zypper install git
 @end example
 
-Also see @ruser{Starting with Git}.
+Also see @rcontrib{Starting with Git}.
 
 @item
 To use the @code{lily-git.tcl} GUI;
@@ -346,18 +374,29 @@ To use the @code{lily-git.tcl} GUI;
 sudo zypper install tk
 @end example
 
-Also see @ruser{lily-git}.
+Also see @rcontrib{lily-git}.
 
 @end itemize
 
+@warning{By default, when building LilyPond's documentation,
+@code{pdfTeX} is be used.  However ligatures (fi, fl, ff etc.) may not
+be printed in the PDF output.  In this case XeTeX can be used instead.
+Download and install the @code{texlive-xetex} package.
 
+@example
+sudo zypper install texlive-xetex
+@end example
+
+The scripts used to build the LilyPond documentation will use
+@code{XeTex} instead of @code{pdfTex} to generate the PDF documents if
+it is available.  No additional configuration is required.}
 
 @node Ubuntu
 @unnumberedsubsubsec Ubuntu
 
 The following commands were tested on Ubuntu versions @code{14.04 LTS},
-@code{14.10} and @code{15.04} and include all the software to both
-compile LilyPond and build the documenation.
+@code{14.10} and @code{15.04} and will download all the software
+required to both compile LilyPond and build the documentation.
 
 @itemize
 
@@ -373,7 +412,7 @@ sudo apt-get build-dep lilypond
 Download and install additional @q{build} tools required for compiling;
 
 @example
-sudo apt-get install autoconf fonts-texgyre texlive-land-cyrillic
+sudo apt-get install autoconf fonts-texgyre texlive-lang-cyrillic
 @end example
 
 @item
@@ -385,7 +424,7 @@ it is recommended that you also need to install @code{git}.
 sudo apt-get install git
 @end example
 
-Also see @ruser{Starting with Git}.
+Also see @rcontrib{Starting with Git}.
 
 @item
 To use the @code{lily-git.tcl} GUI;
@@ -394,10 +433,23 @@ To use the @code{lily-git.tcl} GUI;
 sudo apt-get install tk
 @end example
 
-Also see @ruser{lily-git}.
+Also see @rcontrib{lily-git}.
 
 @end itemize
 
+@warning{By default, when building LilyPond's documentation,
+@code{pdfTeX} is be used.  However ligatures (fi, fl, ff etc.) may not
+be printed in the PDF output.  In this case XeTeX can be used instead.
+Download and install the @code{texlive-xetex} package.
+
+@example
+sudo apt-get install texlive-xetex
+@end example
+
+The scripts used to build the LilyPond documentation will use
+@code{XeTex} instead of @code{pdfTex} to generate the PDF documents if
+it is available.  No additional configuration is required.}
+
 
 @node Other
 @unnumberedsubsubsec Other
@@ -508,10 +560,10 @@ is available online at
 you can also build them locally from the source code.  This process
 requires some additional tools and packages.
 
-@warning{If you have used the instructions for one of the Linux
-distributions explicitly listed in the previous section
-(@rcontrib{Requirements for compiling LilyPond}) then the following can
-be ignored as the software should already be installed.}
+@warning{If the instructions for one of the previously listed Linux
+in the previous section (@rcontrib{Requirements for compiling LilyPond})
+have been used, then the following can be ignored as the software should
+already be installed.}
 
 @itemize
 
@@ -571,6 +623,13 @@ ttf-xfree86-nonfree
 
 @end itemize
 
+@warning{By default, when building LilyPond's documentation,
+@code{pdfTeX} is be used.  However ligatures (fi, fl, ff etc.) may not
+be printed in the PDF output.  In this case XeTeX can be used instead.
+Download and install the @code{texlive-xetex} package. The scripts used
+to build the LilyPond documentation will use @code{XeTex} instead of
+@code{pdfTex} to generate the PDF documents if it is available.  No
+additional configuration is required.}
 
 
 @node Getting the source code
@@ -1402,10 +1461,10 @@ installation directory structure.
 
 
 It can be useful to have both the stable and the development versions
-of Lilypond available at once.  One way to do this on GNU/Linux is to
+of LilyPond available at once.  One way to do this on GNU/Linux is to
 install the stable version using the precompiled binary, and run the
 development version from the source tree.  After running @command{make
-all} from the top directory of the Lilypond source files, there will
+all} from the top directory of the LilyPond source files, there will
 be a binary called @code{lilypond} in the @code{out} directory:
 
 @example