diff options
| author | Yann E. MORIN" <yann.morin.1998@anciens.enib.fr> | 2009-10-10 12:55:17 +0200 |
|---|---|---|
| committer | Yann E. MORIN" <yann.morin.1998@anciens.enib.fr> | 2009-10-10 12:55:17 +0200 |
| commit | 632d59babdc692e6e669310a7564777ce59bdb5d (patch) | |
| tree | 3af876fb4ca4b24e3bbbcbeeb99198ca3e0edeba /docs | |
| parent | 3902827e9fa5f231baf65596b8e6e40296cd7b61 (diff) | |
| download | crosstool-ng-632d59babdc692e6e669310a7564777ce59bdb5d.tar.gz crosstool-ng-632d59babdc692e6e669310a7564777ce59bdb5d.tar.bz2 crosstool-ng-632d59babdc692e6e669310a7564777ce59bdb5d.zip | |
docs: move the "contributing" section to overview.txt
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/overview.txt | 74 |
1 files changed, 72 insertions, 2 deletions
diff --git a/docs/overview.txt b/docs/overview.txt index c7afdab9..7034d55e 100644 --- a/docs/overview.txt +++ b/docs/overview.txt @@ -30,6 +30,9 @@ Using the toolchain 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 @@ Stay in the directory holding the sources, and run: 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 @@ used by the cross-compiler it is going to build. The problem seems to arise 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 <john.doe@somewhere.net> + +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" <your.email (at) your.domain>' \ + --to '"Yann E. MORIN" <yann.morin.1998 (at) anciens.enib.fr>' \ + --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 / |