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