annotate extra/README @ 231:10abe422efce

Documented the --6309 and --6809 options
author lost
date Fri, 12 Jun 2009 03:23:41 +0000
parents 06effa2faea1
children b34071013404
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
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
30 depending on your gcc build target. Then you'll want to get the gcc6809
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
31 patch and patch the correct gcc source code. Then use a configure line
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
32 similar to the following:
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
33
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
34 configure --enable-languages=c --target=m6809-coco
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
35 --program-prefix=m6809-coco-lwos- --enable-obsolete
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
36 --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
37 --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
38 --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
39
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
40 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
41
06effa2faea1 Added some info on building gcc6809 to use lwtools
lost
parents: 179
diff changeset
42 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
43 left as an exercise to the dedicated masochist.