]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/web/download.itexi
Fix typos in the English manual.
[lilypond.git] / Documentation / web / download.itexi
index 79985f58d537d86d824d17003e9335bceda9db5f..3dab2a81695ced4cdae459c6d419fa4eb6e24785 100644 (file)
@@ -3,21 +3,38 @@
     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
 
-@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}
-@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
 
-@divEnd
+@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
 
-@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}.}
+@warningTextBased
+
+@divEnd
 
 @divClass{column-left-top}
 @subheading For users
@@ -26,9 +43,9 @@ our @ref{text input}.}
 
 @item
 @c TODO: duplicate to avoid underlined refs in HTML?  icky.
-@ref{UNIX, @sourceimage{logo-linux,,,}
+@ref{Unix, @sourceimage{logo-linux,,,}
 @sourceimage{logo-freebsd,,,}}
-@ref{UNIX, Unix (Linux and FreeBSD)}
+@ref{Unix, Unix (Linux and FreeBSD)}
 
 @item
 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
@@ -48,14 +65,14 @@ our @ref{text input}.}
 @itemize
 
 @item
-@ref{source}:
+@ref{Source}:
 for packagers
 
 @item
-@ref{old downloads}:
+@ref{Old downloads}:
 old versions
 
-@item @ref{development}:
+@item @ref{Development}:
 latest unstable version
 
 @end itemize
@@ -75,7 +92,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 +103,7 @@ our bandwidth.
 
 @divClass{legal}
 All logos and product images are copyright and trademark
-acknowledged. 
+acknowledged.
 
 @logoLegalLinux
 
@@ -102,18 +119,22 @@ acknowledged.
 
 @divClass{hide}
 @menu
-* UNIX::                        
-* MacOS X::                     
-* Windows::                     
-* source::                      
-* old downloads::     
-* GPL::                         
+* Unix::
+* MacOS X::
+* Windows::
+* Source::
+* Old downloads::
+* GPL::
 @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?
@@ -138,7 +159,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
@@ -180,7 +207,16 @@ uninstall-lilypond
 @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 +226,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.12.3}
 
 @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/,
-Slackware: LilyPond 2.12.1}
+Slackware: LilyPond 2.12.3}
 
 @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,,,}
-@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 +272,10 @@ acknowledged.
 @node MacOS X
 @unnumberedsec MacOS X
 
+@divClass{heading-center}
+@warningTextBased
+@divEnd
+
 @divClass{column-left-top}
 @subheading Packages
 
@@ -266,38 +306,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
 
@@ -392,6 +413,10 @@ acknowledged.
 @node Windows
 @unnumberedsec Windows
 
+@divClass{heading-center}
+@warningTextBased
+@divEnd
+
 @divClass{column-left-top}
 @subheading Packages
 
@@ -402,7 +427,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 +437,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 +466,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:\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
 
@@ -483,9 +541,13 @@ acknowledged.
 
 
 
-@node source
+@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,22 +558,26 @@ 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
 
 
-@node old downloads
+@node Old downloads
 @unnumberedsec Old downloads
 
+@divClass{heading-center}
+@warningTextBased
+@divEnd
+
 @divClass{column-center-top}
 @subheading All versions
 
@@ -530,14 +596,14 @@ site}.
 
 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}
-@subheading GNU General Public License version 2
+@subheading GNU General Public License
 
-@include gpl-2.0.itexi
+@include gpl.itexi
 
 @divEnd