]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/web/introduction.itexi
Web: Updates to the 'Easier Editing' page
[lilypond.git] / Documentation / web / introduction.itexi
index 43f4e4fc3c3bc79f4d372f23b2d024e019ad5b42..ad48484cfb37d77e1e6c788cb93d4e19793d7112 100644 (file)
@@ -20,10 +20,14 @@ 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.
+The result is a program that creates beautiful sheet music
+following the best traditions of classical music engraving.
+It takes care of the details of layout programmatically,
+allowing composers, transcribers and publishers to focus
+on the @emph{music} instead of improving their software's
+default output.  Performers will get parts that let them
+concentrate on @emph{playing} music instead of @emph{reading} it.
+
 
 @divEnd
 
@@ -100,8 +104,7 @@ traditions of classical music engraving.
 @divClass{column-center-top}
 
 
-@subheading Elegance
-@subsubheading Excellent classical engraving
+@subheading Excellent classical engraving
 
 @imageFloat{flat-design,png,right}
 
@@ -115,37 +118,70 @@ best-engraved classical scores.  This is further explained in our
 @ref{Essay}.
 
 
+@divEnd
 
-@subsubheading Effective layout choices
+@divClass{column-center-top}
+@subheading Text input
 
-Spend less time with tweaking the output; LilyPond gets the
-formatting correct right from the start.  It determines spacing by
-itself, and breaks lines and pages to provide a tight and uniform
-layout.  Clashes between lyrics, notes, and chords are resolved
-and slurs and beams are sloped, automatically!
+@subsubheading Everything is explicit
+
+LilyPond processes text input, which contains all information
+about the @emph{content} of your score and can easily be read
+by any human or another program. There are no obscure
+settings hidden behind menu items and binary file storage.
+
+Read more about this concept on @ref{Text input}.
+
+
+@subsubheading Tweaks are robust and traceable
 
+If you have to change anything in the layout this tweak will
+also be explicitly visible in the input file in human-readable
+form, so you will always be able to retrace what you've done.
+If you should accidentally break anything you can easily revert
+or modify any decision without being at the mercy of an
+@emph{Undo} function.
+
+
+@subsubheading Text files are failure- and future-proof
+
+Text files are very robust against file corruption. And as they are
+human-readable, you will always be able to interpret them even if
+you don't have access to the programs that created them.
+
+
+@subsubheading Manage your scores with version control
+
+Text files are applicable to be managed by version control. Go
+for it and experience infinite and selective undo/redo mechanisms
+and the full development history of your scores. Version control
+may also open up new (collaborative) workflows for you.
 
 @divEnd
 
-@divClass{color2}
-@subheading Ease of use
+@divClass{column-center-top}
+@subheading Usability
 
 @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.  The input contains all the
-information, so there is no need to remember complex command sequences:
-simply save a file for later reference.
+@subsubheading Effective layout choices
+
+Spend less time with tweaking the output; LilyPond gets the
+formatting correct right from the start.  It determines spacing by
+itself, and breaks lines and pages to provide a tight and uniform
+layout.  Clashes between lyrics, notes, and chords are resolved
+and slurs and beams are sloped, automatically!
+
 
 @subsubheading Mix music and text
 
 Put fragments of music into texts without cutting and pasting
