Release: update news.

[lilypond.git] / Documentation / web / download.itexi

diff --git a/Documentation/web/download.itexi b/Documentation/web/download.itexi
index 79985f58d537d86d824d17003e9335bceda9db5f..40a2fe86f4e16ffa5cb2dbfb651dde6e1f3978ca 100644 (file)
--- a/Documentation/web/download.itexi
+++ b/Documentation/web/download.itexi
@@ -3,21 +3,40 @@
     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
 
     When revising a translation, copy the HEAD committish of the
     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
 
 @end ignore
 

-@node download
+@include included/generating-output.itexi
+
+@macro warningTextBased
+@warning{LilyPond is a @strong{text-based} music engraver; it is
+more similar to a programming language than a graphical score
+editing program.  Before downloading LilyPond, please read about
+our @ref{Text input}.}
+@end macro
+
+@node Download

 @unnumbered Download
 
 @divClass{heading-center}
 @unnumbered Download
 
 @divClass{heading-center}

-@heading Downloads for LilyPond @versionStable
+@ifclear web_version
+  @c yes, we want versionDevel here, since the online links
+  @c for @version won't be up yet!
+  @heading Downloads for LilyPond @versionDevel
+
+@warning{Links for the stable version of LilyPond can be found at
+@uref{http://lilypond.org, lilypond.org}}
+@end ifclear
+@ifset web_version
+  @heading Downloads for LilyPond @versionStable
+@end ifset
+
+@warningTextBased

 
 @divEnd
 
 
 @divEnd
 

-@warning{LilyPond is a @strong{text-based} music engraver; it is
-more similar to a programming language than a graphical score
-editing program.  Before downloading LilyPond, please read about
-our @ref{text input}.}
+@divClass{link-headings}

 
 @divClass{column-left-top}
 @subheading For users
 
 @divClass{column-left-top}
 @subheading For users


@@ -25,10 +44,10 @@ our @ref{text input}.}
 @itemize
 
 @item
 @itemize
 
 @item

-@c TODO: duplicate to avoid underlined refs in HTML?  icky.
-@ref{UNIX, @sourceimage{logo-linux,,,}
+@c ref is duplicated to avoid underlining ref as image.
+@ref{Unix, @sourceimage{logo-linux,,,}

 @sourceimage{logo-freebsd,,,}}
 @sourceimage{logo-freebsd,,,}}

-@ref{UNIX, Unix (Linux and FreeBSD)}
+@ref{Unix, Unix (Linux and FreeBSD)}

 
 @item
 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
 
 @item
 @ref{MacOS X, @sourceimage{logo-macosx,,,}}


@@ -48,19 +67,20 @@ our @ref{text input}.}
 @itemize
 
 @item
 @itemize
 
 @item

-@ref{source}:
+@ref{Source}:

 for packagers
 
 @item
 for packagers
 
 @item

-@ref{old downloads}:
+@ref{Old downloads}:

 old versions
 
 old versions
 

-@item @ref{development}:
+@item @ref{Development}:

 latest unstable version
 
 @end itemize
 @divEnd
 
 latest unstable version
 
 @end itemize
 @divEnd
 

+@divEnd

 
 @divClass{column-center-bottom}
 
 
 @divClass{column-center-bottom}
 


@@ -75,7 +95,7 @@ LilyPond is published under the
 
 @subheading Sponsors
 
 
 @subheading Sponsors
 

