version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.38"
+@c \version "2.11.51"
@node Introduction
@chapter Introduction
@c < > is not a music expression,
@c so we use <<>> iso. <> to drive home the point of
@c expressions. Don't change this back --hwn.
+
+@c FIXME: change this. I can explain it better. -gp
@example
<<c4 d4 e4>>
@end example
@node About the documentation
@section About the documentation
-FIXME: still needs some work.
-
-This section explains the different manuals:
+This section explains the different portions of the documentation.
-@itemize
-@item
-Learning Manual (LM): this introduces LilyPond, giving in-depth
-explanations of how to create notation.
+@c leave these lines wrapping around. It's some texinfo 4.12 thing. -gp
+@menu
+* About the Learning Manual (LM):: this manual introduces LilyPond, giving in-depth explanations of how to create notation.
-@item
-Music Glossary (MG): this explains musical terms and gives
-translations of terms in other languages.
+* About the Music Glossary (MG):: this manual explains musical terms and gives translations of terms in other languages.
-@item
-Notation Reference (NR): this 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 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.
-@item
-Application Usage (AU): this discusses the actual programs and
-operation system-specific issues.
+* About the Application Usage (AU):: this discusses the actual programs and operation system-specific issues.
-@item
-Snippet List (SL): this is a collection of short LilyPond examples
-(@qq{snippets}).
+* About the Snippet List (SL):: this is a collection of short LilyPond examples.
-@item
-Internals Reference (IR): this gives information about LilyPond
-internal programming information, which is required for
-constructing tweaks.
+* About the Internals Reference (IR):: this document gives information about LilyPond internal programming information, which is required for constructing tweaks.
-@item
-Other documentation: there are a few other portions of the
-documentation, such as News items and the mailist archives.
+* Other documentation:: there are a few other portions of the documentation, such as News items and the mailist archives.
-@end itemize
-
-@menu
-* About the Learning Manual (LM)::
-* About the Music Glossary (MG)::
-* About the Notation Reference (NR)::
-* About the Application Usage (AU)::
-* About the Snippet List (SL)::
-* About the Internals Reference (IR)::
-* Other documentation::
@end menu
@unnumberedsubsec About the Learning Manual (LM)
This book explains how to begin learning LilyPond, as well as
-explaining some key concepts in easy terms. It is recommended to
-read these chapters in a linear fashion.
+explaining some key concepts in easy terms. You should read these
+chapters in a linear fashion.
@itemize
+@item
+@ref{Introduction}: explains the background and overall goal of
+LilyPond.
+
@item
@ref{Tutorial}: gives a gentle introduction to typesetting music.
First time users should start here.
the LilyPond file format. If you are not certain where to place a
command, read this chapter!
+@item
+@ref{Tweaking output}: shows how to change the default engraving
+that LilyPond produces.
+
@item
@ref{Working on LilyPond projects}: discusses practical uses of
-LilyPond and how to avoid some common problems.
+LilyPond and how to avoid some common problems. Read this before
+undertaking large projects!
+
+@end itemize
+
+The LM also contains appendices which are not part of the
+recommended linear reading. They may be useful for later
+viewing:
+
+@itemize
@item
-@ref{Tweaking output}: shows how to change the default engraving
-that LilyPond produces.
+@ref{Templates}: shows ready-made templates of LilyPond pieces.
+Just cut and paste a template into a file, add notes, and you're
+done!
+
+@item
+@ref{Scheme tutorial}: presents a short introduction to Scheme,
+the programming language that music functions use. This is
+material for advanced tweaks; many users never touch Scheme at
+all.
@end itemize
@itemize
@item
-@ruser{Basic notation}:
-discusses topics grouped by notation construct. This section gives
-details about basic notation that will be useful in almost any
-notation project.
+@ruser{Musical notation}:
+discusses topics grouped by notation construct. This section
+gives details about basic notation that will be useful in almost
+any notation project.
@item
@ruser{Specialist notation}:
-discusses topics grouped by notation construct. This section gives
-details about special notation that will only be useful for particular
-instrument (or vocal) groups.
+discusses topics grouped by notation construct. This section
+gives details about special notation that will only be useful for
+particular instrument (or vocal) groups.
@item
@ruser{Input syntax}:
-
-@item
-@ruser{Non-musical notation}:
+discusses general information about LilyPond files and controlling
+output.
@item
@ruser{Spacing issues}:
@item
@ruser{Changing defaults}:
+explains how to tweak LilyPond to produce exactly the notation you
+want.
@item
@ruser{Interfaces for programmers}:
@end itemize
-
The NR also contains appendices with useful reference charts.
@itemize
+
@item
@ruser{Literature list}:
contains a set of useful reference books for those who wish to
know more on notation and engraving.
-@item
-@ruser{Scheme tutorial}:
-presents a short introduction to Scheme, the programming
-language that music functions use.
-
@item
@ruser{Notation manual tables}:
are a set of tables showing the chord names, MIDI instruments, a
list of color names, and the Feta font.
-@item
-@ruser{Templates}:
-of LilyPond pieces. Just cut and paste a
-template into a file, add notes, and you're done!
-
@item
@ruser{Cheat sheet}:
is a handy reference of the most common LilyPond commands.
@item
@ruser{LilyPond command index}:
-is an index of all LilyPond @code{\commands}.
+an index of all LilyPond @code{\commands}.
@item
@ruser{LilyPond index}:
-is a complete index.
+a complete index.
@end itemize
@item
@rprogram{Install}:
-explains how to install LilyPond (including compilation if desired).
+explains how to install LilyPond (including compilation if
+desired).
@item
@rprogram{Setup}:
-describes how to configure your computer for optimum LilyPond usage,
-such as using special environments for certain text editors.
+describes how to configure your computer for optimum LilyPond
+usage, such as using special environments for certain text
+editors.
@item
@rprogram{Running LilyPond}:
-shows how to run LilyPond and its helper programs. In addition, this
-section explains how to upgrade input files from previous versions of
-LilyPond.
+shows how to run LilyPond and its helper programs. In addition,
+this section explains how to upgrade input files from previous
+versions of LilyPond.
@item
@rprogram{LilyPond-book}:
@cindex snippets
@cindex LSR
-The Snippet List shows a selected set of LilyPond snippets from the
+@c FIXME: check on kainhofer.
+@ref{Top,LilyPond Snippet List,,lilypond-snippets}:
+this shows a selected set of LilyPond snippets from the
@uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}
(LSR). It is in the public domain.
The list of snippets for each subsection of the Notation Reference
(NR) are also linked from the @strong{See also} portion.
-@itemize
-@item
-The
-@ifhtml
-@uref{source/input/lsr/lilypond-snippets/index.html,Snippets}
-@end ifhtml
-@ifnothtml
-Snippets
-@end ifnothtml
-are a great collection of short examples which demonstrate tricks, tips,
-and special features of LilyPond. Most of these snippets can also be
-found in the @uref{http://lsr.dsi.unimi.it/,LilyPond Snippet
-Repository}. This website also has a searchable LilyPond manual.
-@end itemize
-
@node About the Internals Reference (IR)
@unnumberedsubsec About the Internals Reference (IR)
+@c zzz
@itemize
@item
projects / lilypond.git / blobdiff