]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/web/introduction.itexi
Merge branch 'master' into lilypond/translation
[lilypond.git] / Documentation / web / introduction.itexi
index 90e9dc6d28f4f31bc67c540589e09fca872abf86..2f14efa1e1d5a5c55bbc347c3f8479038300cea8 100644 (file)
@@ -3,10 +3,11 @@
     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
 
     When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
+    version that you are working on.  For details, see the Contributors'
+    Guide, node Updating translation committishes..
 @end ignore
 
-@node introduction
+@node Introduction
 @unnumbered Introduction
 
 @divClass{column-center-top}
 
 @imageFloat{flat-design,png,right}
 
-The inspiration for LilyPond came when two musicians became
-annoyed with the bland and boring look of computer-printed
-sheet music.  All musicians prefer reading beautiful music, so why
-couldn't programmers write software to produce better printed
-parts?
+LilyPond came about when two musicians wanted to go beyond the
+soulless look of computer-printed sheet music.  Musicians prefer
+reading beautiful music, so why couldn't programmers write
+software to produce elegant printed parts?
+
+The result is a system which frees musicians from the details of
+layout, allowing them to focus on making music.  LilyPond works
+with them to create publication-quality parts, crafted in the best
+traditions of classical music engraving.
 
-This software just does that: it prints music in the best
-traditions of classical engraving with minimum fuss.  Don't waste
-time on tuning spacing, moving around symbols, or shaping slurs.
-Impress friends and colleagues with sharp sheet music!
 @divEnd
 
+@divClass{link-headings}
+
 @divClass{column-left-top}
-@subheading Why use LilyPond?
+@subheading What LilyPond does
 
 @itemize
 
 @item
-@ref{features}: What can LilyPond do?
+@ref{Features}: What can LilyPond do?
 
 @item
-@ref{examples}: I want to see some music!
+@ref{Examples}: I want to see some music!
 
 @item
-@ref{freedom}: LilyPond is Free Software.
+@ref{Freedom}: LilyPond is Free Software.
 
 @item
-@ref{background}: Our computational aesthetics.
+@ref{Background}: Our computational aesthetics.
 
 @end itemize
 @divEnd
 
 @divClass{column-right-top}
-@subheading Who uses it?
-
+@subheading LilyPond in use
 @itemize
 
 @item
-@ref{productions}: Real-life use of LilyPond.
+@ref{Productions}: Real-life use of LilyPond.
 
 @item
-@ref{testimonials}: What do people say?
+@ref{Reviews}: What do people say?
 
 @end itemize
 @divEnd
 
 @divClass{column-center-bottom}
-@subheading Why not use LilyPond?
-
+@subheading How LilyPond works
 @itemize
 
 @item
-@ref{text input}: You write music as @emph{text}?!
+@ref{Text input}: You write music as @emph{text}?!
 
 @item
-@ref{alternate input}: Other ways of working with LilyPond.
+@ref{Easier editing}: Other ways of working with LilyPond.
 
 @end itemize
 @divEnd
 
+@divEnd
 
+@c TRANSLATORS, translations are not yet compiled in Info format, so
+@c it's not worth translating the right column of the following
+@c menu. -JM
 @divClass{hide}
 @menu
-* features::                    What can LilyPond do?
-* examples::                    I want to see some music!
-* freedom::                     Freedom and the GPL.
-* background::                  Computational aesthetics.
-* productions::                 Real-life use of LilyPond.
-* testimonials::                What do people say about it?
-* text input::                  You write music as text?!
-* alternate input::             Other ways of working with LilyPond.
+* Features::                    What can LilyPond do?
+* Examples::                    I want to see some music!
+* Freedom::                     Freedom and the GPL.
+* Background::                  Computational aesthetics.
+* Productions::                 Real-life use of LilyPond.
+* Reviews::                     What do people say about it?
+* Text input::                  You write music as text?!
+* Easier editing::              Other ways of working with LilyPond.
 @end menu
 @divEnd
 
 
 
-@node features
+@node Features
 @unnumberedsec Features
