X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fweb%2Fdownload.itexi;h=b4c6e2f13bb5a07736c1258e75b7ae42a672ac25;hb=ebda49421d5926699628907ee06bcb1e3d0a9212;hp=0d372cee938a3bcb6a42ae70c79c90caed6b959a;hpb=1fd29bdb88eea92929c76b73a9f5e1d600295b8e;p=lilypond.git diff --git a/Documentation/web/download.itexi b/Documentation/web/download.itexi index 0d372cee93..b4c6e2f13b 100644 --- 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 - 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,10 +44,10 @@ 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)} +@ref{Unix, Unix (GNU/Linux and FreeBSD)} @item @ref{MacOS X, @sourceimage{logo-macosx,,,}} @@ -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,16 +135,19 @@ acknowledged. @node Unix @unnumberedsec Unix +@divClass{heading-center} +@warningTextBased +@divEnd + @divClass{column-center-top} @subheading Generic Packages or Distribution-Specific Packages? -Many distributions include LilyPond in their normal package -system. These versions are easier to install and uninstall than -the generic packages, but they may be older. If you wish to use -our generic packages, please uninstall the official version from -your system using the normal package manager for your distribution. -See your distribution's documentation about how to use their -package manager. +Many distributions include LilyPond within their normal package +repositories that are often @emph{significantly} older than the current +stable version. While these older packages may be easier to install, we +@emph{strongly} recommend that you use our generic packages. In this +case, check that your LilyPond editor is using the correct version. +See @ref{Easier editing}. @divEnd @@ -138,12 +161,18 @@ package manager. @item @sourceimage{logo-linux,,,} -@downloadStableLinuxNormal -(if in doubt, use this) +@ifclear web_version + @downloadDevelLinuxNormal +@end ifclear +@ifset web_version + @downloadStableLinuxNormal +@end ifset +32bit Systems. @item @sourceimage{logo-linux,,,} @downloadStableLinuxBig +64bit Systems. @item @sourceimage{logo-linux,,,} @@ -152,10 +181,12 @@ package manager. @item @sourceimage{logo-freebsd,,,} @downloadStableFreeBSDNormal +32bit Systems. @item @sourceimage{logo-freebsd,,,} @downloadStableFreeBSDBig +64bit Systems @end itemize @@ -177,43 +208,22 @@ In the shell, type: uninstall-lilypond @end example -@divEnd - - -@divClass{column-right-top} -@subheading Distribution-specific Packages - -Please use your distribution's package manager to install or -upgrade to these versions. +@subsubheading Help -@itemize +In the shell, type: -@item -@sourceimage{logo-fedora,,,} -@uref{https://admin.fedoraproject.org/pkgdb/packages/name/lilypond, -Fedora: LilyPond 2.12.0} +@example +sh lilypond-@versionStable{}-OS-TYPE.sh --help +@end example -@item -@sourceimage{logo-ubuntu,,,} -@uref{https://launchpad.net/ubuntu/+source/lilypond, -Ubuntu: LilyPond 2.12.1} +@divEnd -@item -@sourceimage{logo-slackware,,,} -@uref{http://www.johannes-schoepfer.de/lilypond/, -Slackware: LilyPond 2.12.1} -@item -@sourceimage{logo-debian,,,} -@uref{http://packages.debian.org/search?keywords=lilypond, -Debian: LilyPond 2.10.33} -@item -@sourceimage{logo-suse,,,} -@uref{http://opensuse.org/?fixme=urg-no-lilypond-package-page, -openSUSE: LilyPond 2.10.33} +@divClass{column-right-top} +@subheading Compiling a file -@end itemize +@lilypadCommandLine @divEnd @@ -236,6 +246,10 @@ acknowledged. @node MacOS X @unnumberedsec MacOS X +@divClass{heading-center} +@warningTextBased +@divEnd + @divClass{column-left-top} @subheading Packages @@ -246,12 +260,16 @@ 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). + @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 @@ -270,34 +288,8 @@ Delete the LilyPond.app folder. @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 - -@subsubheading Using Python scripts on MacOS 10.3 or 10.4 - -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 - -@example -#!/usr/bin/env python -@end example - -@noindent -otherwise it should be - -@example -#!@var{/path/to/newly_installed/python} -@end example -@end ignore +@warning{If you are happy with the GUI instructions below, then +please ignore these instructions.} @subsubheading MacOS X on the command line @@ -318,11 +310,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 +358,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}. @@ -375,6 +370,14 @@ The same is true for all other scripts in that directory, such as @divEnd +@divClass{column-center-top} +@subheading Compiling a file + +@lilypadOSX + +@divEnd + + @divClass{column-center-bottom} @subheading Legalese @@ -392,6 +395,10 @@ acknowledged. @node Windows @unnumberedsec Windows +@divClass{heading-center} +@warningTextBased +@divEnd + @divClass{column-left-top} @subheading Packages @@ -402,7 +409,7 @@ acknowledged. @item @sourceimage{logo-windows,,,} @downloadStableWindows -For Windows ME, NT, 2000, XP, Vista, and Windows 7. +For Windows 2000, XP, Vista, Windows 7 and 8. @end itemize @@ -412,59 +419,92 @@ For Windows ME, NT, 2000, XP, Vista, and Windows 7. @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. +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. -@item -You will be presented the License Agreement; read this carefully, -and click on the Next button if you accept it. +@end enumerate -@item -Preferably leave the destination folder to the default, else -browse to choose a different location, and click on the Next -button. +@subsubheading Uninstall -@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. +To uninstall LilyPond either: + +@enumerate @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. +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 -Lilypond is now installed. +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 -@subsubheading Uninstall +@divEnd -There are two uninstallation routes - -@enumerate +@divClass{column-right-top} +@subheading Running on the command-line + +@warning{If you are happy with the GUI instructions below, then +please ignore these instructions.} + +@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 -Choose Uninstall from the Lilypond menu from the start menu +Open your @qq{System} on the Control Panel, +select Advanced tab and click Environmental Variables button. @item -Open your Install/Uninstall Applications on the Control Panel, -scroll down to Lilypond and click on the Uninstall buttom. +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 -@divEnd +@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: -@divClass{column-right-top} -@subheading Running on the command-line +@example +lilypond test.ly +@end example -@warning{If you are happy with the GUI, then please ignore these -instructions.} +@divEnd -@help{don't know} + +@divClass{column-center-top} +@subheading Compiling a file + +@lilypadWindows @divEnd @@ -486,6 +526,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 +540,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 +556,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 @@ -540,6 +588,3 @@ is given in @ref{Freedom}. @include gpl.itexi @divEnd - - -