]> git.donarmstrong.com Git - lilypond.git/commitdiff
LM Index Introduction
authorRalph Palmer <palmer.r.violin@gmail.com>
Sat, 30 Aug 2008 08:15:38 +0000 (09:15 +0100)
committerTrevor Daniels <t.daniels@treda.co.uk>
Sat, 30 Aug 2008 08:27:17 +0000 (09:27 +0100)
Documentation/user/introduction.itely

index 7a7db27863079c2ec89be25231ace6939f149efc..0d9d8666c79e60284e454ded753a10f0a1fde5ff 100644 (file)
@@ -39,6 +39,12 @@ LilyPond.
 @node Engraving
 @unnumberedsubsec Engraving
 
+@cindex engraving
+@cindex typography, music
+@cindex music typography
+@cindex plate engraving
+@cindex music engraving
+
 The art of music typography is called @emph{(plate) engraving}.
 The term derives from the traditional process of music printing.
 Just a few decades ago, sheet music was made by cutting and
@@ -188,6 +194,7 @@ music = {
 
 @cindex regular rhythms
 @cindex regular spacing
+@cindex spacing, regular
 
 Each bar in the fragment only uses notes that are played in a
 constant rhythm.  The spacing should reflect that.  Unfortunately,
@@ -201,7 +208,6 @@ of the notes.  The upper two measures are printed with this
 correction, the lower two measures without, forming
 down-stem/@/up-stem clumps of notes.
 
-@cindex typography
 
 Musicians are usually more absorbed with performing than with
 studying the looks of a piece of music, so nitpicking about
@@ -241,6 +247,9 @@ to see and love to play from.
 @node Automated engraving
 @unnumberedsubsec Automated engraving
 
+@cindex engraving, automated
+@cindex automated engraving
+
 How do we go about implementing typography?  If craftsmen need
 over ten years to become true masters, how could we simple hackers
 ever write a program to take over their jobs?
@@ -278,6 +287,8 @@ music notation works.
 
 @end itemize
 
+@cindex Scheme programming language
+
 These problems have been addressed by integrating an interpreter
 for the Scheme programming language and rewriting parts of
 LilyPond in Scheme.  The current formatting architecture is built
@@ -304,6 +315,10 @@ chord has all directions up (right).
 }
 @end lilypond
 
+@cindex score formatting
+@cindex formatting a score
+@cindex formatting rules
+
 @noindent
 The process of formatting a score consists of reading and writing
 the variables of graphical objects.  Some variables have a preset
@@ -383,6 +398,8 @@ changed during the music fragment.
 
 @cindex engraving
 @cindex typography
+@cindex engraver
+@cindex plug-in
 
 The formatting process decides where to place symbols.  However,
 this can only be done once it is decided @emph{what} symbols
@@ -539,6 +556,10 @@ signature, and key signature, we get a complete piece of notation.
 \score { \topVoice }
 @end lilypond
 
+@cindex polyphony
+@cindex engraving multiple voices
+@cindex contexts
+
 This system works well for monophonic music, but what about
 polyphony?  In polyphonic notation, many voices can share a staff.
 
@@ -575,6 +596,9 @@ Internals Reference: @rinternals{Contexts}.
 @node Music representation
 @unnumberedsubsec Music representation
 
+@cindex syntax
+@cindex recursive structures
+
 Ideally, the input format for any high-level formatting system is
 an abstract description of the content.  In this case, that would
 be the music itself.  This poses a formidable problem: how can we
@@ -671,6 +695,9 @@ the source code.
 @node Example applications
 @unnumberedsubsec Example applications
 
+@cindex simple examples
+@cindex examples, simple
+
 We have written LilyPond as an experiment of how to condense the
 art of music engraving into a computer program.  Thanks to all
 that hard work, the program can now be used to perform useful
@@ -788,6 +815,13 @@ makes it easy to mix music and text in documents.
 
 This section explains the different portions of the documentation.
 
+@cindex Learning Manual
+@cindex Music Glossary
+@cindex Notation Reference
+@cindex Application Usage
+@cindex Snippet List
+@cindex Internals Reference
+
 @c leave these lines wrapping around.  It's some texinfo 4.12 thing. -gp
 @c This is actually a limitation of texi2html. -jm
 @menu
@@ -804,6 +838,8 @@ This section explains the different portions of the documentation.
 @node About the Learning Manual
 @unnumberedsubsec About the Learning Manual
 
+@cindex Learning Manual
+
 This book explains how to begin learning LilyPond, as well as
 explaining some key concepts in easy terms.  You should read these
 chapters in a linear fashion.
@@ -863,6 +899,7 @@ all.
 @node About the Music Glossary
 @unnumberedsubsec About the Music Glossary
 
+@cindex Music Glossary
 @cindex idiom
 @cindex jargon
 @cindex terminology
@@ -879,6 +916,11 @@ it is highly advisable to consult the glossary.
 @node About the Notation Reference
 @unnumberedsubsec About the Notation Reference
 
+@cindex Notation Reference
+@cindex appendices
+@cindex reference charts
+@cindex charts, reference
+
 This book explains all the LilyPond commands which produce
 notation.  It assumes that readers are familiar with the concepts
 in the Learning Manual.
@@ -951,6 +993,9 @@ a complete index.
 @node About the Application Usage
 @unnumberedsubsec About the Application Usage
 
+@cindex Application Usage
+@cindex integrating LilyPond with other programs
+
 This book explains how to execute the programs and how to integrate
 LilyPond notation with other programs.
 
@@ -992,6 +1037,8 @@ formats to the @code{.ly} format.
 
 @cindex snippets
 @cindex LSR
+@cindex Snippet List
+@cindex LilyPond Snippet Repository
 
 @rlsrnamed{Top,LilyPond Snippet List}: this shows a
 selected set of LilyPond snippets from the
@@ -1011,6 +1058,8 @@ also linked from the @strong{See also} portion.
 @node About the Internals Reference
 @unnumberedsubsec About the Internals Reference
 
+@cindex Internals Reference
+
 @rinternalsnamed{Top,Internals Reference}: this is a set
 of heavily cross linked HTML pages which document the nitty-gritty
 details of each and every LilyPond class, object, and function.