Documentation/general/download.itexi

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
   4
   5     When revising a translation, copy the HEAD committish of the
   6     version that you are working on.  See TRANSLATION for details.
   7 @end ignore
   8
   9 @node Download
  10 @unnumbered Download
  11
  12 @divClass{heading-center}
  13 @heading Downloads for LilyPond 2.12.2
  14
  15 @divEnd
  16
  17 @warning{LilyPond is a @strong{text-based} music engraver; it is
  18 more similar to a programming language than a graphical score
  19 editing program.  Before downloading LilyPond, please read about
  20 our @ref{Text input}.}
  21
  22 @divClass{column-left-top}
  23 @subheading For users
  24
  25 @itemize
  26
  27 @item
  28 @c TODO: duplicate to avoid underlined refs in HTML?  icky.
  29 @ref{Unix, @sourceimage{logo-linux} @sourceimage{logo-freebsd}}
  30 @ref{Unix, Unix (Linux and FreeBSD)}
  31
  32 @item
  33 @ref{MacOS X, @sourceimage{logo-macosx}}
  34 @ref{MacOS X, MacOS X}
  35
  36 @item
  37 @ref{Windows, @sourceimage{logo-windows}}
  38 @ref{Windows, Microsoft Windows}
  39
  40 @end itemize
  41
  42 @divEnd
  43
  44 @divClass{column-right-top}
  45 @subheading For developers
  46
  47 @itemize
  48
  49 @item
  50 @ref{Source}:
  51 for packagers
  52
  53 @item
  54 @ref{Old downloads}:
  55 old versions
  56
  57 @item @ref{Development}:
  58 latest unstable version
  59
  60 @end itemize
  61 @divEnd
  62
  63
  64 @divClass{column-center-bottom}
  65
  66 @subheading Software License
  67
  68 LilyPond is published under the @ref{GPL, GNU General Public
  69 License}.
  70 @divEnd
  71
  72
  73 @divClass{color1}
  74
  75 @subheading Sponsors
  76
  77 Many thanks to @uref{http://www.vt.edu/, Virgina Tech} and
  78 @uref{http://www.linuxaudio.org/, linuxaudio.org} for sponsoring
  79 our bandwidth.
  80
  81 @sourceimage{VTlogo_ITF} @sourceimage{lao_banner_06_on_white_demo}
  82
  83 @subheading Legalese
  84
  85 @divClass{legal}
  86 All logos and product images are copyright and trademark
  87 acknowledged.
  88
  89 @logoLegalLinux
  90
  91 @logoLegalFreeBSD
  92
  93 @logoLegalMacOSX
  94
  95 @logoLegalWindows
  96
  97 @divEnd
  98 @divEnd
  99
 100
 101 @divClass{hide}
 102 @menu
 103 * Unix::
 104 * MacOS X::
 105 * Windows::
 106 * Source::
 107 * Old downloads::
 108 * GPL::
 109 @end menu
 110 @divEnd
 111
 112
 113 @node Unix
 114 @unnumberedsec Unix
 115
 116 @divClass{column-center-top}
 117 @subheading Generic Packages or Distribution-Specific Packages?
 118
 119 Many distributions include LilyPond in their normal package
 120 system.  These versions are easier to install and uninstall than
 121 the generic packages, but they may be older.  If you wish to use
 122 our generic packages, please uninstall the official version from
 123 your system using the normal package manager for your distribution.
 124 See your distribution's documentation about how to use their
 125 package manager.
 126
 127 @divEnd
 128
 129
 130 @divClass{column-left-top}
 131 @subheading Generic Packages
 132
 133 @subsubheading Download
 134
 135 @itemize
 136
 137 @item
 138 @sourceimage{logo-linux}
 139 @uref{http://download.linuxaudio.org/lilypond/binaries/linux-x86/lilypond-2.12.2-1.linux-x86.sh,
 140 Linux x86: LilyPond 2.12.2} (if in doubt, use this)
 141
 142 @item
 143 @sourceimage{logo-linux}
 144 @uref{http://download.linuxaudio.org/lilypond/binaries/linux-64/lilypond-2.12.2-1.linux-64.sh,
 145 Linux 64-bit: LilyPond 2.12.2}
 146
 147 @item
 148 @sourceimage{logo-linux}
 149 @uref{http://download.linuxaudio.org/lilypond/binaries/linux-ppc/lilypond-2.12.2-1.linux-ppc.sh,
 150 Linux PPC: LilyPond 2.12.2}
 151
 152 @item
 153 @sourceimage{logo-freebsd}
 154 @uref{http://download.linuxaudio.org/lilypond/binaries/freebsd-x86/lilypond-2.12.2-1.freebsd-x86.sh,
 155 FreeBSD i386: LilyPond 2.12.2}
 156
 157 @item
 158 @sourceimage{logo-freebsd}
 159 @uref{http://download.linuxaudio.org/lilypond/binaries/freebsd-64/lilypond-2.12.2-1.freebsd-64.sh,
 160 FreeBSD amd64: LilyPond 2.12.2}
 161
 162 @end itemize
 163
 164
 165 @subsubheading Install
 166
 167 In the shell, type:
 168
 169 @example
 170 cd PATH-TO-DOWNLOAD-DIRECTORY
 171 sh lilypond-X.Y.Z-EXAMPLE.sh
 172 @end example
 173
 174 @subsubheading Uninstall
 175
 176 In the shell, type:
 177
 178 @example
 179 uninstall-lilypond
 180 @end example
 181
 182 @divEnd
 183
 184
 185 @divClass{column-right-top}
 186 @subheading Distribution-specific Packages
 187
 188 Please use your distribution's package manager to install or
 189 upgrade to these versions.
 190
 191 @itemize
 192
 193 @item
 194 @sourceimage{logo-fedora}
 195 @uref{https://admin.fedoraproject.org/pkgdb/packages/name/lilypond,
 196 Fedora: LilyPond 2.12.0}
 197
 198 @item
 199 @sourceimage{logo-ubuntu}
 200 @uref{https://launchpad.net/ubuntu/+source/lilypond,
 201 Ubuntu: LilyPond 2.12.1}
 202
 203 @item
 204 @sourceimage{logo-slackware}
 205 @uref{http://www.johannes-schoepfer.de/lilypond/,
 206 Slackware: LilyPond 2.12.1}
 207
 208 @item
 209 @sourceimage{logo-debian}
 210 @uref{http://packages.debian.org/search?keywords=lilypond,
 211 Debian: LilyPond 2.10.33}
 212
 213 @item
 214 @sourceimage{logo-suse}
 215 @uref{http://opensuse.org/?fixme=urg-no-lilypond-package-page,
 216 openSUSE: LilyPond 2.10.33}
 217
 218 @end itemize
 219
 220 @divEnd
 221
 222
 223 @divClass{column-center-bottom}
 224 @subheading Legalese
 225
 226 @divClass{legal}
 227 All logos and product images are copyright and trademark
 228 acknowledged.
 229
 230 @logoLegalLinux
 231
 232 @logoLegalFreeBSD
 233
 234 @divEnd
 235 @divEnd
 236
 237
 238 @node MacOS X
 239 @unnumberedsec MacOS X
 240
 241 @divClass{column-left-top}
 242 @subheading Packages
 243
 244 @subsubheading Download
 245
 246 @itemize
 247
 248 @item
 249 @sourceimage{logo-macosx}
 250 @uref{
 251 http://download.linuxaudio.org/lilypond/binaries/darwin-x86/lilypond-2.12.2-1.darwin-x86.tar.bz2,
 252 lilypond-2.12.2-1.darwin-x86.tar.bz2}
 253 For Intel chips (if in doubt, use this).
 254
 255 @item
 256 @sourceimage{logo-macosx}
 257 @uref{
 258 http://download.linuxaudio.org/lilypond/binaries/darwin-x86/lilypond-2.12.2-1.darwin-ppc.tar.bz2,
 259 lilypond-2.12.2-1.darwin-ppc.tar.bz2}
 260 For G3 and G4 CPUs (old Apple computers).
 261
 262 @end itemize
 263
 264 @subsubheading Install
 265
 266 Double-click the downloaded file, then drag it to wherever you
 267 want.
 268
 269 @subsubheading Uninstall
 270
 271 Delete the LilyPond.app folder.
 272
 273 @divEnd
 274
 275
 276 @divClass{column-right-top}
 277 @subheading Running on the command-line
 278
 279 @warning{If you are happy with the GUI, then please ignore these
 280 instructions.}
 281
 282 FIXME: once 2.12.4 is out, delete a bunch of this -- IIRC we now
 283 *do* provide Python, so this stuff gets much easier.
 284
 285 @subsubheading Using Python scripts on MacOS 10.3 or 10.4
 286
 287 LilyPond binaries for MacOS X do not provide Python, but Python 2.4 or
 288 newer is required by @command{convert-ly}.  Therefore, if you use MacOS
 289 10.3 or 10.4, you must install a newer Python version from
 290 @uref{http://python.org/download/}, then edit the first line of
 291 @command{convert-ly} and @command{lilypond-book} as follows: if the
 292 Python binary you just installed is in your @var{PATH}, the first line
 293 should be
 294
 295 @example
 296 #!/usr/bin/env python
 297 @end example
 298
 299 @noindent
 300 otherwise it should be
 301
 302 @example
 303 #!@var{/path/to/newly_installed/python}
 304 @end example
 305
 306
 307 @subsubheading MacOS X on the command line
 308
 309 The scripts --- such as @command{lilypond-book}, @command{convert-ly},
 310 @command{abc2ly}, and even @command{lilypond} itself --- are included
 311 inside the @code{.app} file for MacOS@tie{}X.  They can be run from
 312 the command line by invoking them directly, e.g.
 313
 314 @example
 315 @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond
 316 @end example
 317
 318 @noindent
 319 The same is true of the other scripts in that directory, including
 320 @command{lilypond-book}, @command{convert-ly}, @command{abc2ly}, etc.
 321
 322 Alternatively, you may create scripts which add the path
 323 automatically.  Create a directory to store these scripts,
 324
 325 @example
 326 mkdir -p ~/bin
 327 cd ~/bin
 328 @end example
 329
 330 Create a file called @code{lilypond} which contains
 331
 332 @example
 333 exec @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
 334 @end example
 335
 336 Create similar files @code{lilypond-book}, @code{convert-ly}, and
 337 any other helper programs you use (@code{abc2ly}, @code{midi2ly},
 338 etc).  Simply replace the @code{bin/lilypond} with
 339 @code{bin/convert-ly} (or other program name) in the above file.
 340
 341 Make the file executable,
 342
 343 @example
 344 chmod u+x lilypond
 345 @end example
 346
 347 Now, add this directory to your path.  Modify (or create)
 348 a file called @code{.profile} in your home directory such that it contains
 349
 350 @example
 351 export PATH=$PATH:~/bin
 352 @end example
 353
 354 @noindent
 355 This file should end with a blank line.
 356
 357 Note that @var{path/to} will generally be @code{/Usages/}.
 358
 359
 360
 361 @divEnd
 362
 363
 364 @divClass{column-center-bottom}
 365 @subheading Legalese
 366
 367 @divClass{legal}
 368 All logos and product images are copyright and trademark
 369 acknowledged.
 370
 371 @logoLegalMacOSX
 372
 373 @divEnd
 374 @divEnd
 375
 376
 377
 378 @node Windows
 379 @unnumberedsec Windows
 380
 381 @divClass{column-left-top}
 382 @subheading Packages
 383
 384 @subsubheading Download
 385
 386 @itemize
 387
 388 @item
 389 @sourceimage{logo-windows}
 390 @uref{
 391 http://download.linuxaudio.org/lilypond/binaries/mingw/lilypond-2.12.2-1.mingw.exe,
 392 lilypond-2.12.2-1.mingw-exe}
 393 For Windows ME, NT, 2000, XP, and Vista.
 394
 395 @end itemize
 396
 397 @subsubheading Install
 398
 399 @enumerate
 400
 401 @item
 402 Locate the downloaded file and double-click on it to start the
 403 installer. You will be presented a window titled @qq{Open File -
 404 Security Warning}, click on Run to continue.
 405
 406 @item
 407 You will be presented the License Agreement; read this carefully,
 408 and click on the Next button if you accept it.
 409
 410 @item
 411 Preferably leave the destination folder to the default, else
 412 browse to choose a different location, and click on the Next
 413 button.
 414
 415 @item
 416 Next is the Installation Options window, leave the three options
 417 checked, as you will want to have all of these installed. Click
 418 on the Next button.
 419
 420 @item
 421 Installation now commences, wait a minute or less for installation
 422 to complete. There is a Show Details button that when clicked on
 423 will show all the files installed and where, nothing you
 424 necessarily need to look at. Click on the Finish button.
 425
 426 @item
 427 Lilypond is now installed.
 428
 429 @end enumerate
 430
 431 @subsubheading Uninstall
 432
 433 There are two uninstallation routes -
 434
 435 @enumerate
 436
 437 @item
 438 Choose Uninstall from the Lilypond menu from the start menu
 439
 440 @item
 441 Open your Install/Uninstall Applications on the Control Panel,
 442 scroll down to Lilypond and click on the Uninstall buttom.
 443
 444 @end enumerate
 445
 446 @divEnd
 447
 448
 449 @divClass{column-right-top}
 450 @subheading Running on the command-line
 451
 452 @warning{If you are happy with the GUI, then please ignore these
 453 instructions.}
 454
 455 @help{don't know}
 456
 457 @divEnd
 458
 459
 460 @divClass{column-center-bottom}
 461 @subheading Legalese
 462
 463 @divClass{legal}
 464 All logos and product images are copyright and trademark
 465 acknowledged.
 466
 467 @logoLegalWindows
 468
 469 @divEnd
 470 @divEnd
 471
 472
 473
 474 @node Source
 475 @unnumberedsec Source
 476
 477 @warning{We @strong{do not} recommend that you attempt to build
 478 LilyPond yourself; almost all user needs are better met with the
 479 pre-built version.}
 480
 481 @divClass{column-left-bottom}
 482 @subheading Source tarball
 483
 484 @uref{http://download.linuxaudio.org/lilypond/sources/v2.12/lilypond-2.12.2.tar.gz,
 485 lilypond-2.12.2-source.tar.bz2}
 486
 487 For an extensive listing of all versions (old and new), see our
 488 @uref{http://download.linuxaudio.org/lilypond/binaries/, download
 489 site}.
 490
 491 @divEnd
 492
 493 @divClass{column-right-bottom}
 494 @subheading Compiling instructions
 495
 496 Instructions are listed in @@ref@{FIXME development-install@}.
 497
 498 @divEnd
 499
 500
 501 @node Old downloads
 502 @unnumberedsec Old downloads
 503
 504 @divClass{column-center-top}
 505 @subheading All versions
 506
 507 For an extensive listing of all versions (old and new), see our
 508 @uref{http://download.linuxaudio.org/lilypond/binaries/, download
 509 site}.
 510
 511 @divEnd
 512
 513
 514 @node GPL
 515 @unnumberedsec GPL
 516
 517 @divClass{column-center-top}
 518 @subheading Software license
 519
 520 GNU LilyPond is published under the GNU General Public License.
 521 An introduction to this license, and our reasons for choosing it,
 522 is given in @ref{Freedom}.
 523
 524 @divEnd
 525
 526 @divClass{column-center-bottom}
 527 @subheading GNU General Public License version 2
 528
 529 @include gpl-2.0.itexi
 530
 531 @divEnd
 532
 533
 534