X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fweb%2Fdownload.itexi;h=365ecedaa3595aac6da3db6860c35f72d1653778;hb=9d3a999b3ae3502633858c50185c0180949d405c;hp=76b2dbd67f091bc134bb09ebf0baa864d9268fd8;hpb=f05c39dc08798f523703d019929ca0fecbc0183a;p=lilypond.git diff --git a/Documentation/web/download.itexi b/Documentation/web/download.itexi index 76b2dbd67f..365ecedaa3 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,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 - - -