-pictures.  Integrate music into @LaTeX{} and HTML seamlessly, or add
-music to OpenOffice.org or LibreOffice with OOoLilyPond.  Plugins are
-also available to allow LilyPond code in various blogs and wikis, making
-online collaboration possible.
+pictures.  Integrate music into @LaTeX{} or HTML seamlessly, or add
+music to OpenOffice.org and LibreOffice with
+@uref{http://extensions.services.openoffice.org/en/project/OOoLilyPond,OOoLilypond}.
+Plugins are also available to allow LilyPond code in various blogs and
+wikis, making online collaboration possible.
 
 
 @subsubheading Accessibility
@@ -157,32 +193,74 @@ speech-recognition software to edit LilyPond files.  Even users
 who are totally blind can use screen-reading software to write
 LilyPond files -- an impossible task in graphical-based
 score-writing programs.
+You can see a spectacular score on @ref{Examples}.
+
+@subsubheading Editor diversity
+
+Several developers, themselves active LilyPond users,
+have written tools specifically aimed at making the process of editing
+LilyPond files faster and more effective; you are not tied to
+a single user interface but can use different tools for different tasks.
+You can even use a full-fledged LilyPond editor at home and use your
+mobile phone's notepad app to edit the files on the go. For some examples,
+see @ref{Easier editing}.
+@c TODO: Change this when the new pages have been written and pushed
 
-@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 Scheme, a dialect of the powerful language
-LISP.  Settings, variables and functions are all documented in the
+@divEnd
+
+@divClass{column-center-top}
+
+@subheading Extensible design
+
+@subsubheading Easy management of style sheets
+
+All layout settings can be changed to suit your personal typographical
+taste. So you can easily write style sheets that change every aspect of
+LilyPond scores' default appearance. As these are also written as text
+and can be stored in separate files you can simply switch between two
+stylesheets to produce scores with a completely different appearance or
+layout.
+You want to print a score on A4 paper and project it with a beamer,
+one system per page? LilyPond's layout engine will effortlessly produce
+both from the same input.
+
+@subsubheading Add your own functions
+
+If that still is not enough, there is always the built-in
+scripting language Scheme, which can access LilyPond's layout
+engine at the same level as LilyPond itself does, making it
+a @emph{very} powerful tool.
+Settings, variables and functions are all documented in the
 comprehensive program reference manual.
 
+@subsubheading Process scores programmatically
+
+LilyPond input files can fully be edited or even generated by programs
+and scripts. This can for example be used for algorithmical composition.
+But you can also access the musical content for analysis, or manage
+input fragments in a database. There are no limitations except your
+imagination.
+
+
+@subsubheading Create new tools using LilyPond
+
+As LilyPond isn't a monolithic GUI program but a command line tool it
+can be used from within other applications too. This way it is possible
+to equip tools like e.g. web applications with LilyPond's engraving
+power. There already exist several online tools using LilyPond.
+
+@c (TBD: Add a link to the new @ref{Applications} page.
+
+
 @divEnd
 
-@divClass{color3}
+@divClass{column-center-top}
 
 @subheading Environment
 
 @imageFloat{frescobaldi-lilypond-editor-small,png,right}
 
-@subsubheading Free software
-
-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
-by a bug, or yearning for a feature? Simply add it yourself, or
-pay someone else to do it.
 
 
 @subsubheading Excellent support
@@ -190,17 +268,24 @@ pay someone else to do it.
 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
-team makes sure that problems are solved quickly.
+questions on the lilypond-user mailing list, offering you friendly
+help. The response time is usually very short, and often brillant
+solutions to reported problems are developed. Thanks to the close
+interaction with the development team such solutions are regularly
+included in LilyPond itself.
+Read more in @ref{Community}.
 
 
-@subsubheading Enhanced editors
+@subsubheading Free software
 
+LilyPond can be downloaded free of charge!  Yep - It's free.  Get
+it from the download page.
 
-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}.
+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.
+Read more on @ref{Freedom}.
 
 @divEnd
 @divClass{column-center-bottom}
@@ -216,51 +301,59 @@ already decided to try LilyPond, first read about our
 @node Examples
 @unnumberedsec Examples
 
+@divClass{column-center-top}
+@subheading Beautiful Examples
+
 LilyPond is a powerful and flexible tool for engraving tasks of
 all kinds.  Please browse our gallery of examples and be inspired!
 
+@divEnd
+
 
-@newsItem
-@subsubheading Classical Music
+@divClass{column-center-middle-color2}
+@subheading Classical Music
 
 This organ work by J.S. Bach is a fairly typical engraving project
 in LilyPond.
 
 @exampleImage{bach-bwv610}
-@newsEnd
+@divEnd
 
-@newsItem
-@subsubheading Complex Notation
+
+@divClass{column-center-middle-color2}
+@subheading Complex Notation
 
 This example from @emph{Goyescas} by Enrique Granados shows some
 of the more advanced features of typesetting, including kneed
 beams, cross-staff stems, and voice-follow lines.
 
 @exampleImage{granados}
-@newsEnd
+@divEnd
 
-@newsItem
-@subsubheading Early Music
+
+@divClass{column-center-middle-color2}
+@subheading Early Music
 
 LilyPond also supports various types of ancient notation, such
 as this passage of Gregorian chant.
 
 @exampleImage{ancient-headword}
-@newsEnd
+@divEnd
+
 
-@newsItem
-@subsubheading Modern Music
+@divClass{column-center-middle-color2}
+@subheading Modern Music
 
 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
+@divEnd
 
 
-@newsItem
-@subsubheading Efficient, flexible creation of performance materials
+@divClass{column-center-middle-color2}
+@subheading 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/,
@@ -273,10 +366,11 @@ full score, piano-vocal reduction, and a violin part.
 
 @exampleImage{sesto-violin}
 
-@newsEnd
+@divEnd
+
 
-@newsItem
-@subsubheading Tablature
+@divClass{column-center-middle-color2}
+@subheading Tablature
 
 LilyPond supports tablature notation, which can be customized to
 suit any instrument that reads from tablature.  The tablature
@@ -284,21 +378,11 @@ staff is generated automatically from notes entered for the 5-line
 staff.
 
 @exampleImage{tab-example}
-@newsEnd
-
-@newsItem
-@subsubheading Schenker Graphs
-
-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.
+@divEnd
 
-@exampleImage{bach-schenker}
-@newsEnd
 
-@newsItem
-@subsubheading Vocal Music
+@divClass{column-center-middle-color2}
+@subheading Vocal Music
 
 LilyPond is excellent for vocal music of all kinds, from sacred
 hymns to opera.  Here is a medieval motet with slightly unusual
@@ -309,30 +393,33 @@ Vaticana style clefs, the slashed stems indicating plicated notes,
 and the ligature braces above certain groups of notes.
 
 @exampleImage{aucun-snippet}
-@newsEnd
-
-@newsItem
-@subsubheading Educational Applications
-
-LilyPond is perfectly suited for educational purposes as well.
-Here is an example of a simple counterpoint exercise.
+@divEnd
 
-@exampleImage{theory}
-@newsEnd
 
-@newsItem
-@subsubheading Popular Music
+@divClass{column-center-middle-color2}
+@subheading Lead Sheets
 
-It is simple to create pop lead sheets with melody, lyrics,
+It is simple to create lead sheets with melody, lyrics,
 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.
 
 @exampleImage{chart}
-@newsEnd
+@divEnd
+
 
-@newsItem
-@subsubheading Large Projects
+@divClass{column-center-middle-color2}
+@subheading Educational Applications
+
+LilyPond is perfectly suited for educational purposes as well.
+Here is an example of a simple counterpoint exercise.
+
+@exampleImage{theory}
+@divEnd
+
+
+@divClass{column-center-middle-color2}
+@subheading Large Projects
 
 LilyPond is excellent for large projects like operas or works for
 full symphony orchestra, as well.  In addition, the text-based
@@ -340,7 +427,29 @@ input provides greater accessibility -- this example was
 contributed by Hu Haipeng, a blind composer.
 
 @exampleImage{orchestra}
-@newsEnd
+@divEnd
+
+
+@divClass{column-center-middle-color2}
+@subheading Customized Output
+
+A short excerpt from Stockhausen's Klavierstück II to demonstrate
+LilyPond's ability to provide customised output.
+
+@exampleImage{Stockhausen_Klavierstueck2}
+@divEnd
+
+
+@divClass{column-center-middle-color2}
+@subheading Schenker Graphs
+
+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}
+@divEnd
 
 
 @divClass{column-center-bottom}
