# HG changeset patch # User "Yann E. MORIN" # Date 1255172117 -7200 # Node ID eb92c99b17cd74ce27c88d4fbd39b87de1c3da76 # Parent 07684767f87335e0ffb989e81871d074a6eb0946 docs: move the "contributing" section to overview.txt diff -r 07684767f873 -r eb92c99b17cd README --- a/README Sat Oct 10 11:24:31 2009 +0200 +++ b/README Sat Oct 10 12:55:17 2009 +0200 @@ -4,9 +4,6 @@ ________________/ - GETTING STARTED - - CONTRIBUTING - - Sending a bug report - - Sending patches - CREDITS - KNOWN ISSUES @@ -18,77 +15,21 @@ ./configure --help You can find a (terse and WIP) documentation in docs/overview.txt. +Here's a summary of what you'll find in there: + Introduction + History + Installing crosstool-NG + Configuring crosstool-NG + Running crosstool-NG + Using the toolchain + Toolchain types + Contributing + Internals -You can also point your browser to +You can also point your browser at: http://ymorin.is-a-geek.org/projects/crosstool -CONTRIBUTING / -____________/ - -Sending a bug report --------------------- - -If you need to send a bug report, please send a mail with subject -prefixed with "[CT_NG]" with to following destinations: - TO: yann.morin.1998 (at) anciens.enib.fr - CC: crossgcc (at) sourceware.org - -Sending patches ---------------- - -If you want to enhance crosstool-NG, there's a to-do list in the TODO file. - -Patches should come with the appropriate SoB line. A SoB line is typically -something like: - Signed-off-by: John DOE - -The SoB line is clearly described in Documentation/SubmittingPatches , section -12, of your favourite Linux kernel source tree. - -Then you'll need to correctly configure Mercurial. There are two extensions -that you may find usefull: - - mq : http://mercurial.selenic.com/wiki/MqExtension - - patchbomb : http://mercurial.selenic.com/wiki/PatchbombExtension - -Commit messages should look like (without leading pipes): - |component: short, one-line description - | - |optional longer description - |on multiple lines if needed - -Here is an example commit message (see revision a53a5e1d61db): - |comp-libs/cloog: fix building - | - |For CLooG/PPL 0.15.3, the directory name was simply cloog-ppl. - |For any later versions, the directory name does have the version, such as - |cloog-ppl-0.15.4. - -Here's a typical hacking session: - hg clone http://ymorin.is-a-geek.org/hg/crosstool-ng crosstool-ng - cd crosstool-ng - hg qinit - hg qnew -D -U -e my_first_patch - *edit patch description* - *hack* *hack* *check* *fails* *hack* *hack* *check* *works* - hg qref -D -e - *edit patch description, serving as commit message* - hg qnew -D -U -e my_second_patch - *edit patch description* - *hack* *hack* *check* *fails* *hack* *hack* *check* *works* - hg qref -D -e - *edit patch description, serving as commit message* - hg email --outgoing --intro \ - --from '"Your Full NAME" ' \ - --to '"Yann E. MORIN" ' \ - --cc 'crossgcc (at) sourceware.org' - *edit introductory message* - *wait for feedback* - *re-send if no answer for a few days* - -Note: replace' (at) ' above with a plain '@'. - - CREDITS / _______/ diff -r 07684767f873 -r eb92c99b17cd docs/overview.txt --- a/docs/overview.txt Sat Oct 10 11:24:31 2009 +0200 +++ b/docs/overview.txt Sat Oct 10 12:55:17 2009 +0200 @@ -30,6 +30,9 @@ The 'populate' script Toolchain types Seemingly-native toolchains +Contributing + Sending a bug report + Sending patches Internals Makefile front-end Kconfig parser @@ -157,8 +160,7 @@ See below for complete usage. Now, provided you used a clone of the repository, you can send me your changes. -See the file README, at the top of crosstool-NG source, for how to submit -changees. +See the section titled CONTRIBUTING, below, for how to submit changees. Preparing for packaging | ------------------------+ @@ -597,6 +599,74 @@ only with glibc (and eglibc?) starting with version 2.7. +________________ + / +Contributing / +_____________/ + +Sending a bug report | +---------------------+ + +If you need to send a bug report, please send a mail with subject +prefixed with "[CT_NG]" with to following destinations: + TO: yann.morin.1998 (at) anciens.enib.fr + CC: crossgcc (at) sourceware.org + +Sending patches | +----------------+ + +If you want to enhance crosstool-NG, there's a to-do list in the TODO file. + +Patches should come with the appropriate SoB line. A SoB line is typically +something like: + Signed-off-by: John DOE + +The SoB line is clearly described in Documentation/SubmittingPatches , section +12, of your favourite Linux kernel source tree. + +Then you'll need to correctly configure Mercurial. There are two extensions +that you may find usefull: + - mq : http://mercurial.selenic.com/wiki/MqExtension + - patchbomb : http://mercurial.selenic.com/wiki/PatchbombExtension + +Commit messages should look like (without leading pipes): + |component: short, one-line description + | + |optional longer description + |on multiple lines if needed + +Here is an example commit message (see revision a53a5e1d61db): + |comp-libs/cloog: fix building + | + |For CLooG/PPL 0.15.3, the directory name was simply cloog-ppl. + |For any later versions, the directory name does have the version, such as + |cloog-ppl-0.15.4. + +Here's a typical hacking session: + hg clone http://ymorin.is-a-geek.org/hg/crosstool-ng crosstool-ng + cd crosstool-ng + hg qinit + hg qnew -D -U -e my_first_patch + *edit patch description* + *hack* *hack* *check* *fails* *hack* *hack* *check* *works* + hg qref -D -e + *edit patch description, serving as commit message* + hg qnew -D -U -e my_second_patch + *edit patch description* + *hack* *hack* *check* *fails* *hack* *hack* *check* *works* + hg qref -D -e + *edit patch description, serving as commit message* + hg email --outgoing --intro \ + --from '"Your Full NAME" ' \ + --to '"Yann E. MORIN" ' \ + --cc 'crossgcc (at) sourceware.org' + *edit introductory message* + *wait for feedback* + *re-send if no answer for a few days* + +Note: replace '(at)' above with a plain '@'. + + _____________ / Internals /