--- HOW TO INSTALL LILYPOND ON MAC OS X ---

---  Requirements:
a) Download and install X11, Apple XCode and X11SDK
b) Download and install fink
c) If necessary, enable unstable tree
d) Be connected to internet
e) You have to know your administrator password

1) INSTALL X11

1) Install X11 from Panther's third cd or downloading
from Apple website http://www.apple.com/macosx/features/x11/download/
You will need an Apple ID, see next section.

2) INSTALL APPLE'S XCODE 

a) Go to http://connect.apple.com
b) Follow the instructions to get a free online membership to Apple 
Developer Connection.
e) Download the Xcode Tools 1.5	- CD Image
g) install Xcode and the X11SDK.pkg.


3) INSTALL FINK

a) Go to the website: http://fink.sourceforge.net/download/index.php
and download the Binary installer (at this moment, January 2005, the 
right version for Panther is called Fink 0.7.1 Binary Installer).

Briefly, Fink is a software that allows you to easily install software 
originally developed on linux environment, to Mac OS X; this software is 
already modifyied (ported) in order to run on Macintosh.

Fink will install itself and all the software in a new folder alled "sw"
If you want to move the /sw folder to another position, check:
http://homepage.mac.com/sao1/fink/how.html 

If you don't know nothing about linux, terminal etc., 
two goods starting point are http://www.gnu.org, to understand why also 
lilypond is free software and what this means, and 
http://www.osxfaq.com/Tutorials/LearningCenter/index.ws, to understand how to use the terminal.

4) FINK OR FINKCOMMANDER

FinkCommander is provided together with Fink, and it is a graphic interface to use Fink.


After you have installed Fink, remember to give, from the terminal, the following commands:

"fink selfupdate" and
"fink update-all"

or with FinkCommander,

menu "Source -> selfupdate-rsync" and
menu "Source -> Update-all


-------------------------INSTALLING LILYPOND---------------------------------

5) STABLE-UNSTABLE TREE


To enable unstable tree and use the developers version, with a text editor edit /sw/etc/fink.conf
and add "unstable/crypto unstable/main" to the "Trees" line.
You need to open it with administrator privileges. Ex "sudo pico /sw/etc/fink.conf

>From FinkCommander's preferences -> Fink, you can enable unstable and crypto packages.

6) INSTALL LILYPOND

>From the terminal, type "fink install lilypond" or "fink install lilypond-unstable" if you 
want to use developer version.
Fink will install also libraries and other software required

After the download, starts the compilation stage: at the first 
installation on lilypond it can takes quite long time it depends on the 
machine. It can be one hour or more. During this step you 
can continue to work on your computer, even if it will be a little slower 
(at least on my g3 800 laptop).

At the end of this stage a message within the terminal will inform you 
that lilypond has been succesfully installed.

7) FIRST TEST

a) Open TextEdit
b) Check uf the new file is called "untitled.txt" otherwhise go to 
Preferences and seslct the "text only" feature, and uncheck the options 
"Append .txt extension to plain text files".
In the image, you can see how your preferences should appear.
This is because lilypond need text only file (usually they are with the 
extension .txt) but with the .ly extension.
c) Write the following line:

{ c'4 e' g' }

d) save it to the desktop with the name foo.ly
e) Open the terminal and type: lilypond Desktop/foo.ly and press enter
f) After the process is finished, go to your desktop and you will find various 
"foo" files with different extension.
g) Double-click the foo.pdf file and you will see the music.

8) HOW TO GET HELP

Help in Lilypond is provided by the Lilypond-user mailing list.

a) Before to send an e-mail, try to find an answer looking inside the mailing-list-archive,
maybe another user had the same problem,
b) Search the Lilypond and the Fink documentations,
c) Search with Google,
d) If nothing helped you, send an e-mail to the lilypond-user mailing list! In the message,
please remember to put wich machine you are using, wich is your operative system, and
wich version of Lilypond you are using.
To check the version, type in the terminal: "lilypond -v" and press enter.

-------------------------------------------------------------------------------------