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