annotate extra/README @ 264:61d1db1dfe2a 2.6

Build manual for release
author lost
date Tue, 22 Dec 2009 05:27:32 +0000
parents b34071013404
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
179
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
1 These files are extra utility type scripts that can be used for various
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
2 purposes.
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
3
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
4 as
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
5
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
6 This is a sort of front-end script that makes lwasm look approximately like
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
7 gnu as which is useful for using lwasm as a backend to gcc. You will
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
8 probably need to edit it to make it work fully. Simply put this in place
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
9 of whatever gcc6809 installed for "as" (in the "m6809/bin" folder in
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
10 "--prefix") after editing it to point to the real location of the "lwasm"
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
11 binary.
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
12
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
13
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
14 ld
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
15
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
16 Similar to the "as" script above except for lwlink.
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
17
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
18
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
19 ar
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
20
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
21 Similar to the "as" script above except for lwar.
3711cd1c01e2 Added as front-end script for use with gcc6809
lost
parents:
diff changeset
22
208
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
23
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
24 To use these scripts, you really need to understand how to build a gcc as a
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
25 cross compiler. The basics are that you put the as, ld, and ar scripts
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
26 whereever you plan to put your cross-development binaries. Then, when
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
27 building the cross compiler, you tell it where the scripts are.
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
28
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
29 You should probably name them m6809-unknown-none-{ar,as,ld} or similar
249
b34071013404 Updated hint for using gcc6809
lost
parents: 208
diff changeset
30 depending on your gcc build target. You will probably need to ensure that
b34071013404 Updated hint for using gcc6809
lost
parents: 208
diff changeset
31 the m6809-* binaries are in your execution path. Then you'll want to get
b34071013404 Updated hint for using gcc6809
lost
parents: 208
diff changeset
32 the gcc6809 patch and patch the correct gcc source code. Then use a
b34071013404 Updated hint for using gcc6809
lost
parents: 208
diff changeset
33 configure line similar to the following:
208
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
34
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
35 configure --enable-languages=c --target=m6809-coco
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
36 --program-prefix=m6809-coco-lwos- --enable-obsolete
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
37 --srcdir=/home/lost/gcc6809/src/gcc-4.3.3 --disable-threads --disable-nls
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
38 --disable-libssp --prefix=/usr/local/coco --with-as=/usr/local/coco/bin/as
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
39 --with-ld=/usr/local/coco/bin/ld --with-sysroot=/usr/local/coco
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
40
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
41 Obviously adjust various paths to match what you're doing.
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
42
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
43 The exact mechanics of configuring and getting gcc to install correctly is
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
44 left as an exercise to the dedicated masochist.