author | "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr> |
Sun Sep 06 17:58:05 2009 +0200 (2009-09-06) | |
changeset 1518 | ecf0e1c4f2f2 |
parent 1466 | 1bacd35b57e6 |
child 1546 | 61e8ce6419f4 |
permissions | -rw-r--r-- |
yann@1 | 1 |
This is the README for crosstool-NG |
yann@1 | 2 |
|
yann@1465 | 3 |
TABLE OF CONTENT / |
yann@1465 | 4 |
________________/ |
yann@1465 | 5 |
|
yann@1465 | 6 |
- GETTING STARTED |
yann@1465 | 7 |
- PARTICIPATING |
yann@1465 | 8 |
- Sending a bug report |
yann@1465 | 9 |
- Sending patches |
yann@1465 | 10 |
- CREDITS |
yann@1465 | 11 |
- KNOWN ISSUES |
yann@1465 | 12 |
|
yann@1465 | 13 |
|
yann@1465 | 14 |
GETTING STARTED / |
yann@1465 | 15 |
_______________/ |
yann@1465 | 16 |
|
yann@88 | 17 |
To get you started, just enter: |
yann@185 | 18 |
./configure --help |
yann@1 | 19 |
|
yann@185 | 20 |
You can find a (terse and WIP) documentation in docs/overview.txt. |
yann@1 | 21 |
|
yann@1 | 22 |
You can also point your browser to |
yann@1463 | 23 |
http://ymorin.is-a-geek.org/projects/crosstool |
yann@96 | 24 |
|
yann@1465 | 25 |
PARTICIPATING / |
yann@1465 | 26 |
_____________/ |
yann@1465 | 27 |
|
yann@1465 | 28 |
Sending a bug report |
yann@1465 | 29 |
-------------------- |
yann@1465 | 30 |
|
yann@1465 | 31 |
If you need to send a bug report, please send a mail with subject |
yann@1490 | 32 |
prefixed with "[CT_NG]" with to following destinations: |
yann@1490 | 33 |
TO: yann.morin.1998 (at) anciens.enib.fr |
yann@1490 | 34 |
CC: crossgcc (at) sourceware.org |
yann@1465 | 35 |
|
yann@1465 | 36 |
Sending patches |
yann@1465 | 37 |
--------------- |
yann@1465 | 38 |
|
yann@1335 | 39 |
If you want to enhance crosstool-NG, there's a to-do list in the TODO file. |
yann@1335 | 40 |
|
yann@1348 | 41 |
Patches should come with the appropriate SoB line. A SoB line is typically |
yann@1490 | 42 |
something like: |
yann@1465 | 43 |
Signed-off-by: John DOE <john.doe@somewhere.net> |
yann@1348 | 44 |
|
yann@1348 | 45 |
The SoB line is clearly described in Documentation/SubmittingPatches , section |
yann@1348 | 46 |
12, of your favourite Linux kernel source tree. |
yann@1348 | 47 |
|
yann@1466 | 48 |
Then you'll need to correctly configure Mercurial. There are two extensions |
yann@1466 | 49 |
that you may find usefull: |
yann@1466 | 50 |
- mq : http://mercurial.selenic.com/wiki/MqExtension |
yann@1466 | 51 |
- patchbomb : http://mercurial.selenic.com/wiki/PatchbombExtension |
yann@1466 | 52 |
|
yann@1466 | 53 |
Here's a typical hacking session: |
yann@1466 | 54 |
hg clone http://ymorin.is-a-geek.org/hg/crosstool-ng crosstool-ng |
yann@1466 | 55 |
cd crosstool-ng |
yann@1466 | 56 |
hg qinit |
yann@1466 | 57 |
hg qnew -D -U -e my_first_patch |
yann@1466 | 58 |
*edit patch description* |
yann@1466 | 59 |
*hack* *hack* *check* *fails* *hack* *hack* *check* *works* |
yann@1466 | 60 |
hg qref -D -e |
yann@1466 | 61 |
*edit patch description, serving as commit message* |
yann@1466 | 62 |
hg qnew -D -U -e my_second_patch |
yann@1466 | 63 |
*edit patch description* |
yann@1466 | 64 |
*hack* *hack* *check* *fails* *hack* *hack* *check* *works* |
yann@1466 | 65 |
hg qref -D -e |
yann@1466 | 66 |
*edit patch description, serving as commit message* |
yann@1466 | 67 |
hg email --outgoing --intro \ |
yann@1466 | 68 |
--from '"Your Full NAME" <your.email (at) your.domain>' \ |
yann@1466 | 69 |
--to '"Yann E. MORIN" <yann.morin.1998 (at) anciens.enib.fr>' \ |
yann@1466 | 70 |
--cc 'crossgcc (at) sourceware.org' |
yann@1466 | 71 |
*edit introductory message* |
yann@1466 | 72 |
*wait for feedback* |
yann@1466 | 73 |
*re-send if no answer for a few days* |
yann@1466 | 74 |
|
yann@1466 | 75 |
Note: replace' (at) ' above with a plain '@'. |
yann@1466 | 76 |
|
yann@1465 | 77 |
CREDITS / |
yann@1465 | 78 |
_______/ |
yann@1465 | 79 |
|
yann@386 | 80 |
The people that helped are listed in docs/CREDITS. Many thanks to them! :-) |
yann@185 | 81 |
|
yann@1465 | 82 |
KNOWN ISSUES / |
yann@1465 | 83 |
____________/ |
yann@1465 | 84 |
|
yann@908 | 85 |
The list of known issues is listed in docs/known-issues.txt. |
yann@817 | 86 |
|
yann@185 | 87 |
Aloha! |