* .version, sdcc.spec, doc/sdccman.lyx, doc/INSTALL.txt:
[fw/sdcc] / doc / INSTALL.txt
1 SDCC Binary Kit Install Help
2 ----------------------------
3
4 For Linux users:
5 ================
6 To install:
7
8 * Extract the binary kit to a temporary directory.
9   This will create a new directory called 'sdcc' in the temporary directory.
10     cd ~
11     mkdir tmp
12     cd tmp
13     tar xjf path/to/binary/kit/sdcc-2.9.0-i386-unknown-linux2.5.tar.bz2
14
15 * Change to the sdcc directory and copy all files to /usr/local
16     cd sdcc
17     cp -r * /usr/local
18
19 This will install sdcc binaries into: /usr/local/bin/
20 header files into:                    /usr/local/share/sdcc/include/
21 library files into:                   /usr/local/share/sdcc/lib/
22 and documentation into:               /usr/local/share/sdcc/doc/
23
24 You can test the install by entering:
25     /usr/local/bin/sdcc -v
26
27 This should return sdcc's version number.
28
29 Even if the default search paths look into /usr/local, sdcc is fully
30 relocatable. Try `sdcc --print-search-dirs` if you have problems with header
31 or library files. See sdccman.[txt|pdf|html] for more detailed information.
32
33
34 For Windows 9X/NT/2000/XP users:
35 ================================
36 To install:
37
38 * If you would like to keep a copy of your previous version,
39   rename the directory where it's installed first
40 * Run sdcc-2.9.0-setup.exe
41
42 By default this will install sdcc binaries into: C:\Program Files\SDCC\bin\
43 header files into:                               C:\Program Files\SDCC\include\
44 library files into:                              C:\Program Files\SDCC\lib\
45 and documentation into:                          C:\Program Files\SDCC\doc\
46
47 You can test the install by opening a DOS box and entering:
48     sdcc -v
49
50 This should return sdcc's version number.
51
52 sdcc for win32 is fully relocatable. Try `sdcc --print-search-dirs` if you
53 have problems with header or library files. See sdccman.[txt|pdf|html] for
54 more detailed information.
55
56
57 For Mac OS X users:
58 ===================
59 To install:
60
61 * Extract the binary kit to a temporary directory.
62   This will create a new directory called 'sdcc' in the temporary directory.
63     cd ~
64     mkdir tmp
65     cd tmp
66     tar xjf path/to/binary/kit/sdcc-2.9.0-universal-apple-macosx.tar.bz2
67
68 * Change to the sdcc directory and copy all files to /Developer/sdcc
69     cp -r sdcc /Developer/sdcc
70
71 This will install sdcc binaries into: /Developer/sdcc/bin/
72 header files into:                    /Developer/sdcc/share/sdcc/include/
73 library files into:                   /Developer/sdcc/share/sdcc/lib/
74 and documentation into:               /Developer/sdcc/share/sdcc/doc/
75
76 You can test the install by entering:
77     /Developer/sdcc/bin/sdcc -v
78
79 This should return sdcc's version number.
80
81 Even if the default search paths look into /usr/local, sdcc is fully
82 relocatable. Try `sdcc --print-search-dirs` if you have problems with header
83 or library files. See sdccman.[txt|pdf|html] for more detailed information.