]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/web/download.itexi
Add missing shebang line in MacOSX instructions.
[lilypond.git] / Documentation / web / download.itexi
index 76b2dbd67f091bc134bb09ebf0baa864d9268fd8..365ecedaa3595aac6da3db6860c35f72d1653778 100644 (file)
@@ -3,21 +3,40 @@
     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
 
+@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}
-@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
 
-@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
@@ -25,7 +44,7 @@ our @ref{Text input}.}
 @itemize
 
 @item
-@c TODO: duplicate to avoid underlined refs in HTML?  icky.
+@c ref is duplicated to avoid underlining ref as image.
 @ref{Unix, @sourceimage{logo-linux,,,}
 @sourceimage{logo-freebsd,,,}}
 @ref{Unix, Unix (Linux and FreeBSD)}
@@ -61,6 +80,7 @@ latest unstable version
 @end itemize
 @divEnd
 
+@divEnd
 
 @divClass{column-center-bottom}
 
@@ -75,7 +95,7 @@ LilyPond is published under the
 
 @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.
 
@@ -86,7 +106,7 @@ our bandwidth.
 
 @divClass{legal}
 All logos and product images are copyright and trademark
-acknowledged. 
+acknowledged.
 
 @logoLegalLinux
 
@@ -102,12 +122,12 @@ acknowledged.
 
 @divClass{hide}
 @menu
-* Unix::                        
-* MacOS X::                     
-* Windows::                     
-* Source::                      
-* Old downloads::     
-* GPL::                         
+* Unix::
+* MacOS X::
+* Windows::
+* Source::
+* Old downloads::
+* GPL::
 @end menu
 @divEnd
 
@@ -115,6 +135,10 @@ acknowledged.
 @node Unix
 @unnumberedsec Unix
 
+@divClass{heading-center}
+@warningTextBased
+@divEnd
+
 @divClass{column-center-top}
 @subheading Generic Packages or Distribution-Specific Packages?
 
@@ -138,7 +162,13 @@ package manager.
 
 @item
 @sourceimage{logo-linux,,,}
-@downloadStableLinuxNormal
+@ifclear web_version
+  @downloadDevelLinuxNormal
+@end ifclear
+@ifset web_version
+  @downloadStableLinuxNormal
+@end ifset
+
 (if in doubt, use this)
 
 @item
@@ -177,10 +207,27 @@ In the shell, type:
 uninstall-lilypond
 @end example
 
+@subsubheading Help
+
+In the shell, type:
+
+@example
+sh lilypond-@versionStable{}-OS-TYPE.sh --help
+@end example
+
 @divEnd
 
 
+
 @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
@@ -190,28 +237,28 @@ upgrade to these versions.
 
 @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.14.2}
 
 @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.14.2}
 
 @item
 @sourceimage{logo-slackware,,,}
 @uref{http://www.johannes-schoepfer.de/lilypond/,
-Slackware: LilyPond 2.12.1}
+Slackware: LilyPond 2.14.2}
 
 @item
 @sourceimage{logo-debian,,,}
 @uref{http://packages.debian.org/search?keywords=lilypond,
-Debian: LilyPond 2.10.33}
+Debian: LilyPond 2.12.3}
 
 @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
 
@@ -236,6 +283,10 @@ acknowledged.
 @node MacOS X
 @unnumberedsec MacOS X
 
+@divClass{heading-center}
+@warningTextBased
+@divEnd
+
 @divClass{column-left-top}
 @subheading Packages
 
@@ -246,12 +297,18 @@ acknowledged.
 @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).
+
+MacOS X 10.7 Lion is not yet supported.
 
 @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).
+
+MacOS X 10.7 Lion is not yet supported.
 
 @end itemize
 
@@ -266,38 +323,19 @@ Delete the LilyPond.app folder.
 
 @divEnd
 
-
 @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
 
@@ -318,11 +356,12 @@ cd ~/bin
 @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
+#!/bin/bash
 exec @var{DIR}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
-@end smallexample
+@end example
+@divEnd
 
 @warning{@var{DIR} will generally be @code{/Applications/}}
 
@@ -365,9 +404,11 @@ inside the @code{.app} file for MacOS@tie{}X.
 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
+@divEnd
 
 The same is true for all other scripts in that directory, such as
 @command{lilypond-book} and @command{convert-ly}.
@@ -392,6 +433,10 @@ acknowledged.
 @node Windows
 @unnumberedsec Windows
 
+@divClass{heading-center}
+@warningTextBased
+@divEnd
+
 @divClass{column-left-top}
 @subheading Packages
 
@@ -402,7 +447,7 @@ acknowledged.
 @item
 @sourceimage{logo-windows,,,}
 @downloadStableWindows
-For Windows ME, NT, 2000, XP, and Vista.
+For Windows 2000, XP, Vista and Windows 7.
 
 @end itemize
 
@@ -412,46 +457,28 @@ For Windows ME, NT, 2000, XP, and Vista.
 
 @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
 
-There are two uninstallation routes -
+To uninstall LilyPond either:
 
 @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
-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
 
@@ -459,12 +486,63 @@ scroll down to Lilypond and click on the Uninstall buttom.
 
 
 @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.}
 
-@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:@bs{}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
 
@@ -486,6 +564,10 @@ acknowledged.
 @node 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.}
@@ -496,15 +578,15 @@ pre-built version.}
 @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
 
-Instructions are listed in @rcontrib{Compiling LilyPond}.
+Instructions are listed in @rcontrib{Compiling}.
 
 @divEnd
 
@@ -512,6 +594,10 @@ Instructions are listed in @rcontrib{Compiling LilyPond}.
 @node Old downloads
 @unnumberedsec Old downloads
 
+@divClass{heading-center}
+@warningTextBased
+@divEnd
+
 @divClass{column-center-top}
 @subheading All versions
 
@@ -535,11 +621,8 @@ is given in @ref{Freedom}.
 @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
-
-
-