@@ -140,7 +140,42 @@
* The maintainers are listed in the MAINTAINERS file at the top of the Xen source tree. If no maintainer is listed then there is no need for a CC (if you are modifying code with no maintainer then you might like to consider becoming the maintainer for that piece of code!).
** You can pipe your patch to the <code>./scripts/get_maintainer.pl</code> tool and it will list the relevant maintainers.
* In addition to CCing the maintainer you should always send patches to (via TO) the xen-devel@lists.xenproject.org mailing list as well.
-* To add a CC when sending the mail you can use the ''--cc'' option to the ''git send-email'' command, or you can do it manually in your MUA.
+* To add a CC when sending the mail you can:
+ * use the ''--cc'' option to the ''git send-email'' command - however if your
+ patchset is to multiple maintainers - you may end up sending all of the
+ patches to all maintainers - where some of them have no interest in
+ viewing them (as they are not under their responsibility)
+ * edit each patch to have the proper maintainer on the CC list by adding:
+<pre>
+---
+CC: joe@example.com
+---
+</pre>
+ in the patch. The ''---'' means that when the patch is applied the text
+in between them is discarded.
+ * or alternatively use --cc-cmd in your .gitconfig or git-send-email:
+<pre>
+[sendemail]
+ cc-cmd = scripts/get_maintainer.pl --no-l
+</pre>
+or:
+<pre>
+git send-email --cc-cmd="scripts/get_maintainer.pl
+</pre>
+which will automatically add the proper maintainer on the CC line.
+The ''no-l'' is to not add the mailing list to the CC (as you would
+be adding that via the TO - see above)
+ * or you can do it manually in your MUA.
+
+In short, it could look like this:
+<pre>
+$pwd
+/home/joe/xen
+git send-email --cc-cmd="scripts/get_maintainer.pl --no-l --to xen-devel@lists.xenproject.org --to jo@example.com --compose --subject "[PATCH v1] Fixes to frobnicator." *.patch
+</pre>
+
+Which will send all patches to yourself on the TO, to xen-devel mailiing list (on the TO:)
+and the patches will have their CC: list generated based on scripts/get_maintainer.pl.
=== Providing a git branch ===