[PATCH] Documentation/git-format-patch.txt: fix weird backslash at --root

Subsystems: the rest

DORMANTno replies

3 messages, 2 authors, 2016-06-15 · open the first message on its own page

[PATCH] Documentation/git-format-patch.txt: fix weird backslash at --root

From: <hidden>
Date: 2016-06-15 22:45:50

However note --root is not mentioned in SYNOPSIS nor on its own line.
Also fixed grammar.

Signed-off-by: jidanni <redacted>
diff --git a/git-format-patch.txt b/git-format-patch.txt
index ee27eff..51c25cd 100644
--- a/git-format-patch.txt
+++ b/git-format-patch.txt
@@ -48 +48 @@ everything since project inception to one commit, say "git
-format-patch \--root <commit>" to make it clear that it is the
+format-patch --root <commit>" to make it clear that it is the
@@ -166 +166 @@ not add any suffix.
-	that they differ.  Note that this disable the patch to be properly
+	that they differ.  Note that this disables the patch from being properly
@@ -209 +209 @@ project:
-$ git format-patch \--root origin
+$ git format-patch --root origin
-- 
1.5.6.5

Re: [PATCH] Documentation/git-format-patch.txt: fix weird backslash at --root

From: Junio C Hamano <hidden>
Date: 2016-06-15 22:45:50

jidanni@jidanni.org writes:
quoted hunk
@@ -209 +209 @@ project:
-$ git format-patch \--root origin
+$ git format-patch --root origin
I thought these backslashes before double-dash are protecting the latter
from being turned into em-dashes.  I do not see any weird backslash in the
"git help" (aka "manpage") output nor in the HTML documentation, e.g.

    http://www.kernel.org/pub/software/scm/git/docs/git-format-patch.html

without your patch, so I have to say that this chunk is a useless churn.

All of your three patches lack context, which is essential enabler for
easier review.  They have "diff --git" header, but are not made relative
to the root of the project tree (i.e. lack "Documentation/" prefix), which
is the norm for both the tool and for this project and this mailing list.

I guess that you may be experimenting with various options to see how they
work, and the curiosity by itself is a good thing, but please do not make
other people suffer with results from such experiments by sending patches
in nonstandard forms.

By submitting a patch to try improving the system, you are already making
a difference in substance.  Please do not try to be creative in form.  It
only makes lives of other people unnecessarily harder with no real reason
and wastes other people's time.  And it wastes yours, too.  A patch
conforming to the norm is much easier to review, comment on and apply.
Ok?

"Don't try to be different in form, make a difference in substance" also
applies to your S-o-b line, by the way.

Re: [PATCH] Documentation/git-format-patch.txt: fix weird backslash at --root

From: <hidden>
Date: 2016-06-15 22:45:50

JCH> http://www.kernel.org/pub/software/scm/git/docs/git-format-patch.html
That looks OK. All I know is on Debian (1:1.5.6.5-2) it gets rendered:
$ w3m -dump /usr/share/doc/git-doc/git-format-patch.html|fgrep \\-
    $ git format-patch \--root origin

I was patching offline from Debian. OK, in the future I will clone
upstream directly properly first.
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help