@@ -368,7 +477,7 @@ not require hundreds of dollars of software!
 
 
 @c @divClass{column-left-top}
-@divClass{color2}
+@divClass{column-center-middle-color2}
 @divClass{keep-bullets}
 @subheading What are the benefits to users?
 
@@ -409,7 +518,7 @@ available for copying, modifications, and distribution.
 
 
 @c @divClass{column-right-top}
-@divClass{color3}
+@divClass{column-center-middle-color3}
 @divClass{keep-bullets}
 @subheading Why do LilyPond developers @qq{give away} their work for free?
 
@@ -471,9 +580,11 @@ LilyPond, first read about our @ref{Text input}.
 We have an extensive essay describing computational aesthetics:
 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}.
+This is interesting reading if you are interested in an in-depth
+discussion of our fundamental ideas.  Due to its volume the
+essay is available as a "manual".  If you would like to read
+it now, please progress to @ref{Essay}.  However, if you just
+want a quick introduction to LilyPond, you might skip it for now.
 @divEnd
 
 @divClass{column-center-bottom}
@@ -488,6 +599,16 @@ try LilyPond, first read about our @ref{Text input}.
 @node Productions
 @unnumberedsec Productions
 
+@divClass{column-center-top}
+
+@subheading Productions using LilyPond
+
+Here you can read about people who actually use LilyPond
+in their productions, be it for performances of their
+music or as published scores.
+
+@divEnd
+
 @divClass{column-left-top}
 @subheading Concerts
 
