--- /dev/null
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+ Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+ When revising a translation, copy the HEAD committish of the
+ 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}
+@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
+
+@divClass{link-headings}
+
+@divClass{column-left-top}
+@subheading For users
+
+@itemize
+
+@item
+@c ref is duplicated to avoid underlining ref as image.
+@ref{Unix, @sourceimage{logo-linux,,,}
+@sourceimage{logo-freebsd,,,}}
+@ref{Unix, Unix (Linux and FreeBSD)}
+
+@item
+@ref{MacOS X, @sourceimage{logo-macosx,,,}}
+@ref{MacOS X, MacOS X}
+
+@item
+@ref{Windows, @sourceimage{logo-windows,,,}}
+@ref{Windows, Microsoft Windows}
+
+@end itemize
+
+@divEnd
+
+@divClass{column-right-top}
+@subheading For developers
+
+@itemize
+
+@item
+@ref{Source}:
+for packagers
+
+@item
+@ref{Old downloads}:
+old versions
+
+@item @ref{Development}:
+latest unstable version
+
+@end itemize
+@divEnd
+
+@divEnd
+
+@divClass{column-center-bottom}
+
+@subheading Software License
+
+LilyPond is published under the
+@ref{GPL, GNU General Public License}.
+@divEnd
+
+
+@divClass{color1}
+
+@subheading Sponsors
+
+Many thanks to @uref{http://www.vt.edu/, Virginia Tech} and
+@uref{http://www.linuxaudio.org/, linuxaudio.org} for sponsoring
+our bandwidth.
+
+@sourceimage{VTlogo_ITF,,,}
+@sourceimage{lao_banner_06_on_white_demo,,,}
+
+@subheading Legalese
+
+@divClass{legal}
+All logos and product images are copyright and trademark
+acknowledged.
+
+@logoLegalLinux
+
+@logoLegalFreeBSD
+
+@logoLegalMacOSX
+
+@logoLegalWindows
+
+@divEnd
+@divEnd
+
+
+@divClass{hide}
+@menu
+* Unix::
+* MacOS X::
+* Windows::
+* Source::
+* Old downloads::
+* GPL::
+@end menu
+@divEnd
+
+
+@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.
+
+@divEnd
+
+
+@divClass{column-left-top}
+@subheading Generic Packages
+
+@subsubheading Download
+
+@itemize
+
+@item
+@sourceimage{logo-linux,,,}
+@ifclear web_version
+ @downloadDevelLinuxNormal
+@end ifclear
+@ifset web_version
+ @downloadStableLinuxNormal
+@end ifset
+
+(if in doubt, use this)
+
+@item
+@sourceimage{logo-linux,,,}
+@downloadStableLinuxBig
+
+@item
+@sourceimage{logo-linux,,,}
+@downloadStableLinuxPPC
+
+@item
+@sourceimage{logo-freebsd,,,}
+@downloadStableFreeBSDNormal
+
+@item
+@sourceimage{logo-freebsd,,,}
+@downloadStableFreeBSDBig
+
+@end itemize
+
+
+@subsubheading Install
+
+In the shell, type:
+
+@example
+cd PATH-TO-DOWNLOAD-DIRECTORY
+sh lilypond-@versionStable{}-OS-TYPE.sh
+@end example
+
+@subsubheading Uninstall
+
+In the shell, type:
+
+@example
+uninstall-lilypond
+@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
+upgrade to these versions.
+
+@itemize
+
+@item
+@sourceimage{logo-fedora,,,}
+@uref{http://koji.fedoraproject.org/koji/packageinfo?packageID=2447,
+Fedora: LilyPond 2.14.1}
+
+@item
+@sourceimage{logo-ubuntu,,,}
+@uref{http://packages.ubuntu.com/search?keywords=lilypond,
+Ubuntu: LilyPond 2.12.3}
+
+@item
+@sourceimage{logo-slackware,,,}
+@uref{http://www.johannes-schoepfer.de/lilypond/,
+Slackware: LilyPond 2.14.1}
+
+@item
+@sourceimage{logo-debian,,,}
+@uref{http://packages.debian.org/search?keywords=lilypond,
+Debian: LilyPond 2.12.3}
+
+@item
+@sourceimage{logo-suse,,,}
+@uref{http://software.opensuse.org/search?baseproject=openSUSE%3A11.2&p=1&q=lilypond,
+openSUSE: LilyPond 2.12.3}
+
+@end itemize
+
+@divEnd
+
+
+@divClass{column-center-bottom}
+@subheading Legalese
+
+@divClass{legal}
+All logos and product images are copyright and trademark
+acknowledged.
+
+@logoLegalLinux
+
+@logoLegalFreeBSD
+
+@divEnd
+@divEnd
+
+
+@node MacOS X
+@unnumberedsec MacOS X
+
+@divClass{heading-center}
+@warningTextBased
+@divEnd
+
+@divClass{column-left-top}
+@subheading Packages
+
+@subsubheading Download
+
+@itemize
+
+@item
+@sourceimage{logo-macosx,,,}
+@downloadStableDarwinNormal
+For MacOS X 10.4 or higher, running on Intel CPUs (if in doubt,
+use this).
+
+@item
+@sourceimage{logo-macosx,,,}
+@downloadStableDarwinPPC
+For MacOS X 10.4 or higher, running on G3 and G4 CPUs (old Apple
+computers).
+
+@end itemize
+
+@subsubheading Install
+
+Double-click the downloaded file, then drag it to wherever you
+want.
+
+@subsubheading Uninstall
+
+Delete the LilyPond.app folder.
+
+@divEnd
+
+@divClass{column-right-top}
+@subheading Compiling a file
+
+@lilypadOSX
+
+@divEnd
+
+
+@divClass{column-left-top}
+@subheading Running on the command-line
+
+@warning{If you are happy with the GUI, then please ignore these
+instructions.}
+
+@subsubheading MacOS X on the command line
+
+The most convenient way to run lilypond scripts is by setting up
+@qq{helper} scripts of your own.
+
+@enumerate
+
+@item
+Create a directory to store these scripts,
+
+@example
+mkdir -p ~/bin
+cd ~/bin
+@end example
+
+
+@item
+Create a file called @command{lilypond} which contains
+
+@divClass{h-scroll-auto}
+@example
+exec @var{DIR}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
+@end example
+@divEnd
+
+@warning{@var{DIR} will generally be @code{/Applications/}}
+
+
+@item
+Create similar files @command{lilypond-book},
+@command{convert-ly}, and any other scripts you wish to use, by
+replacing the @command{bin/lilypond} with @command{bin/convert-ly}
+(or other program name).
+
+
+@item
+Make the file executable,
+
+@example
+chmod u+x lilypond
+@end example
+
+
+@item
+Now, add this directory to your path. Modify (or create) a file
+called @code{.profile} in your home directory such that it
+contains
+
+@example
+export PATH=$PATH:~/bin
+@end example
+
+This file should end with a blank line.
+
+@end enumerate
+
+
+@subsubheading Invoking individual scripts
+
+The scripts --- such as @command{lilypond-book}, @command{convert-ly},
+@command{abc2ly}, and even @command{lilypond} itself --- are included
+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}.
+
+@divEnd
+
+
+@divClass{column-center-bottom}
+@subheading Legalese
+
+@divClass{legal}
+All logos and product images are copyright and trademark
+acknowledged.
+
+@logoLegalMacOSX
+
+@divEnd
+@divEnd
+
+
+
+@node Windows
+@unnumberedsec Windows
+
+@divClass{heading-center}
+@warningTextBased
+@divEnd
+
+@divClass{column-left-top}
+@subheading Packages
+
+@subsubheading Download
+
+@itemize
+
+@item
+@sourceimage{logo-windows,,,}
+@downloadStableWindows
+For Windows 2000, XP, Vista and Windows 7.
+
+@end itemize
+
+@subsubheading Install
+
+@enumerate
+
+@item
+Locate the downloaded file and double-click on it to start the
+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
+
+To uninstall LilyPond either:
+
+@enumerate
+
+@item
+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
+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
+
+@divEnd
+
+
+@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.}
+
+@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
+
+
+@divClass{column-center-bottom}
+@subheading Legalese
+
+@divClass{legal}
+All logos and product images are copyright and trademark
+acknowledged.
+
+@logoLegalWindows
+
+@divEnd
+@divEnd
+
+
+
+@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.}
+
+@divClass{column-left-bottom}
+@subheading Source tarball
+
+@downloadStableSource{}
+
+For an extensive listing of all versions (old and new), see our
+@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}.
+
+@divEnd
+
+
+@node Old downloads
+@unnumberedsec Old downloads
+
+@divClass{heading-center}
+@warningTextBased
+@divEnd
+
+@divClass{column-center-top}
+@subheading All versions
+
+For an extensive listing of all versions (old and new), see our
+@uref{http://download.linuxaudio.org/lilypond/binaries/, download
+site}.
+
+@divEnd
+
+
+@node GPL
+@unnumberedsec GPL
+
+@divClass{column-center-top}
+@subheading Software license
+
+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}.
+
+@divEnd
+
+@divClass{column-center-bottom}
+@subheading GNU General Public License
+
+@include gpl.itexi
+
+@divEnd
projects / lilypond.git / blobdiff