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 <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  /