Every so often, I search 'git send-email --help' to remember some
option I've used in the past, only to discover that the option is
documented instead in 'git format-patch --help'. Worse, even that
command didn't document the option I was looking for today, which
was how to include 'git notes' in the body of the commits I was
mailing. Reading 'git notes --help' didn't mention this either,
and I had to resort to searching the source code. It can't hurt
to add some documentation to make this option less obscure.
* git-notes.txt: Mention that --notes option exists in many
commands to override defaults.
* git-format-patch.txt: Include pretty-options, for things like
* git-send-email.txt: Mention that revision lists forwarded to
format-patch can also include options.
Signed-off-by: Eric Blake <ebl...@redhat.com>
Documentation/git-format-patch.txt | 2 ++
Documentation/git-notes.txt | 6 ++++--
Documentation/git-send-email.txt | 3 ++-
3 files changed, 8 insertions(+), 3 deletions(-)
diff --git a/Documentation/git-format-patch.txt
index 6d43f56..a068f37 100644
@@ -222,6 +222,8 @@ you can use `--suffix=-patch` to get
range are always formatted as creation patches, independently
of this flag.
You can specify extra mail header lines to be added to each message,
diff --git a/Documentation/git-notes.txt b/Documentation/git-notes.txt
index b95aafa..be9e60f 100644
@@ -39,8 +39,10 @@ message stored in the commit object, the notes are indented
message, after an unindented line saying "Notes (<refname>):" (or
"Notes:" for `refs/notes/commits`).
-To change which notes are shown by 'git log', see the
-"notes.displayRef" configuration in linkgit:git-log.
+To change which notes are shown by default in 'git log', see the
+"notes.displayRef" configuration in linkgit:git-log. Also,
+many commands understand a `--notes` option to alter the set of
+notes displayed (see linkgit:git-rev-list).
See the "notes.rewrite.<command>" configuration for a way to carry
notes across commands that rewrite commits.
diff --git a/Documentation/git-send-email.txt b/Documentation/git-send-email.txt
index eeb561c..450d975 100644
@@ -18,7 +18,8 @@ Takes the patches given on the command line and emails them
Patches can be specified as files, directories (which will send all
files in the directory), or directly as a revision list. In the
last case, any format accepted by linkgit:git-format-patch can
-be passed to git send-email.
+be passed to git send-email, including additional command line
+options such as `--cover-letter` or `--notes`.
The header of the email is configurable by command line options. If not
specified on the command line, the user will be prompted with a ReadLine
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majord...@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html