* Revised [PATCH] Documentation: Update to SubmittingPatches
@ 2005-12-20 21:43 Ian McDonald
2006-01-11 0:57 ` Adrian Bunk
0 siblings, 1 reply; 5+ messages in thread
From: Ian McDonald @ 2005-12-20 21:43 UTC (permalink / raw)
To: Linux Kernel Mailing List; +Cc: trivial, Andrew Morton, Linus Torvalds
Updated documentation for submitting patches taking account of git.
Signed-off-by: Ian McDonald <imcdnzl@gmail.com>
---
diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches
index 237d54c..8756475 100644
--- a/Documentation/SubmittingPatches
+++ b/Documentation/SubmittingPatches
@@ -20,10 +20,24 @@ SECTION 1 - CREATING AND SENDING YOUR CH
-1) "diff -up"
-------------
+1) Creating a diff file
+-----------------------
-Use "diff -up" or "diff -uprN" to create patches.
+You can use git-diff(1) or git-format-patch(1) which makes your life easy. If
+you want it to be more difficult then carry on reading.
+
+Make sure your patch does not include any extra files which do not
+belong in a patch submission. Make sure to review your patch -after-
+generated it with diff(1), to ensure accuracy.
+
+If your changes produce a lot of deltas, you may want to look into
+splitting them into individual patches which modify things in
+logical stages. This will facilitate easier reviewing by other
+kernel developers, very important if you want your patch accepted.
+There are a number of scripts which can aid in this:
+
+Use "diff -up" or "diff -uprN" to create patches
+------------------------------------------------
All changes to the Linux kernel occur in the form of patches, as
generated by diff(1). When creating your patch, make sure to create it
@@ -61,16 +75,6 @@ patch. The "dontdiff" file is included
2.6.12 and later. For earlier kernel versions, you can get it
from <http://www.xenotime.net/linux/doc/dontdiff>.
-Make sure your patch does not include any extra files which do not
-belong in a patch submission. Make sure to review your patch -after-
-generated it with diff(1), to ensure accuracy.
-
-If your changes produce a lot of deltas, you may want to look into
-splitting them into individual patches which modify things in
-logical stages. This will facilitate easier reviewing by other
-kernel developers, very important if you want your patch accepted.
-There are a number of scripts which can aid in this:
-
Quilt:
http://savannah.nongnu.org/projects/quilt
^ permalink raw reply related [flat|nested] 5+ messages in thread
* Re: Revised [PATCH] Documentation: Update to SubmittingPatches
2005-12-20 21:43 Revised [PATCH] Documentation: Update to SubmittingPatches Ian McDonald
@ 2006-01-11 0:57 ` Adrian Bunk
[not found] ` <46118.10.10.10.28.1136943503.squirrel@linux1>
0 siblings, 1 reply; 5+ messages in thread
From: Adrian Bunk @ 2006-01-11 0:57 UTC (permalink / raw)
To: Ian McDonald
Cc: Linux Kernel Mailing List, trivial, Andrew Morton, Linus Torvalds
On Wed, Dec 21, 2005 at 10:43:40AM +1300, Ian McDonald wrote:
> Updated documentation for submitting patches taking account of git.
>
> Signed-off-by: Ian McDonald <imcdnzl@gmail.com>
> ---
> diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches
> index 237d54c..8756475 100644
> --- a/Documentation/SubmittingPatches
> +++ b/Documentation/SubmittingPatches
> @@ -20,10 +20,24 @@ SECTION 1 - CREATING AND SENDING YOUR CH
>
>
>
> -1) "diff -up"
> -------------
> +1) Creating a diff file
> +-----------------------
>
> -Use "diff -up" or "diff -uprN" to create patches.
> +You can use git-diff(1) or git-format-patch(1) which makes your life easy. If
> +you want it to be more difficult then carry on reading.
>...
IMHO, this doesn't make much sense:
The average patch submitter does _not_ use git in any way - and there's
no reason why he should.
cu
Adrian
--
"Is there not promise of rain?" Ling Tan asked suddenly out
of the darkness. There had been need of rain for many days.
"Only a promise," Lao Er said.
Pearl S. Buck - Dragon Seed
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2006-01-12 2:22 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2005-12-20 21:43 Revised [PATCH] Documentation: Update to SubmittingPatches Ian McDonald
2006-01-11 0:57 ` Adrian Bunk
[not found] ` <46118.10.10.10.28.1136943503.squirrel@linux1>
2006-01-11 1:38 ` Sean
2006-01-12 2:22 ` Junio C Hamano
2006-01-11 1:54 ` Adrian Bunk
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).