annotate extra/README @ 397:09fe7c40a082 3.0-beta1

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