-Many thanks to @uref{http://www.vt.edu/, Virgina Tech} and
+Many thanks to @uref{http://www.vt.edu/, Virginia Tech} and

 @uref{http://www.linuxaudio.org/, linuxaudio.org} for sponsoring
 our bandwidth.
 
 @uref{http://www.linuxaudio.org/, linuxaudio.org} for sponsoring
 our bandwidth.
 


@@ -86,7 +106,7 @@ our bandwidth.
 
 @divClass{legal}
 All logos and product images are copyright and trademark
 
 @divClass{legal}
 All logos and product images are copyright and trademark

-acknowledged. 
+acknowledged.

 
 @logoLegalLinux
 
 
 @logoLegalLinux
 


@@ -102,18 +122,22 @@ acknowledged.
 
 @divClass{hide}
 @menu
 
 @divClass{hide}
 @menu

-* UNIX::                        
-* MacOS X::                     
-* Windows::                     
-* source::                      
-* old downloads::     
-* GPL::                         
+* Unix::
+* MacOS X::
+* Windows::
+* Source::
+* Old downloads::
+* GPL::

 @end menu
 @divEnd
 
 
 @end menu
 @divEnd
 
 

-@node UNIX
-@unnumberedsec UNIX
+@node Unix
+@unnumberedsec Unix
+
+@divClass{heading-center}
+@warningTextBased
+@divEnd

 
 @divClass{column-center-top}
 @subheading Generic Packages or Distribution-Specific Packages?
 
 @divClass{column-center-top}
 @subheading Generic Packages or Distribution-Specific Packages?


@@ -138,7 +162,13 @@ package manager.
 
 @item
 @sourceimage{logo-linux,,,}
 
 @item
 @sourceimage{logo-linux,,,}

-@downloadStableLinuxNormal
+@ifclear web_version
+  @downloadDevelLinuxNormal
+@end ifclear
+@ifset web_version
+  @downloadStableLinuxNormal
+@end ifset
+

 (if in doubt, use this)
 
 @item
 (if in doubt, use this)
 
 @item


@@ -180,7 +210,16 @@ uninstall-lilypond
 @divEnd
 
 
 @divEnd
 
 

+

 @divClass{column-right-top}
 @divClass{column-right-top}

+@subheading Compiling a file
+
+@lilypadCommandLine
+
+@divEnd
+
+
+@divClass{column-left-top}

 @subheading Distribution-specific Packages
 
 Please use your distribution's package manager to install or
 @subheading Distribution-specific Packages
 
 Please use your distribution's package manager to install or


@@ -190,28 +229,28 @@ upgrade to these versions.
 
 @item
 @sourceimage{logo-fedora,,,}
 
 @item
 @sourceimage{logo-fedora,,,}

-@uref{https://admin.fedoraproject.org/pkgdb/packages/name/lilypond,
-Fedora: LilyPond 2.12.0}
+@uref{http://koji.fedoraproject.org/koji/packageinfo?packageID=2447,
+Fedora: LilyPond 2.12.3}

 
 @item
 @sourceimage{logo-ubuntu,,,}
 
 @item
 @sourceimage{logo-ubuntu,,,}

-@uref{https://launchpad.net/ubuntu/+source/lilypond,
-Ubuntu: LilyPond 2.12.1}
+@uref{http://packages.ubuntu.com/search?keywords=lilypond,
+Ubuntu: LilyPond 2.12.2}

 
 @item
 @sourceimage{logo-slackware,,,}
 @uref{http://www.johannes-schoepfer.de/lilypond/,
 
 @item
 @sourceimage{logo-slackware,,,}
 @uref{http://www.johannes-schoepfer.de/lilypond/,

-Slackware: LilyPond 2.12.1}
+Slackware: LilyPond 2.12.3}

 
 @item
 @sourceimage{logo-debian,,,}
 @uref{http://packages.debian.org/search?keywords=lilypond,
 
 @item
 @sourceimage{logo-debian,,,}
 @uref{http://packages.debian.org/search?keywords=lilypond,

-Debian: LilyPond 2.10.33}
+Debian: LilyPond 2.12.2}

 
 @item
 @sourceimage{logo-suse,,,}
 
 @item
 @sourceimage{logo-suse,,,}

-@uref{http://opensuse.org/?fixme=urg-no-lilypond-package-page,
-openSUSE: LilyPond 2.10.33}
+@uref{http://software.opensuse.org/search?baseproject=openSUSE%3A11.2&p=1&q=lilypond,
+openSUSE: LilyPond 2.12.3}

 
 @end itemize
 
 
 @end itemize
 


@@ -236,6 +275,10 @@ acknowledged.
 @node MacOS X
 @unnumberedsec MacOS X
 
 @node MacOS X
 @unnumberedsec MacOS X
 

+@divClass{heading-center}
+@warningTextBased
+@divEnd
+

 @divClass{column-left-top}
 @subheading Packages
 
 @divClass{column-left-top}
 @subheading Packages
 


@@ -246,12 +289,14 @@ acknowledged.
 @item
 @sourceimage{logo-macosx,,,}
 @downloadStableDarwinNormal
 @item
 @sourceimage{logo-macosx,,,}
 @downloadStableDarwinNormal

-For Intel chips (if in doubt, use this).
+For MacOS X 10.4 or higher, running on Intel CPUs (if in doubt,
+use this).

 
 @item
 @sourceimage{logo-macosx,,,}
 @downloadStableDarwinPPC
 
 @item
 @sourceimage{logo-macosx,,,}
 @downloadStableDarwinPPC

-For G3 and G4 CPUs (old Apple computers).
+For MacOS X 10.4 or higher, running on G3 and G4 CPUs (old Apple
+computers).

 
 @end itemize
 
 
 @end itemize
 


@@ -266,38 +311,19 @@ Delete the LilyPond.app folder.
 
 @divEnd
 
 
 @divEnd
 

-

 @divClass{column-right-top}
 @divClass{column-right-top}

-@subheading Running on the command-line
-
-@warning{If you are happy with the GUI, then please ignore these
-instructions.}
-
-@ignore
-FIXME: I had one report that we don't need this stuff; will delete
-after confirmation.  -gp
+@subheading Compiling a file

 
 

-@subsubheading Using Python scripts on MacOS 10.3 or 10.4
+@lilypadOSX

 
 

-LilyPond binaries for MacOS X do not provide Python, but Python 2.4 or
-newer is required by @command{convert-ly}.  Therefore, if you use MacOS
-10.3 or 10.4, you must install a newer Python version from
-@uref{http://python.org/download/}, then edit the first line of
-@command{convert-ly} and @command{lilypond-book} as follows: if the
-Python binary you just installed is in your @var{PATH}, the first line
-should be
+@divEnd

 
 

-@example
-#!/usr/bin/env python
-@end example

 
 

-@noindent
-otherwise it should be
+@divClass{column-left-top}
+@subheading Running on the command-line

 
 

-@example
-#!@var{/path/to/newly_installed/python}
-@end example
-@end ignore
+@warning{If you are happy with the GUI, then please ignore these
+instructions.}

 
 @subsubheading MacOS X on the command line
 
 
 @subsubheading MacOS X on the command line
 


@@ -318,11 +344,11 @@ cd ~/bin
 @item
 Create a file called @command{lilypond} which contains
 
 @item
 Create a file called @command{lilypond} which contains
 

-@help obvious css issue to be dealt with.  :(
-@c we need a small font here to fit.  -gp
-@smallexample
+@divClass{h-scroll-auto}
+@example

 exec @var{DIR}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
 exec @var{DIR}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"

-@end smallexample
+@end example
+@divEnd

 
 @warning{@var{DIR} will generally be @code{/Applications/}}
 
 
 @warning{@var{DIR} will generally be @code{/Applications/}}
 


@@ -365,9 +391,11 @@ inside the @code{.app} file for MacOS@tie{}X.
 Scripts can also be run from the command line by invoking them
 directly:
 
 Scripts can also be run from the command line by invoking them
 directly:
 

+@divClass{h-scroll-auto}

 @example
 @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond
 @end example
 @example
 @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond
 @end example

+@divEnd

 
 The same is true for all other scripts in that directory, such as
 @command{lilypond-book} and @command{convert-ly}.
 
 The same is true for all other scripts in that directory, such as
 @command{lilypond-book} and @command{convert-ly}.


@@ -392,6 +420,10 @@ acknowledged.
 @node Windows
 @unnumberedsec Windows
 
 @node Windows
 @unnumberedsec Windows
 

+@divClass{heading-center}
+@warningTextBased
+@divEnd
+

 @divClass{column-left-top}
 @subheading Packages
 
 @divClass{column-left-top}
 @subheading Packages
 


@@ -402,7 +434,7 @@ acknowledged.
 @item
 @sourceimage{logo-windows,,,}
 @downloadStableWindows
 @item
 @sourceimage{logo-windows,,,}
 @downloadStableWindows

-For Windows ME, NT, 2000, XP, and Vista.
+For Windows 2000, XP, Vista and Windows 7.

 
 @end itemize
 
 
 @end itemize
 


@@ -412,46 +444,28 @@ For Windows ME, NT, 2000, XP, and Vista.
 
 @item
 Locate the downloaded file and double-click on it to start the
 
 @item
 Locate the downloaded file and double-click on it to start the

-installer. You will be presented a window titled @qq{Open File -
-Security Warning}, click on Run to continue.
-
-@item
-You will be presented the License Agreement; read this carefully,
-and click on the Next button if you accept it.
-
-@item
-Preferably leave the destination folder to the default, else
-browse to choose a different location, and click on the Next
-button.
-
-@item
-Next is the Installation Options window, leave the three options
-checked, as you will want to have all of these installed. Click
-on the Next button.
-
-@item
-Installation now commences, wait a minute or less for installation
-to complete. There is a Show Details button that when clicked on
-will show all the files installed and where, nothing you
-necessarily need to look at. Click on the Finish button.
-
-@item
-Lilypond is now installed.
+installer.  Follow the instructions given to you by the installer;
+we recommend that you leave all the install options checked and
+use the default installation location.  Click the @q{Finish} button
+when the installer has completed.  LilyPond is now installed.

 
 @end enumerate
 
 @subsubheading Uninstall
 
 
 @end enumerate
 
 @subsubheading Uninstall
 

-There are two uninstallation routes -
+To uninstall LilyPond either:

 
 @enumerate
 
 @item
 
 @enumerate
 
 @item

-Choose Uninstall from the Lilypond menu from the start menu
+Locate the LilyPond folder from the @q{Start} menu and click on the
+@q{Uninstall} icon.  Click the @q{Finish} button when the uninstaller
+has completed.

 
 @item
 
 @item

-Open your Install/Uninstall Applications on the Control Panel,
-scroll down to Lilypond and click on the Uninstall buttom.
+Or from within the Control Panel, locate and select LilyPond and then
+choose the option to uninstall/remove the software.  Click the @q{Finish}
+button when the uninstaller has completed.

 
 @end enumerate
 
 
 @end enumerate
 


@@ -459,12 +473,63 @@ scroll down to Lilypond and click on the Uninstall buttom.
 
 
 @divClass{column-right-top}
 
 
 @divClass{column-right-top}

+@subheading Compiling a file
+
+@lilypadWindows
+
+@divEnd
+
+
+@divClass{column-left-top}

 @subheading Running on the command-line
 
 @warning{If you are happy with the GUI, then please ignore these
 instructions.}
 
 @subheading Running on the command-line
 
 @warning{If you are happy with the GUI, then please ignore these
 instructions.}
 

-@help{don't know}
+@subsubheading Windows on the command line
+
+@ignore
+CHECK: check the following descriptions.
+I don't have English version of Windows.
+@end ignore
+
+The most convenient way to run LilyPond is by adding the folder
+which contains LilyPond executable files to the environmental variable
+@qq{Path}.
+
+
+@enumerate
+@item
+Open your @qq{System} on the Control Panel,
+select Advanced tab and click Environmental Variables button.
+
+@item
+Select the Variable @qq{Path} from Environmental variables list
+and click the Edit button.
+You will be presented a window titled @qq{Edit System Variable};
+append to @qq{Variable value} the name of the folder
+which contains LilyPond executable files like this:
+
+@example
+[@var{pre-set paths}];@var{DIR}\LilyPond\usr\bin
+@end example
+
+@warning{@var{DIR} will generally be @code{C:\Program Files}.}
+
+@noindent
+and click @qq{OK} button to close the window.
+
+@end enumerate
+
+@subsubheading Invoking individual executable files
+
+LilyPond executable files
+-- such as lilypond, lilypond-book, convert-ly, and so on --
+can be run from the command-line by invoking them:
+
+@example
+lilypond test.ly
+@end example

 
 @divEnd
 
 
 @divEnd
 


@@ -483,9 +548,13 @@ acknowledged.
 
 
 
 
 
 

-@node source
+@node Source

 @unnumberedsec Source
 
 @unnumberedsec Source
 

+@divClass{heading-center}
+@warningTextBased
+@divEnd
+

 @warning{We @strong{do not} recommend that you attempt to build
 LilyPond yourself; almost all user needs are better met with the
 pre-built version.}
 @warning{We @strong{do not} recommend that you attempt to build
 LilyPond yourself; almost all user needs are better met with the
 pre-built version.}


@@ -496,22 +565,26 @@ pre-built version.}
 @downloadStableSource{}
 
 For an extensive listing of all versions (old and new), see our
 @downloadStableSource{}
 
 For an extensive listing of all versions (old and new), see our

-@uref{http://download.linuxaudio.org/lilypond/binaries/, download
-site}.
+@uref{http://download.linuxaudio.org/lilypond/source/?C=N;O=D,
+download site}.

 
 @divEnd
 
 @divClass{column-right-bottom}
 @subheading Compiling instructions
 
 
 @divEnd
 
 @divClass{column-right-bottom}
 @subheading Compiling instructions
 

-Instructions are listed in @rcontrib{Compiling LilyPond}.
+Instructions are listed in @rcontrib{Compiling}.

 
 @divEnd
 
 
 
 @divEnd
 
 

-@node old downloads
+@node Old downloads

 @unnumberedsec Old downloads
 
 @unnumberedsec Old downloads
 

+@divClass{heading-center}
+@warningTextBased
+@divEnd
+

 @divClass{column-center-top}
 @subheading All versions
 
 @divClass{column-center-top}
 @subheading All versions
 


@@ -530,16 +603,13 @@ site}.
 
 GNU LilyPond is published under the GNU General Public License.
 An introduction to this license, and our reasons for choosing it,
 
 GNU LilyPond is published under the GNU General Public License.
 An introduction to this license, and our reasons for choosing it,

-is given in @ref{freedom}.
+is given in @ref{Freedom}.

 
 @divEnd
 
 @divClass{column-center-bottom}
 
 @divEnd
 
 @divClass{column-center-bottom}

-@subheading GNU General Public License version 2
+@subheading GNU General Public License

 
 

-@include gpl-2.0.itexi
+@include gpl.itexi

 
 @divEnd
 
 @divEnd

-
-
-