-
-@help{hoping to delegate this.  Desired: an enthusiastic
-attempt to sway people towards trying lilypond.  The warnings
-about writing music as text come in Crash Course, not here.}
-
-Maybe draw inspiration from
-@uref{http://lilypond.org/web/about/features} and
-@uref{http://lilypond.org/web/switch/tour} and
-@uref{http://lilypond.org/web/switch/advantages}
-
-
-
-@subheading Why switch to LilyPond?
+@divClass{column-center-top}
 
 
+@subheading Elegance
 @subsubheading Excellent classical engraving
 
 @imageFloat{flat-design,png,right}
 
-The point of using LilyPond is to produce elegant sheet music that
-is easy to read.  LilyPond's developer community has spent
-thousands of hours developing powerful music engraving software
-that results in beautifully engraved music.  All of LilyPond's
-style settings, font designs and algorithms have been inspired by
-the finest hand-engraved music.  LilyPond output has the same
-strong, balanced and elegant look as the best-engraved classical
-scores.  This is further explained in our @ref{essay}.
+LilyPond allows musicians to produce elegant sheet music that is
+easy to read.  Its developer community has spent thousands of hours
+developing powerful music engraving software that results in beautifully
+engraved music.  All of LilyPond's style settings, font designs and
+algorithms have been inspired by the finest hand-engraved music.
+LilyPond output has the same strong, balanced and elegant look as the
+best-engraved classical scores.  This is further explained in our
+@ref{Essay}.
+
 
 
-@subsubheading Less fiddling
+@subsubheading Effective layout choices
 
 Spend less time with tweaking the output; LilyPond gets the
 formatting correct right from the start.  It determines spacing by
@@ -130,13 +125,27 @@ layout.  Clashes between lyrics, notes, and chords are resolved
 and slurs and beams are sloped, automatically!
 
 
+@divEnd
+
+@divClass{color2}
+@subheading Ease of use
+
+@imageFloat{lilypond-book,png,right}
+
 @subsubheading Text-based input
 
 LilyPond takes ASCII input, which you can produce in your favorite
-text editor, quickly and comfortably.  No more futzing with the
-mouse.  The input contains all the information, so there is no
-need to remember complex command sequences.  Simply save an input
-for later reference.
+text editor, quickly and comfortably.  The input contains all the
+information, so there is no need to remember complex command sequences:
+simply save a file for later reference.
+
+@subsubheading Mix music and text
+
+Put fragments of music into texts without cutting and pasting
+pictures.  Integrate music into @LaTeX{} or HTML seamlessly, or add
+music to OpenOffice.org with OOoLilyPond.  Plugins are also available
+to allow LilyPond code in various blogs and wikis, making online
+collaboration possible.
 
 
 @subsubheading Accessibility
@@ -149,79 +158,73 @@ who are totally blind can use screen-reading software to write
 LilyPond files -- an impossible task in graphical-based
 score-writing programs.
 
+@subsubheading Extensible design
 
-@subsubheading Mix music and text
+All settings can be changed to suit your personal typographical
+taste.  If that still is not enough, there is always the built-in
+scripting language Scheme, a dialect of the powerful language
+LISP.  Settings, variables and functions are all documented in the
+comprehensive program reference manual.
 
-@imageFloat{lilypond-book,png,right}
+@divEnd
 
-Put fragments of music into texts without cutting and pasting
-pictures. Integrate music into LaTeX or HTML seamlessly, or add
-music to OpenOffice.org with ooolilypond.
+@divClass{color3}
 
+@subheading Environment
 
+@imageFloat{frescobaldi-lilypond-editor-small,png,right}
 
 @subsubheading Free software
 
-LilyPond can be downloaded free of charge! Yep - It's free.  Get
+LilyPond can be downloaded free of charge!  Yep - It's free.  Get
 it from the download page.
 
-It's also free (as in @qq{speech}) software. It comes with source
-code, and permission to change and copy it. So, are you irritated
+It's also free (as in @qq{speech}) software.  It comes with source
+code, and permission to change and copy it.  So, are you irritated
 by a bug, or yearning for a feature? Simply add it yourself, or
 pay someone else to do it.
 
 
-@subsubheading Extensible design
-
-All settings can be changed to suit your personal
-typographical taste. If that still is not enough, there is always
-the built-in scripting language, a dialect of the powerful
-language LISP. Settings, variables and functions are all
-documented in the comprehensive program reference manual.
-
-
 @subsubheading Excellent support
 
-LilyPond runs on all popular platforms: Linux, MacOS X, and
+LilyPond runs on all popular platforms: GNU/Linux, MacOS X, and
 Windows.  LilyPond comes with extensive documentation and hundreds
 of example files.  There is an active user community answering
-questions on the Lilypond user mailing list, while the development
+questions on the lilypond-user mailing list, while the development
 team makes sure that problems are solved quickly.
 
 
+@subsubheading Enhanced editors
+
 
+Several developers, themselves active LilyPond users, have also
+written tools specifically aimed at making the process of editing
+LilyPond files faster and more effective.  For some examples, see
+@ref{Easier editing}.
+
+@divEnd
 @divClass{column-center-bottom}
 @subheading Where now?
 
-Still not convinced?  Look at some neat @ref{examples}.  If you've
+Still not convinced?  Look at some specific @ref{Examples}.  If you've
 already decided to try LilyPond, first read about our
-@ref{text input}.
+@ref{Text input}.
 @divEnd
 
 
 
-@node examples
+@node Examples
 @unnumberedsec Examples
 
-Lilypond is a powerful and flexible tool for engraving tasks of
-all kinds. Please browse our gallery of examples and be inspired!
+LilyPond is a powerful and flexible tool for engraving tasks of
+all kinds.  Please browse our gallery of examples and be inspired!
 
-@ignore
-Here is a passage from Franz Liszt's solo piano transcription
-of the Overture to Wagner's @emph{Tannhäuser}. The spacing
-in this example was all performed by Lilypond's formatting
-algorithms, without tweaks of any kind. It
-handles cross-staff beaming gracefully and puts the system brace
-perfectly around all three staves.
-
-@exampleImage{liszt-wagner}
-@end ignore
 
 @newsItem
 @subsubheading Classical Music
 
 This organ work by J.S. Bach is a fairly typical engraving project
-in Lilypond.
+in LilyPond.
 
 @exampleImage{bach-bwv610}
 @newsEnd
@@ -239,7 +242,7 @@ beams, cross-staff stems, and voice-follow lines.
 @newsItem
 @subsubheading Early Music
 
-Lilypond also supports various types of ancient notation, such
+LilyPond also supports various types of ancient notation, such
 as this passage of Gregorian chant.
 
 @exampleImage{ancient-headword}
@@ -248,9 +251,9 @@ as this passage of Gregorian chant.
 @newsItem
 @subsubheading Modern Music
 
-Contemporary composers find Lilypond well-suited to displaying
-unusual notation. Here is an excerpt from Trevor Baca's
-@emph{Cáry}, for unaccompanied bass flute.
+Contemporary composers find LilyPond well-suited to displaying
+unusual notation.  Here is an excerpt from Trevor Bača's
+@emph{Čáry}, for unaccompanied bass flute.
 
 @exampleImage{cary}
 @newsEnd
@@ -260,7 +263,7 @@ unusual notation. Here is an excerpt from Trevor Baca's
 @subsubheading Efficient, flexible creation of performance materials
 
 Various performance materials can be created from the same source
-code. This is an excerpt of @uref{http://nicolas.sceaux.free.fr/,
+code.  This is an excerpt of @uref{http://nicolas.sceaux.free.fr/,
 Nicolas Sceaux's} engraving of Handel's @emph{Giulio Cesare}, in
 full score, piano-vocal reduction, and a violin part.
 
@@ -275,7 +278,7 @@ full score, piano-vocal reduction, and a violin part.
 @newsItem
 @subsubheading Tablature
 
-Lilypond supports tablature notation, which can be customized to
+LilyPond supports tablature notation, which can be customized to
 suit any instrument that reads from tablature.  The tablature
 staff is generated automatically from notes entered for the 5-line
 staff.
@@ -286,8 +289,10 @@ staff.
 @newsItem
 @subsubheading Schenker Graphs
 
-Standard output can be modified heavily. Here someone has created
-an impressive Schenkerian analysis.
+Standard output can be modified heavily.  Here is an impressive
+Schenkerian analysis, created by Kris Schaffer, for an article
+in @uref{http://www.linuxjournal.com/article/8364 , Linux Journal}.
+The colors have been added for better visibility.
 
 @exampleImage{bach-schenker}
 @newsEnd
@@ -295,11 +300,11 @@ an impressive Schenkerian analysis.
 @newsItem
 @subsubheading Vocal Music
 
-Lilypond is excellent for vocal music of all kinds, from sacred
-hymns to opera. Here is a medieval motet with slightly unusual
-requirements. The tenor voice is written in a different meter
+LilyPond is excellent for vocal music of all kinds, from sacred
+hymns to opera.  Here is a medieval motet with slightly unusual
+requirements.  The tenor voice is written in a different meter
 than the others, but must line up as if it were in the same meter.
-Lilypond handles this most elegantly. Note also the incipits with
+LilyPond handles this most elegantly.  Note also the incipits with
 Vaticana style clefs, the slashed stems indicating plicated notes,
 and the ligature braces above certain groups of notes.
 
@@ -309,7 +314,7 @@ and the ligature braces above certain groups of notes.
 @newsItem
 @subsubheading Educational Applications
 
-Lilypond is perfectly suited for educational purposes as well.
+LilyPond is perfectly suited for educational purposes as well.
 Here is an example of a simple counterpoint exercise.
 
 @exampleImage{theory}
@@ -319,7 +324,7 @@ Here is an example of a simple counterpoint exercise.
 @subsubheading Popular Music
 
 It is simple to create pop lead sheets with melody, lyrics,
-chord names, and fretboards. In this example you see some of the
+chord names, and fretboards.  In this example you see some of the
 predefined fretboard diagrams, but these can be heavily customized
 to suit nearly any situation.
 
@@ -329,7 +334,7 @@ to suit nearly any situation.
 @newsItem
 @subsubheading Large Projects
 
-Lilypond is excellent for large projects like operas or works for
+LilyPond is excellent for large projects like operas or works for
 full symphony orchestra, as well.  In addition, the text-based
 input provides greater accessibility -- this example was
 contributed by Hu Haipeng, a blind composer.
@@ -342,12 +347,12 @@ contributed by Hu Haipeng, a blind composer.
 @subheading Where now?
 
 Still not convinced?  LilyPond is Free software, granting you
-@ref{freedom}.  If you've already decided to try LilyPond, first
-read about our @ref{text input}.
+@ref{Freedom}.  If you've already decided to try LilyPond, first
+read about our @ref{Text input}.
 @divEnd
 
 
-@node freedom
+@node Freedom
 @unnumberedsec Freedom
 
 @divClass{column-center-top}
@@ -436,10 +441,10 @@ benefitted from these projects, some developers want to @qq{give
 back} to the community.
 
 @item
-Work experience: contributing to open-source projects is a great
-way to practice programming, documentation writing, or design.
-This experience has helped some developers gain job offers or
-scholarships.
+Work experience: contributing to open-source projects is a great way to
+practice programming, documentation writing, documentation translation,
+or design.  This experience has helped some developers gain job offers
+or scholarships.
 
 
 @end itemize
@@ -452,12 +457,12 @@ scholarships.
 @subheading Where now?
 
 Still not convinced?  Read our extensive essay about our engraving
-philosophy in @ref{background}.  If you've already decided to try
-LilyPond, first read about our @ref{text input}.
+philosophy in @ref{Background}.  If you've already decided to try
+LilyPond, first read about our @ref{Text input}.
 @divEnd
 
 
-@node background
+@node Background
 @unnumberedsec Background
 
 @divClass{column-center-top}
@@ -468,34 +473,38 @@ the art of creating beauty with a computer.
 
 If you just want a quick introduction to LilyPond, the essay might
 be too much material to read.  If you would like to read it now,
-please progress to @ref{essay}.
+please progress to @ref{Essay}.
 @divEnd
 
 @divClass{column-center-bottom}
 @subheading Where now?
 
 Still not convinced?  Read about some of our users'
-@ref{productions} and sheet music.  If you've already decided to
-try LilyPond, first read about our @ref{text input}.
+@ref{Productions} and sheet music.  If you've already decided to
+try LilyPond, first read about our @ref{Text input}.
 @divEnd
 
 
-@node productions
+@node Productions
 @unnumberedsec Productions
 
 @divClass{column-left-top}
 @subheading Concerts
 
-Lilypond engravings have been used for performances around the world.
+LilyPond engravings have been used for performances around the world.
 Some highlights:
 
 @divClass{keep-bullets}
 @itemize
 
 @item
-@emph{Affaire Étrangère}, an opera by Valentin Villenave, with
-libretto by Lewis Trondheim, premiered February 1, 2009, by
-@uref{http://www.orchestre-montpellier.com/, L'Opéra Montpellier}.
+@emph{Affaire étrangère}, an opera by
+@uref{http://valentin.villenave.net/,Valentin Villenave}
+to a French libretto by
+@uref{http://en.wikipedia.org/wiki/Lewis_Trondheim, Lewis
+Trondheim}, premiered February 1, 2009 at
+@uref{http://www.orchestre-montpellier.com/, L'Opéra National de
+Montpellier}, France.
 
 @item
 @uref{http://www.mercurybaroque.org/02/02109.aspx, Mercury Baroque}'s
@@ -526,14 +535,21 @@ New York} (engraving by Nicolas Sceaux).
 over 1500 pieces of classical sheet music for free download, and
 the main showcase of LilyPond scores.
 
+@c don't make this "Mutopia" a link, since that looks silly.
+@item
+@uref{http://etudeapp.com, Etude}, @qq{sheet music on steroids} is
+an iPhone app which displays piano music engraved with LilyPond,
+including many pieces from Mutopia.  The app includes a virtual
+piano keyboard showing which keys to press to help beginners learn
+how to read sheet music.
+
 @item
 @uref{http://www.adoromusicpub.com/, Adoro Music Publishing},
 high-quality scores of sacred music, available for immediate
 download or in traditional paper format.
 
 @item
-@uref{http://theshadylanepublishing.com/, The Shady Lane
-Publishing},
+@uref{http://www.shadylane.fr, The Shady Lane Publishing},
 a @qq{micro musical publishing house} whose goal is to promote a
 new form of musical economy closer to the musicians and music
 lovers.
@@ -544,26 +560,176 @@ lovers.
 
 @divEnd
 
+@contactUsAbout{concerts or sheet music}
 
 @divClass{column-center-bottom}
 @subheading Where now?
 
-Still not convinced?  Read some of our users' @ref{testimonials}.
+Still not convinced?  Read some of our users' @ref{Reviews}.
 If you've already decided to try LilyPond, first read about our
-@ref{text input}.
+@ref{Text input}.
+@divEnd
+
+@c TRANSLATORS, so far it's mostly from
+@c http://lilypond.org/web/switch/testimonials
+
+@node Reviews
+@unnumberedsec Reviews
+
+@divClass{column-left-top}
+@subheading Published articles
+
+@divClass{keep-bullets}
+@itemize
+
+@item
+April 2011
+
+@uref{http://www.linux-magazine.com,Linux Magazine} publishes an
+article titled
+@uref{http://www.linux-magazine.com/w3/issue/126/088-090_projects.pdf,
+Projects on the Move}.  It is an introductory article on MuseScore,
+LilyPond and Chordii.  Author Carla Schroder states @qq{LilyPond is
+driven from the command line, but don’t let the lack of a GUI scare
+you away; LilyPond is user-friendly and easy to learn}, and provides
+a hands-on example.
+
+@item
+May 2010
+
+Peter Kirn, on the Create Digital Music website, publishes a
+@uref{http://createdigitalmusic.com/2010/05/14/lilypond-free-beautiful-music-notation-engraving-for-anyone/,LilyPond
+review}.  He takes a balanced view on usage, praises LilyPond's
+high-quality notation and suggests to try it out.
+
+@item
+September 2009
+
+The German LinuxUser magazine wrote an
+@uref{http://www.linux-community.de/Internal/Artikel/Print-Artikel/LinuxUser/2009/10/Digitaler-Notenschluessel,
+article about LilyPond}.
+
+@item
+August 2009
+
+Ann Drinan, on the
+@uref{http://www.polyphonic.org/article.php?id=188, Polyphonic.org}
+website, presents comments by two orchestra librarians who
+talk about using software to maintain their libraries.
+
+@item
+June 2009
+
+In an @uref{http://news.lilynet.net/Free-Music-Now, article}
+published in the French @emph{National Conservatory Parent
+Association}'s yearly magazine, French composer and LilyPond
+contributor Valentin Villenave explains how Free licenses, and
+specifically LilyPond-engraved scores, are instrumental in
+making written music accessible to all.
+
+@item
+February 2008
+
+In @uref{http://www.musicbyandrew.ca/finale-lilypond-1.html,
+articles on his personal site}, Andrew Hawryluk compares Finale
+and LilyPond in general terms, and evaluates engraving
+capabilities of both pieces of software in detail.  The second
+article is an instructive analysis of engraving issues in
+Rachmaninoff's Piano Prelude No. 6, including comparisons with a
+hand-engraved reference edition.
+
+@item
+June 2006
+
+@uref{http://distrowatch.com,DistroWatch} awards LilyPond and
+@uref{http://distrowatch.com/weekly.php?issue=20060605,writes}
+@qq{Ladies and Gentleman, we are pleased to announce that, based
+on readers' requests, the DistroWatch May 2006 donation has been
+awarded to LilyPond (@euro{}190.00) and Lua (US$250.00).}
+
+@item
+December 2005
+
+@uref{http://linuxjournal.com,Linux Journal} publishes an article
+titled @uref{http://www.linuxjournal.com/article/8364, Make
+Stunning Schenker Graphs with GNU LilyPond}.  It is an in-depth
+but hands-on feature article with crisp LilyPond graphics.  Author
+Kris Shaffer remarks @qq{GNU LilyPond generates beautiful graphics
+that make commercial alternatives seem second-rate.}
+
+@item
+August 20, 2005
+
+The Belgian newspaper De Standaard investigates what drives Free
+Software authors in an article titled
+@uref{http://www.standaard.be/Artikel/Detail.aspx?artikelId=G42H5GD6,
+Delen van KENNIS zonder WINSTBEJAG} (Non-profit sharing of
+knowlegde) in its @q{DS2 bijlage}.  LilyPond is used as an example
+and the article is interspersed with quotes from an email
+interview with Jan Nieuwenhuizen.  This marks LilyPond's first
+appearance in mainstream printed press.
+
+@item
+June 2005
+
+A French article on the LilyPond 2.6 release appeared on
+@uref{http://linuxfr.org/2005/06/27/19210.html, linuxfr.org}.
+
+@item
+October 2004
+
+The editors of Computer!Totaal, a Dutch computer magazine,
+@uref{http://lilypond.org/web/images/computer-totaal.jpeg,
+describe LilyPond} in the October 2004 issue as: @qq{Wonderful
+free (open source) software [..] The sheet music produced by
+LilyPond is exceptionally pretty [..] a very powerful system that
+can do almost anything.}
+
+@item
+July, August 2004
+
+Dave Phillips wrote an introductory article for
+@uref{http://linuxjournal.com,Linux Journal}: At
+the sounding edge: LilyPond, parts
+@uref{http://www.linuxjournal.com/article/7657, one} and
+@uref{http://www.linuxjournal.com/article/7719, two}.
+
+@item
+March 2004
+
+Chris Cannam
+@uref{http://www.all-day-breakfast.com/cannam/linux-musician/lilypond.html,interviewed}
+Han-Wen Nienhuys and Jan Nieuwenhuizen on linuxmusician.com
+(original site defunct).  This interview was also reviewed in a
+@uref{http://slashdot.org/article.pl?sid=04/03/13/2054227&tid=,
+slashdot story}.
+
+@item
+February 2004
+
+Jazz singer Gail Selkirk writes about
+@uref{http://www.songbirdofswing.com/editorial_page/lilypond/,
+Diving into LilyPond}.  @qq{... you can make lead sheets or full
+orchestral parts, and the results can be stunning.}
+@uref{http://www.computermusic.co.uk/, Computer Music Special},
+issue CMS06.
+
+@end itemize
+
+@divEnd
 @divEnd
 
 
-@node testimonials
-@unnumberedsec Testimonials
+@divClass{column-right-top}
+@subheading User testimonials
 
 @divClass{testimonial-item}
 @imageFloat{carter-brey,jpg, right}
 @subsubheading @uref{http://nyphil.org/meet/orchestra/index.cfm?page=profile&personNum=7, Carter Brey}, Principal Cellist, New York Philharmonic
 
-@qq{... I've written a couple of encore pieces for solo cello
+@qq{@dots{} I've written a couple of encore pieces for solo cello
 which I've printed with LilyPond and which I'm going to submit to
-Schirmer for publication. I'll bet their engraved version wouldn't
+Schirmer for publication.  I'll bet their engraved version wouldn't
 look half as sharp as mine!}
 @divEnd
 
@@ -573,10 +739,11 @@ look half as sharp as mine!}
 @subsubheading @uref{http://icem-www.folkwang-hochschule.de/~finnendahl/, Orm Finnendahl}, professor of Composition, Musikhochschule Freiburg
 
 @qq{Although I don't know [LilyPond] very well yet, I'm
-@strong{*very} impressed. I used the program to input a motet of
+@strong{*very} impressed.  I used the program to input a motet of
 Josquin Desprez in mensural notation and there's no doubt that
 lilypond outscores all other notation programs easily concerning
-speed, ease of use and look!} @divEnd
+speed, ease of use and look!}
+@divEnd
 
 
 @divClass{testimonial-item}
@@ -584,11 +751,10 @@ speed, ease of use and look!} @divEnd
 @subsubheading Darius Blasband, composer (Brussels, Belgium)
 
 @qq{[..after the first orchestra rehearsal] I got numerous
-compliments about the quality of the scores. Even more
-importantly, while Lilypond provides numerous hacks to improve the
+compliments about the quality of the scores.  Even more
+importantly, while LilyPond provides numerous hacks to improve the
 way its scores look, what the orchestra got from me is basically
 the raw, untouched output.}
-
 @divEnd
 
 
@@ -596,10 +762,10 @@ the raw, untouched output.}
 @subsubheading Kieren MacMillan, composer (Toronto, Canada)
 
 @qq{thanks and kudos to the development team for their incredible
-work. I've never seen anything approaching the output that I get
-from Lilypond -- I'm totally confident that my music publishing
+work.  I've never seen anything approaching the output that I get
+from LilyPond -- I'm totally confident that my music publishing
 needs will be fulfilled beyond my expectations using this great
-application. [..] basically untweaked Lilypond output [..] looks
+application.  [..] basically untweaked LilyPond output [..] looks
 better than most recent @q{professional} publications I've compared
 it to (q.v., just about any Warner Bros. score, and even many of
 the most recent by @q{the old houses}). [..]}
@@ -609,9 +775,9 @@ the most recent by @q{the old houses}). [..]}
 
 
 @divClass{testimonial-item}
-@subsubheading Chris Cannam, lead programmer of the @uref{http://www.rosegardenmusic.com/, RoseGarden} project.
+@subsubheading Chris Cannam, lead programmer of the @uref{http://www.rosegardenmusic.com/, RoseGarden} project
 
-@qq{Lilypond is obviously the zillion-ton gorilla [of great music
+@qq{LilyPond is obviously the zillion-ton gorilla [of great music
 typesetting].}
 @divEnd
 
@@ -627,21 +793,21 @@ would be confusing to read.  LilyPond makes it much easier for me
 to work in my dual editor+engraver role.}
 
 @qq{I've been using LilyPond exclusively for my fledgling music
-publishing business. Virtually without exception, every composer
+publishing business.  Virtually without exception, every composer
 has been blown away by the quality of the engraving when presented
-with the proofs of their music about to be published. I deserve
+with the proofs of their music about to be published.  I deserve
 some of the credit for this -- I spend a lot of time tweaking
 output, especially ties (mainly in chords) -- but LilyPond gives
 me an excellent starting point, a very intuitive interface, and
 the ability to modify absolutely anything if I want to take the
-time. I'm convinced that no commercial product can come close.}
+time.  I'm convinced that no commercial product can come close.}
 @divEnd
 
 
 @divClass{testimonial-item}
 @subsubheading David Bobroff, Bass Trombone, Iceland Symphony Orchestra
 
-@qq{I think Lilypond is great [..] The more I learn about LilyPond
+@qq{I think LilyPond is great [..] The more I learn about LilyPond
 the more I like it!}
 @divEnd
 
@@ -660,45 +826,67 @@ the more I like it!}
 @divClass{testimonial-item}
 @subsubheading @uref{http://nicolas.sceaux.free.fr/, Nicolas Sceaux}, @uref{http://www.mutopiaproject.org/, Mutopia} contributor
 
-@qq{I had a kind of hate-passion relationship with it. Passion
+@qq{I had a kind of hate-passion relationship with it.  Passion
 because the first score I saw was so amazing! The description of
 LilyPond lies about its beautifulness, it is too modest! [..] as
 LilyPond is getting always better, and as I look closer how things
-are done in scheme, I have less and less frustrations. Anyway,
+are done in scheme, I have less and less frustrations.  Anyway,
 what I mean is: thank you for providing LilyPond, it is really
 good.}
 @divEnd
 
 
 @divClass{testimonial-item}
-@subsubheading @uref{http://www.troff.org/whoswho.html#werner, Werner Lemberg}, Conductor at the Theatre in Koblenz, Germany and distinguished GNU Hacker.
+@subsubheading @uref{http://www.troff.org/whoswho.html#werner, Werner Lemberg}, Conductor at the Theatre in Koblenz, Germany and distinguished GNU Hacker
 
 @qq{Anyway, LilyPond does an amazingly good job!}
 @divEnd
 
 
 @divClass{testimonial-item}
-@subsubheading Paul Davis, developer of @uref{http://jackaudio.org/, JACK} and @uref{http://www.ardour.org/, Ardour}.
+@subsubheading Paul Davis, developer of @uref{http://jackaudio.org/, JACK} and @uref{http://www.ardour.org/, Ardour}
 
 @qq{I think [LilyPond is] an incredible program, and it produces
-wonderful, wonderful output. when i read an interview about it
+wonderful, wonderful output.  when i read an interview about it
 last year, i was raving to several friends of mine about its
 potential.}
 @divEnd
 
 
+@divClass{testimonial-item}
+@subsubheading @uref{http://webusers.siba.fi/~mkuuskan/, Dr. Mika Kuuskankare}, researcher at the @uref{http://siba.fi, Sibelius Academy Finland}, composer and author of Expressive Notation Package (ENP)
+
+@qq{I have the deepest respect towards LilyPond and towards its creators
+and maintainers as I know from personal experience how difficult this
+kind of software can be.}
+@divEnd
+
+
+@divClass{testimonial-item}
+@subsubheading @uref{http://camerondh.blogspot.com, David Cameron}, Musician, professional typesetter and long time SCORE user
+
+@qq{My heartfelt thanks to everyone who contributes to this project.  I
+was a power SCORE user for big typesetting houses way back in the '90s,
+but I feel LilyPond finally makes it possible for me to get exactly what
+I want on the page, especially when it isn't "standard" practice.}
+@divEnd
+
+@divEnd
+
+@contactUsAbout{news articles or testimonals}
+
 @divClass{column-center-bottom}
 @subheading Where now?
 
-Read about our @ref{text input}.
+Read about our @ref{Text input}.
 @divEnd
 
 
 
-@node text input
+@node Text input
 @unnumberedsec Text input
 
-@c TRANSLATORS: so far it's mostly from
+@c TRANSLATORS, so far it's mostly from
 @c http://lilypond.org/web/switch/howto
 
 @subheading @qq{Compiling} Music
@@ -706,7 +894,7 @@ Read about our @ref{text input}.
 @imageClickable{nereid-shot-small,png, (click to enlarge), nereid-shot,png, right}
 
 LilyPond is a @emph{compiled} system: it is run on a text file
-containing the notes.  The resulting output is viewed on-screen or
+describing the music.  The resulting output is viewed on-screen or
 printed.  In some ways, LilyPond is more similar to a programming
 language than graphical score editing software.
 
@@ -732,8 +920,8 @@ entered with backslashes.
 @imageFloat{text-input-1-annotate,png,center}
 @imageFloat{text-input-1-output,png,center}
 
-Alterations are made with different names: add @code{-is} for
-sharp, and @code{-es} for flat (these are Dutch note names, other
+Alterations are made with different names: add @w{@code{-is}} for
+sharp, and @w{@code{-es}} for flat (these are Dutch note names, other
 languages are available).  LilyPond figures out where to put
 accidentals.
 
@@ -752,16 +940,17 @@ Put chords and lyrics together to get a lead sheet:
 
 @subsubheading Orchestral parts
 
-The input file contains the notes of piece.  Score and parts can
-be made from a single input file.  So, changing a note always
-affects both parts and score.  To share the notes, the music is
-assigned to a variable:
+The input file contains the notes of piece of music.  Score and
+parts can be made from a single input file, so that changing a
+note always affects the score and parts.  To be able to include
+the same music in multiple places, the music is assigned to a
+@qq{variable} (a name).
 
 @imageFloat{text-input-parts-both-annotate,png,center}
 
 
 This variable is then used in a single part (here transposed, with
-condensed multi rests):
+condensed rests spanning several measures):
 
 @imageFloat{text-input-parts-single-annotate,png,center}
 @imageFloat{text-input-parts-single-output,png,center}
@@ -778,17 +967,22 @@ pitch):
 
 We realize that many users find this way of entering music a bit
 odd.  For this reason, we have written extensive documentation to
-help new users, beginning with @ref{learning}.
+help new users, beginning with @ref{Learning}.  The Learning
+Manual is the best place to start, as many questions are answered
+before they come up!
 
 Please read the Learning Manual before complaining about bugs!
 New users occasionally believe that LilyPond is not working
 correctly, when in fact it is working precisely as designed.
 
-@help{any suggestions for a picture here?}
+More in-depth information is available in @ref{Manuals}.
 
 
 @subsubheading Easier editing environments
 
+@imageClickable{lilykde-screenshot-small,png,
+  (click to enlarge),lilykde-screenshot,png,right}
+
 LilyPond is primarily concerned with producing top-quality
 engraved sheet music; creating a Graphical User Interface (GUI)
 would distract us from this goal.  However, there are other
@@ -797,221 +991,253 @@ projects aimed at making it easier to create LilyPond input files.
 Some editing environments include syntax highlighting, automatic
 command completion, and pre-made templates.  Other programs
 actually provide a GUI which allows direct manipulation of a
-graphical score.  For more information, see our documentation
-about @ref{alternate input}.
+graphical score.  For more information, see @ref{Easier editing}.
+
 
 
 @divClass{column-center-bottom}
 @subheading Where now?
 
-You are now ready to @ref{download, Download LilyPond}.  Still not
-convinced?  Read about easier editing environments in
-@ref{alternate input}.
+You are now ready to @ref{Download, Download LilyPond}.  Still not
+convinced?  Read about @ref{Easier editing}.
 
 @divEnd
 
 
-@node alternate input
-@unnumberedsec Alternate input
+@node Easier editing
+@unnumberedsec Easier editing
+
 
 @divClass{column-center-top}
-@subheading Graphical environment: Denemo
+@subheading LilyPondTool
 
-@imageClickable{screenshot-denemo-small,png,
-  (click to enlarge),screenshot-denemo,png,right}
+@imageClickable{lilypondtool-2.12-screenshot-400wide,png,
+  (click to enlarge),lilypondtool-2.12-screenshot,png,right}
 
 @sourceimage{logo-linux,,,}
+@sourceimage{logo-freebsd,,,}
+@sourceimage{logo-macosx,,,}
 @sourceimage{logo-windows,,,}
 
-@uref{http://denemo.org}
+@uref{http://lilypondtool.organum.hu}
 
-Denemo is graphical editor which generates LilyPond source code
-and also allows audio playback.  It is currently in development
-and generates code for older versions of LilyPond (V2.8.7).  It
-allows users to view the LilyPond source code in parallel to the
-graphical view.
+Created as a plugin for the
+@uref{http://www.jedit.org,jEdit} text editor,
+LilyPondTool is one of the most feature-rich text-based tools for
+editing LilyPond scores.  Its features include a Document Wizard
+with lyrics support to set up documents easier, and embedded PDF
+viewer with advanced point-and-click support.
 
-@ignore
-Import: LilyPond, MIDI
+@divEnd
 
-Export: Lilypond, MIDI, ABC, CSound Score File, PDF
-@end ignore
+@divClass{column-center-top}
+@subheading Frescobaldi
+
+@imageClickable{frescobaldi-lilypond-editor-small,png,
+  (click to enlarge),frescobaldi-lilypond-editor,png,right}
+
+@sourceimage{logo-linux,,,}
+@sourceimage{logo-freebsd,,,}
+
+@uref{http://www.frescobaldi.org}
+
+Frescobaldi is a dedicated LilyPond music and text editor with a
+built-in PDF previewer, a powerful score wizard and many editing
+features.  It is built on top of the KDE4 libraries and runs
+currently on all flavours of Linux and other UNIX-like operating
+systems.
 
 @divEnd
 
 @divClass{column-center-top}
-@subheading Mixed environment: LilyPondTool
+@subheading Denemo
 
-@imageClickable{lilypondtool-2.12-screenshot-400wide,png,
-  (click to enlarge),lilypondtool-2.12-screenshot,png,right}
+@imageClickable{screenshot-denemo-small,png,
+  (click to enlarge),screenshot-denemo,png,right}
 
 @sourceimage{logo-linux,,,}
-@sourceimage{logo-freebsd,,,}
-@sourceimage{logo-macosx,,,}
 @sourceimage{logo-windows,,,}
 
-@uref{http://lilypondtool@/.organum@/.hu}
+@uref{http://denemo.org}
 
-Created as a plugin for the
-@uref{http://@/www@/.jedit@/.org@/,jEdit} text editor,
-LilyPondTool is one of the most feature-rich text-based tool for
-editing LilyPond scores.  Its features include a Document Wizard
-with lyrics support to set up documents easier, and embedded PDF
-viewer with advanced point-and-click support.
+Denemo is a graphical editor which generates LilyPond source code,
+and also allows audio playback.  It allows users to view the
+LilyPond source code in parallel to the graphical view.  Extra
+LilyPond tweaks can be attached to notes, chords etc. and are stored
+with the Denemo file, so that users can continue to edit graphically.
+
+Moving the cursor in the LilyPond text moves the cursor in the graphical
+view, and any syntax errors in your LilyPond tweaks are highlighted in
+the text view when printed from there.
 
 @divEnd
 
 @divClass{column-center-top}
-@subheading Text environment: Emacs and Vim
+@subheading Text editors
 
 @sourceimage{logo-linux,,,}
 @sourceimage{logo-freebsd,,,}
 @sourceimage{logo-macosx,,,}
 @sourceimage{logo-windows,,,}
 
-@uref{http://FIXME}
+@uref{http://www.gnu.org/software/emacs/}
 
 Emacs is a text editor with language-sensitive capabilities for
 many different computer languages.  Emacs is a highly extensible
 editor and can be used as an Integrated Development Environment.
 There is a @q{lilypond mode} which supplies the language
-definitions for working with Lilypond source files.
+definitions for working with LilyPond source files.  As well, one of
+our developers has written
+@uref{http://nicolas.sceaux.free.fr/lilypond/lyqi.html,lyqi}, an
+Emacs major mode.
+
+@uref{http://www.vim.org}
 
 Vim is a minimal text editor and is an extension of the older Unix
 @command{vi} editor.  It is also extensible and configurable.
 
-As a general rule, if you are not already familiar with emacs or
-vim, then you would probably prefer to use a different editor for
+As a general rule, if you are not already familiar with Emacs or
+Vim, then you would probably prefer to use a different editor for
 writing LilyPond input files.
 
-@divEnd
-
-@divClass{column-center-top}
-@subheading Other
-
-@help insert text and a graphic(s)
+More information on setting up Emacs and Vim can be found in
+@rprogram{Text editor support}.
 
-@subsubheading Mixed environment: Frescobaldi
+@sourceimage{logo-macosx,,,}
+@uref{http://www.uoregon.edu/~koch/texshop}
 
-@imageClickable{frescobaldi-lilypond-editor-small,png,
-  (click to enlarge),frescobaldi-lilypond-editor,png,right}
+The TexShop editor for MacOS@tie{}X can be extended to run LilyPond,
+@command{lilypond-book} and @command{convert-ly} from within the editor,
+using the extensions available at:
 
-@sourceimage{logo-linux,,,}
-@sourceimage{logo-freebsd,,,}
+@example
+@uref{http://users.dimi.uniud.it/~nicola.vitacolonna/home/content/lilypond-scripts}
+@end example
 
-@uref{http://www.frescobaldi.org}
+@sourceimage{logo-macosx,,,}
+There is a LilyPond bundle for TextMate, a commercial editor for MacOS.
+It may be installed by running:
 
-Frescobaldi is a dedicated LilyPond music and text editor with
-built-in PDF previewer, a powerful score wizard and many editing
-features.  It is built on top of the KDE4 libraries and runs
-currently on all flavours of Linux and other UNIX-like operating
-systems.
+@example
+mkdir -p /Library/Application\ Support/TextMate/Bundles
+cd /Library/Application\ Support/TextMate/Bundles
+git clone http://github.com/textmate/lilypond.tmbundle.git
 
+@end example
 
-@subsubheading Text environment: TexShop
+@divEnd
 
-@sourceimage{logo-macosx,,,}
+@divClass{column-center-top}
+@subheading Programs that can export LilyPond code
 
-@uref{http://@/www@/.uoregon@/.edu/~koch/texshop}
 
-The
-@uref{http://@/www@/.uoregon@/.edu/~koch/texshop/index@/.html,TexShop}
-editor for MacOS@tie{}X can be extended to run LilyPond,
-@command{lilypond-book} and @command{convert-ly} from within the editor,
-using the extensions available at
-@uref{http://@/www@/.dimi@/.uniud@/.it/vitacolo/freesoftware@/.html#desktoppub}.
+@subsubheading Score, tab and MIDI editors:
 
+@itemize
+@item
+@uref{http://www.rosegardenmusic.com,Rosegarden}, an audio and
+MIDI sequencer, which also has a score editor for single-staff
+editing.
 
-@ignore
-TODO: ask somebody to sponsor/check these.  -gp
+@item
+@uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml,NtEd},
+a score editor based on the
+@uref{http://www.cairographics.org,Cairo} library, has
+experimental support for exporting to LilyPond.
 
-@subsubheading TextMate
+@item
+@uref{http://www.tuxguitar.com.ar/,TuxGuitar}, a multitrack
+tablature editor and player, includes a score viewer and can
+export to LilyPond.
 
-@sourceimage{logo-macosx,,,}
+@item
+@uref{http://www.musescore.org,MuseScore}, a score editor, has
+incomplete LilyPond export but is being actively developed.
 
-There is a LilyPond bundle for TextMate.  It may be installed by
-running:
+@item
+@uref{http://www.canorus.org,Canorus}, a score editor, can also
+export to LilyPond, but is still beta-software.  Testers are
+welcome, though.
 
-@example
-mkdir -p /Library/Application\ Support/TextMate/Bundles
-cd /Library/Application\ Support/TextMate/Bundles
-svn co http://macromates.com/svn/Bundles/trunk/Bundles/Lilypond.tmbundle/
-@end example
-@end ignore
+@item
+@uref{http://www.volny.cz/smilauer/rumor/rumor.html,Rumor}, a
+realtime monophonic MIDI to LilyPond converter.
 
-@subsubheading Mixed environment: LilyKDE
+@item
+@uref{http://www.holmessoft.co.uk/homepage/software/NWC2LY/index.htm,
+NW2LY} is a C# program which converts a
+@uref{http://www.noteworthysoftware.com/, NoteWorthy} song into
+LilyPond.
 
-@imageClickable{lilykde-screenshot-small,png,
-  (click to enlarge),lilykde-screenshot,png,right}
+@end itemize
 
-@sourceimage{logo-linux,,,}
-@sourceimage{logo-freebsd,,,}
+@subsubheading Algorithmic code generators
 
-@uref{http://lilykde.googlecode.com/}
+@itemize
 
-@uref{http://lilykde.googlecode.com/,LilyKDE} is a plugin for
-KDE's text editor @uref{http://kate-editor.org/,Kate}.  It has a
-powerful Score Wizard to quickly setup a LilyPond document and an
-embedded PDF viewer.
+@item
+@uref{http://www.projectabjad.org/,Abjad}, a
+@uref{http://www.python.org/,Python} API for Formalized Score
+Control designed to help composers build up complex pieces of
+LilyPond notation in an iterative and incremental way.
 
-LilyKDE can use @uref{http://www.volny.cz/smilauer/rumor/,Rumor},
-so music can entered by playing on a MIDI keyboard.
+@item
+@uref{http://common-lisp.net/project/fomus/,FOMUS}, a LISP library
+to generate music notation from computer music software
+environments.
 
-Other features are lyric hyphenation and running LilyPond on
-multiple files at once from within the KDE file manager.
+@item
+@uref{http://strasheela.sourceforge.net,Strasheela}, an
+environment built on top of the
+@uref{http://www.mozart-oz.org/, Mozart/Oz} constraint programming
+language.
 
+@end itemize
+@divEnd
 
-@help clean up this list, check links, etc.
+@divClass{column-center-top}
 
-Other programs can export LilyPond code:
+@subheading Other programs not being actively developed
 
 @itemize
+
 @item
-@uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, a realtime
-monophonic MIDI to LilyPond converter.
-@item
-@uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, an
-Emacs major mode.
-@item
-@uref{http://@/www@/.nongnu@/.org/@/xml2ly/,xml2ly}, which imports
-@uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}
-@item
-@uref{http://@/common-lisp@/.net/project/fomus/,FOMUS},
-a LISP library to generate music notation
-@item
-@uref{http://@/noteedit@/.berlios@/.de,NoteEdit}
-which imports @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}
-@item
-@uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden},
-which imports MIDI
-@item
-@uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml,NtEd},
-has experimental export for LilyPond.
-@item
-@uref{http://www.tuxguitar.com.ar/,TuxGuitar}, can export to LilyPond.
+@uref{http://lilykde.googlecode.com/,LilyKDE} has been replaced by
+@uref{http://www.frescobaldi.org/,Frescobaldi}, and exists as
+LilyKDE3 for KDE 3.5 and lilypond-KDE4 for KDE 4.1 only.
+
 @item
-@uref{http://musescore.org,MuseScore} can export to LilyPond.
+@uref{http://noteedit.berlios.de,NoteEdit}, which imported
+@uref{http://www.musicxml.com/xml.html,MusicXML}, has been forked
+into
+@uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml,NtEd}
+and @uref{http://canorus.org,Canorus}.
+
+
 @item
-@uref{http://canorus.org,Canorus} can also export to LilyPond, but is still
-beta-software. Testers welcome though.
+@uref{http://lilycomp.sourceforge.net, LilyComp} is a graphical
+note entry program, acting much like a number-pad which produces
+lilypond notes.
+
 @end itemize
+
 @divEnd
 
 
 @divClass{column-center-bottom}
 @subheading Where now?
 
-You are now ready to @ref{download, Download LilyPond}.
+You are now ready to @ref{Download, Download LilyPond}.
 
 Still not convinced?  Many composers, musicians, and conductors
 have learned how to write music in our input format.  Experienced
 users even report that they can enter a full score in LilyPond
 faster than with a piano keyboard or mouse+GUI!  Perhaps you would
-like to review the @ref{features}, @ref{examples}, or the
-@ref{freedom} that LilyPond provides, or read about users'
-@ref{productions} and @ref{testimonials}.  In addition, our
+like to review the @ref{Features}, @ref{Examples}, or the
+@ref{Freedom} that LilyPond provides, or read about users'
+@ref{Productions} and @ref{Reviews}.  In addition, our
 approach to the computational aesthetics of classical engraving is
-explained in our @ref{background}.
+explained in our @ref{Background}.
 
 
 @subheading Legalese
@@ -1031,7 +1257,3 @@ acknowledged.
 @divEnd
 
 @divEnd
-
-
-
-