@c leave these lines wrapping around. It's some texinfo 4.12 thing. -gp
@c This is actually a limitation of texi2html. -jm
@menu
-* About the Learning Manual (LM):: this manual introduces LilyPond, giving in-depth explanations of how to create notation.
-
-* About the Music Glossary (MG):: this manual explains musical terms and gives translations of terms in other languages.
-
-* About the Notation Reference (NR):: this manual is the main portion of the documentation. It provides detailed information about creating notation. This book assumes that the reader knows basic material covered in the LM and is familiar with the English musical terms presented in the MG.
-
-* About the Application Usage (AU):: this discusses the actual programs and operating system-specific issues.
-
-* About the Snippet List (SL):: this is a collection of short LilyPond examples.
-
-* About the Internals Reference (IR):: this document gives reference information about LilyPond's internal structures, which is required for constructing tweaks.
-
+* About the Learning Manual:: this manual introduces LilyPond, giving in-depth explanations of how to create notation.
+* About the Music Glossary:: this manual explains musical terms and gives translations of terms in other languages.
+* About the Notation Reference:: this manual is the main portion of the documentation. It provides detailed information about creating notation. This book assumes that the reader knows basic material covered in the LM and is familiar with the English musical terms presented in the MG.
+* About the Application Usage:: this discusses the actual programs and operating system-specific issues.
+* About the Snippet List:: this is a collection of short LilyPond examples.
+* About the Internals Reference:: this document gives reference information about LilyPond's internal structures, which is required for constructing tweaks.
* Other documentation:: there are a few other portions of the documentation, such as News items and the mailist archives.
-
@end menu
-@node About the Learning Manual (LM)
-@unnumberedsubsec About the Learning Manual (LM)
+@node About the Learning Manual
+@unnumberedsubsec About the Learning Manual
This book explains how to begin learning LilyPond, as well as
explaining some key concepts in easy terms. You should read these
@end itemize
-The LM also contains appendices which are not part of the
+The Learning Manual also contains appendices which are not part of the
recommended linear reading. They may be useful for later
viewing:
@end itemize
-@node About the Music Glossary (MG)
-@unnumberedsubsec About the Music Glossary (MG)
+@node About the Music Glossary
+@unnumberedsubsec About the Music Glossary
@cindex idiom
@cindex jargon
it is highly advisable to consult the glossary.
-@node About the Notation Reference (NR)
-@unnumberedsubsec About the Notation Reference (NR)
+@node About the Notation Reference
+@unnumberedsubsec About the Notation Reference
This book explains all the LilyPond commands which produce
notation. It assumes that readers are familiar with the concepts
-in the Learning manual.
+in the Learning Manual.
@itemize
@end itemize
-The NR also contains appendices with useful reference charts.
+The Notation Reference also contains appendices with useful
+reference charts.
@itemize
@end itemize
-@node About the Application Usage (AU)
-@unnumberedsubsec About the Application Usage (AU)
+@node About the Application Usage
+@unnumberedsubsec About the Application Usage
This book explains how to execute the programs and how to integrate
LilyPond notation with other programs.
@item
@rprogram{Install}:
-explains how to install LilyPond (including compilation if
-desired).
+explains how to install LilyPond, including compilation if
+desired.
@item
@rprogram{Setup}:
@end itemize
-@node About the Snippet List (SL)
-@unnumberedsubsec About the Snippet List (SL)
+@node About the Snippet List
+@unnumberedsubsec About the Snippet List
@cindex snippets
@cindex LSR
(NR) are also linked from the @strong{See also} portion.
-@node About the Internals Reference (IR)
-@unnumberedsubsec About the Internals Reference (IR)
+@node About the Internals Reference
+@unnumberedsubsec About the Internals Reference
@rinternalsnamed{Top,Internals Reference}: this is a set
of heavily cross linked HTML pages which document the nitty-gritty
@itemize
-@item News: This is a summary of important changes
+@item
+@ifhtml
+@ifset bigpage
+@uref{../topdocs/NEWS.html,News}:
+@end ifset
+@ifclear bigpage
+@uref{../../topdocs/NEWS.html,News}:
+@end ifclear
+@end ifhtml
+@ifnothtml
+News:
+@end ifnothtml
+this is a summary of important changes
and new features in LilyPond since the previous version.
@item @uref{http://lists.gnu.org/archive/html/lilypond-user/, The
music fragments embedded, the exact LilyPond input that was used
to produce that image can be viewed by clicking the image.
-@item Init files: The location of the documentation files that are
+@item Init files: the location of the documentation files that are
mentioned here can vary from system to system. On occasion, this
-manual refers to initialization and example files. Throughout
-this manual, we refer to input files relative to the top-directory
-of the source archive. For example,
-@file{input/@/lsr/@/dirname/@/bla@/.ly} may refer to the file
-@file{lilypond@/2.x.y/@/input/@/lsr/@/dirname/@/bla@/.ly}. On
-binary packages for the UNIX platform, the documentation and
-examples can typically be found somewhere below
+manual refers to initialization and example files. Throughout this
+manual, we refer to input files relative to the top-directory of the
+source archive. For example, @file{input/@/lsr/@/dirname/@/bla@/.ly}
+may refer to the file
+@file{lilypond@/2.x.y/@/input/@/lsr/@/dirname/@/bla@/.ly}. On binary
+packages for the UNIX platform, the documentation and examples can
+typically be found somewhere below
@file{/usr/@/share/@/doc/@/lilypond/}. Initialization files, for
-example @file{scm/@/lily@/.scm}, or
-@file{ly/@/engraver@/-init@/.ly}, are usually found in the
-directory @file{/usr/@/share/@/lilypond/}.
+example @file{scm/@/lily@/.scm}, or @file{ly/@/engraver@/-init@/.ly},
+are usually found in the directory @file{/usr/@/share/@/lilypond/}.
+For more details, see @ref{Other sources of information}.
@end itemize
-