@@ -497,18 +618,40 @@ Some highlights:
 @divClass{keep-bullets}
 @itemize
 
+@item
+@uref{http://www.aurelienbello.com/,Aurélien Bello} has arranged a
+version of Richard Strauss's @emph{Der Rosenkavalier} for four singers
+and a chamber orchestra of thirteen players.  This has been commissioned
+by the Berlin Philharmonic Orchestra whose members will be the performers on
+@uref{http://www.festspielhaus.de/veranstaltung/der-kleine-rosenkavalier-02-04-2015-1100/,April 2nd and 6th}
+at the Festspielhaus, Baden-Baden, and on
+@uref{http://www.berliner-philharmoniker.de/konzerte/kalender/details/21070/,April 26th}
+in the @emph{Philharmonie (großer Saal)}, Berlin.  We are pleased to see
+musicians of such reputation playing from LilyPond scores -- and they are
+reportedly very happy with them.
+
+Aurélien has also re-orchestrated @emph{Der Ring des Nibelungen} by Richard
+Wagner to a
+@uref{http://www.rsb-online.de/content/concerts/new-season-1516/family-concerts-age-7-and-above/index_eng.html,100-minute version for children}.
+Written for a standard symphony orchestra, but with a reduced cast of
+singers, it was performed by the
+@uref{http://www.rsb-online.de/,@emph{Radio-Sinfonieorchester Berlin}}
+in April 2014 at the Atze Musiktheater, Berlin.  The Conductor was Heiko
+Matthias Förster.
+
 @item
 Joe Smeets created sheet music for the children's book @emph{Zing Mee}
-(@emph{Sing along}) by Annie M.G. published by Querido -- ISBN
-9789045106205:
-@uref{http://www.queridokinderenjeugdboeken.nl/web/Boek.htm?dbid=18954&typeofpage=134707, www.queridokinderenjeugdboeken.nl}; choir
-rehearsal scores for the Dutch translation of Benjamin Britten's
+(@emph{Sing along}) by Annie M.G. published by
+@uref{http://www.queridokinderenjeugdboeken.nl/, Querido}
+-- ISBN 9789045106205;
+choir rehearsal scores for the Dutch translation of Benjamin Britten's
 @emph{Saint Nicolas} performed by @emph{Muziektheater Hollands Diep} in
-2011.
-@uref{http://www.muziektheaterhollandsdiep.nl/nl/voorstellingen/sint_nicolaas_leeft, www.muziektheaterhollandsdiep.nl}; and is currently
-working on the score and parts for an arrangement of Moussurgsky's
-@emph{Boris Godounov} for wind quartet, piano and percussion.  To be
-performed in 2014, again by @emph{Muziektheater Hollands Diep}.
+2011;
+@uref{http://www.muziektheaterhollandsdiep.nl/nl/voorstellingen/sint_nicolaas_leeft, www.muziektheaterhollandsdiep.nl}.
+He has also worked on the score and parts for an arrangement of
+Moussurgsky’s @emph{Boris Godounov} for wind quartet, piano and
+percussion which was performed in 2014, again by
+@emph{Muziektheater Hollands Diep}.
 
 @item
 A critical edition of Tommaso Traetta's @emph{Enea nel Lazio (1760)},
@@ -523,14 +666,13 @@ Created by
 for his Ph.D. Thesis.
 
 @item
-Mussorgsky's @emph{Pictures at an exhibition}, re-orchestrated and
+Mussorgsky's @emph{Pictures at an exhibition}, was re-orchestrated and
 conducted by @uref{http://www.aurelienbello.com/,Aurélien Bello} with
-the @uref{http://www.junge-philharmonie-brandenburg.de/,
-Junge Philharmonie Brandenburg}
-on Oct 10 2011 and again on Apr 15-16 2012.
+the @uref{https://junge-philharmonie-brandenburg.de/,
+Junge Philharmonie Brandenburg} in October 2011 and April 2012.
 
 @item
-@uref{http://www.kierenmacmillan.info/, Kieren MacMillan}, composer and
+@uref{http://kierenmacmillan.info/, Kieren MacMillan}, composer and
 musical director.  His many, recent works include; @emph{Go Thy Way},
 performed by the @uref{http://www.saltlakechoralartists.org/,
 Salt Lake Choral Artists} in March 2012; The
@@ -538,16 +680,16 @@ Salt Lake Choral Artists} in March 2012; The
 by the
 @uref{http://www.herald-dispatch.com/news/marshall/x1883873762/Music-duo-Chrysalis-to-perform-at-Marshall-University-on-Jan-19,
 Chrysalis Duo} ; @emph{thrafsmata} performed in July 2011 by the
-@uref{http://www.pnme.org/CurrentSeason/PreviousSeasons.html, Pittsburgh
+@uref{http://www.pnme.org/, Pittsburgh
 New Music Ensemble}.
 
 @item
 @emph{Anonymous Student Compliment or Complaint}, by
 @uref{http://www.mikesolomon.org, Mike Solomon}, winner chosen from among
 172 entries from 22 countries of the
-@uref{http://leftcoastensemble.org, 2011 Left Coast Composition Contest}.
+@uref{http://www.leftcoastensemble.org, 2011 Left Coast Composition Contest}.
 Other works include, Norman (age 1) for clarinet solo, performed at the
-@uref{http://emu.music.ufl.edu/fems_concerts.html, University of Florida}'s
+@uref{http://arts.ufl.edu/academics/music/, University of Florida}'s
 Electroacoustic Music Festival (FEMF), October 2010.
 
 @item
@@ -558,7 +700,7 @@ Italy.  @uref{http://www.ascarlatti2010.net, Alessandro Scarlatti 2010},
 in celebration of the composer's 350th birthday.
 
 @item
-@uref{http://www.mercurybaroque.org, Mercury Baroque}'s performance of
+@uref{http://www.mercuryhouston.org/, Mercury Baroque}'s performance of
 Lully's @emph{Armide}, May 15-16, 2009, in Houston, Texas (engraving by
 @uref{http://nicolas.sceaux.free.fr/, Nicolas Sceaux}).
 
@@ -573,7 +715,7 @@ New York} (engraving by
 @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
+@uref{https://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.
@@ -604,12 +746,12 @@ 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},
+@uref{https://twitter.com/adoromusic, Adoro Music Publishing},
 high-quality scores of sacred music, available for immediate
 download or in traditional paper format.
 
 @item
-@uref{http://www.shadylane.fr, The Shady Lane Publishing},
+@uref{http://matthieujacquot.com/, 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.
@@ -636,6 +778,12 @@ If you've already decided to try LilyPond, first read about our
 @node Reviews
 @unnumberedsec Reviews
 
+@divClass{column-center-top}
+@subheading What do people say about LilyPond?
+
+@divEnd
+
+
 @divClass{column-left-top}
 @subheading Published articles
 
@@ -647,7 +795,7 @@ 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,
+@uref{http://www.linux-magazine.com/content/download/61706/482546/version/1/file/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
@@ -680,7 +828,7 @@ talk about using software to maintain their libraries.
 @item
 June 2009
 
-In an @uref{http://news.lilynet.net/Free-Music-Now, article}
+In an @uref{http://web.archive.org/web/20110325004849/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
@@ -842,7 +990,7 @@ typesetting].}
 
 
 @divClass{testimonial-item}
-@subsubheading Chris Snyder, @uref{http://www.adoromusicpub.com/, Adoro Music Publishing}
+@subsubheading Chris Snyder, @uref{https://twitter.com/adoromusic, Adoro Music Publishing}
 
 @qq{The way that music is entered for LilyPond causes me to think in a
 more musical way -- there have been times when I've been stumped as
@@ -948,6 +1096,7 @@ Read about our @ref{Text input}.
 @c TRANSLATORS, so far it's mostly from
 @c http://lilypond.org/web/switch/howto
 
+@divClass{column-center-top}
 @subheading @qq{Compiling} Music
 
 @imageClickable{nereid-shot-small,png, (click to enlarge), nereid-shot,png, right}
@@ -1030,9 +1179,9 @@ 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.
+Occasionally new users are unnecessarily confused by some aspects
+of LilyPond's behaviour.  Please read this manual before doubting
+whether LilyPond is working correctly.
 
 More in-depth information is available in @ref{Manuals}.
 
@@ -1056,7 +1205,7 @@ command completion, and pre-made templates.  Other programs
 actually provide a GUI which allows direct manipulation of a
 graphical score.  For more information, see @ref{Easier editing}.
 
-
+@divEnd
 
 @divClass{column-center-bottom}
 @subheading Where now?
@@ -1080,69 +1229,33 @@ In particular, don't link to:
 @end ignore
 
 @divClass{column-center-top}
-@subheading Tunefl
-
-@sourceimage{logo-linux,,,}
-@sourceimage{logo-freebsd,,,}
-@sourceimage{logo-macosx,,,}
-@sourceimage{logo-windows,,,}
-
-@uref{http://www.tunefl.com}
-
-With tunefl you can typeset your scores directly online
-without needing to install LilyPond locally. It allows
-trying out all the program's features using a convenient
-web interface.
-
-@divEnd
-
-@divClass{column-center-top}
-@subheading LilyPondTool
-
-@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://lilypondtool.organum.hu}
-
-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.
-
-@divEnd
-
-@divClass{column-center-top}
-@subheading Frescobaldi
+@subheading Front-end Applications
+@subsubheading Frescobaldi
 
 @imageClickable{frescobaldi-lilypond-editor-small,png,
   (click to enlarge),frescobaldi-lilypond-editor,png,right}
 
 @sourceimage{logo-linux,,,}
-@sourceimage{logo-freebsd,,,}
+@sourceimage{logo-macosx,,,}
 @sourceimage{logo-windows,,,}
 
 @uref{http://www.frescobaldi.org}
 
-Frescobaldi is lightweight, yet powerful LilyPond music and text editor
-with a built-in PDF viewer.  It is easy to use and will run on all major
+Frescobaldi is a lightweight, yet powerful, music and text editor
+with many features added and enhanced particularly for LilyPond. Major
+features include point-and-click links between the code and music views,
+detailed score wizards, built in LilyPond documentation browser, syntax
+highlighting and automatic completion. Frescobaldi is written in
+Python, with PyQt4 for its user interface, and will run on all major
 operating systems (GNU/Linux, Mac OS X and Windows).
 
-@divEnd
-
-@divClass{column-center-top}
-@subheading Denemo
+@subsubheading Denemo
 
 @imageClickable{screenshot-denemo-small,png,
   (click to enlarge),screenshot-denemo,png,right}
 
 @sourceimage{logo-linux,,,}
+@sourceimage{logo-macosx,,,}
 @sourceimage{logo-windows,,,}
 
 @uref{http://denemo.org}
@@ -1160,46 +1273,72 @@ the text view when printed from there.
 @divEnd
 
 @divClass{column-center-top}
-@subheading Text editors
+@subheading Browser-based editors
+
+@subsubheading LilyBin
+@uref{http://lilybin.com}
+
+A web-based LilyPond editor where you can typeset your scores directly
+online without needing to install LilyPond.
+
+@divEnd
+
+@divClass{column-center-top}
+@subheading IDE Plug-ins
+
+@subsubheading Elysium
 
 @sourceimage{logo-linux,,,}
 @sourceimage{logo-freebsd,,,}
 @sourceimage{logo-macosx,,,}
 @sourceimage{logo-windows,,,}
 
-@uref{http://elysium.thsoft.hu}
+@uref{https://github.com/thSoft/elysium}
 
-Elysium is a LilyPond IDE for Eclipse with an integrated, side-by-side
-view for source and score.  It includes rapid visual & auditive feedback
-without having to switch contexts, and comes with many wizard-driven
-templates.
+A complete environment for editing scores with LilyPond in Eclipse,
+offering a rich toolkit for conveniently managing LilyPond.
 
+@divEnd
+
+@divClass{column-center-top}
+@subheading Text editors
+
+@sourceimage{logo-linux,,,}
+@sourceimage{logo-freebsd,,,}
+@sourceimage{logo-macosx,,,}
+@sourceimage{logo-windows,,,}
+
+@subsubheading Emacs
 @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.  A developer  has written
+@uref{https://github.com/nsceaux/lyqi,lyqi}, an Emacs major mode.
 
-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.  A developer
-has written @uref{https://github.com/nsceaux/lyqi,lyqi}, an Emacs major
-mode.
+If you are not already familiar with Emacs then you may probably prefer
+to use a different editor for writing LilyPond input files.
 
-@uref{http://www.vim.org}
+More information on setting up Emacs can be found in
+@rprogram{Text editor support}.
 
+@subsubheading Vim
+@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
-writing LilyPond input files.
+If you are not already familiar with Vi then you may probably prefer
+to use a different editor for writing LilyPond input files.
 
-More information on setting up Emacs and Vim can be found in
+More information on setting up Vim can be found in
 @rprogram{Text editor support}.
 
 @sourceimage{logo-macosx,,,}
-@uref{http://www.uoregon.edu/~koch/texshop}
+@subsubheading TeXShop
+@uref{http://pages.uoregon.edu/koch/texshop/}
 
-The TexShop editor for MacOS@tie{}X can be extended to run LilyPond,
+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:
 
@@ -1210,8 +1349,7 @@ using the extensions available at:
 @divEnd
 
 @divClass{column-center-top}
-@subheading Programs that can export LilyPond code
-
+@subheading Other programs that can export LilyPond code
 
 @subsubheading Score, tab and MIDI editors:
 
@@ -1229,19 +1367,13 @@ to LilyPond, but is still beta-software. Testers are welcome, though.
 
 @item
 @uref{http://enc2ly.sourceforge.net/en/,Enc2ly} is a GNU/Linux program
-which converts an @uref{http://www.gvox.com/,Encore} music score into
-a LilyPond one.
+which converts an Encore music score into a LilyPond one.
 
 @item
 @uref{https://github.com/hanwen/go-enc2ly,go-enc2ly} is a Go tool that
-converts @uref{http://www.gvox.com/,Encore} files to LilyPond.  It was
-created using Felipe Castro's research and reverse engineering by
-tweaking existing .enc files and loading them using the 4.55 demo
-version.
-
-@item
-@uref{http://www.musescore.org,MuseScore}, a score editor, has
-incomplete LilyPond export but is being actively developed.
+converts Encore files to LilyPond.  It was created using Felipe Castro's
+research and reverse engineering by tweaking existing .enc files and
+loading them using the 4.55 demo version.
 
 @item
 @uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml,NtEd},
@@ -1261,14 +1393,6 @@ mixing different musical works together in a single score or part.
 @uref{http://www.rosegardenmusic.com,Rosegarden}, an audio and MIDI
 sequencer, which also has a score editor for single-staff editing.
 
-@item
-@uref{https://launchpad.net/rumor/,Rumor}, a realtime monophonic
-MIDI-to-LilyPond converter.
-
-@item
-@uref{http://www.tuxguitar.com.ar/,TuxGuitar}, a multitrack tablature
-editor and player, includes a score viewer and can export to LilyPond.
-
 @end itemize
 
 @subsubheading Algorithmic code generators
@@ -1290,35 +1414,64 @@ interpreters.  A C++ port is also available.
 @item
 @uref{http://strasheela.sourceforge.net/strasheela/doc/index.html,Strasheela},
 an environment built on top of the
-@uref{http://www.mozart-oz.org/, Mozart/Oz} constraint programming
-language.
+@uref{http://mozart.github.io/, The Mozart Programming System}.
 
 @end itemize
 @divEnd
 
 @divClass{column-center-top}
 
-@subheading Other programs not being actively developed
+@subheading Other programs no longer being actively developed
 
 @itemize
 
+@item
+@uref{https://sourceforge.net/projects/lily4jedit,LilyPondTool} was
+created as a plugin for the @uref{http://www.jedit.org,jEdit} text
+editor.
+
 @item
 @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://noteedit.berlios.de,NoteEdit}, which imported
-@uref{http://www.makemusic.com/musicxml,MusicXML}, has been forked
-into
+@uref{http://lilycomp.sourceforge.net, LilyComp} is a graphical note
+entry program, acting much like a number-pad which produces LilyPond
+notes.
+
+@item
+@uref{http://www.musescore.org,MuseScore}, a score editor.  LilyPond
+export was dropped in version 2.0 but earlier versions are still
+available for download at
+@uref{http://sourceforge.net/projects/mscore/files/mscore/,Sourceforge}.
+
+@item
+@uref{https://sourceforge.net/projects/noteedit.berlios/,NoteEdit}, which imported
+@uref{http://www.musicxml.com/,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://extensions.services.openoffice.org/en/project/OOoLilyPond,OOoLilypond},
+an OpenOffice.org extension that converts LilyPond files into images
+within OpenOffice.org documents.  Although this is no longer being
+developed, it appears to still work with version 4.
+
+@item
+@uref{https://launchpad.net/rumor/,Rumor}, a realtime monophonic
+MIDI-to-LilyPond converter.
+
+@item
+@uref{https://github.com/tiredpixel/tunefl,tunefl}
+Typeset your mini-scores directly online without needing to install
+LilyPond locally.  It allows trying out all the program's features using
+a convenient web interface.
 
 @item
-@uref{http://lilycomp.sourceforge.net, LilyComp} is a graphical
-note entry program, acting much like a number-pad which produces
-LilyPond notes.
+@uref{http://sourceforge.net/projects/tuxguitar/,TuxGuitar}, a
+multitrack tablature editor and player, includes a score viewer and can
+export to LilyPond.
 
 @end itemize
 
@@ -1340,7 +1493,10 @@ like to review the @ref{Features}, @ref{Examples}, or the
 approach to the computational aesthetics of classical engraving is
 explained in our @ref{Background}.
 
+@divEnd
+
 
+@divClass{column-center-bottom}
 @subheading Legalese
 
 @divClass{legal}