diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml
index d939b44c54..6d5650ae05 100644
--- a/documentation/dev-manual/dev-manual-newbie.xml
+++ b/documentation/dev-manual/dev-manual-newbie.xml
@@ -1439,16 +1439,16 @@
You can submit patches without using the create-pull-request and
send-pull-request scripts described in the previous section.
- Keep in mind, the preferred method is to use the scripts, however.
+ However, keep in mind, the preferred method is to use the scripts.
Depending on the components changed, you need to submit the email to a specific
mailing list.
For some guidance on which mailing list to use, see the list in the
- "How to Submit a Change" section
- earlier in this manual.
- For a description of the available mailing lists, see
+ "How to Submit a Change"
+ section.
+ For a description of the available mailing lists, see the
"Mailing Lists"
section in the Yocto Project Reference Manual.
@@ -1465,7 +1465,7 @@
Using the --signoff option identifies you as the person
making the change and also satisfies the Developer's Certificate of
Origin (DCO) shown earlier.
- When you form a commit you must follow certain standards established by the
+ When you form a commit, you must follow certain standards established by the
Yocto Project development team.
See the earlier section
"How to Submit a Change"
@@ -1474,17 +1474,21 @@
To format commits, use the git format-patch command.
When you provide the command, you must include a revision list or a number of patches
as part of the command.
- For example, these two commands each take the most recent single commit and
- format it as an email message in the current directory:
+ For example, either of these two commands takes your most
+ recent single commit and formats it as an email message in
+ the current directory:
$ git format-patch -1
+
+ or
+
$ git format-patch HEAD~
After the command is run, the current directory contains a
numbered .patch file for the commit.If you provide several commits as part of the command,
- the git format-patch command produces a numbered
- series of files in the current directory – one for each commit.
+ the git format-patch command produces a
+ series of numbered files in the current directory – one for each commit.
If you have more than one patch, you should also use the
--cover option with the command, which generates a
cover letter as the first "patch" in the series.
@@ -1520,7 +1524,9 @@
The command also has several options that let you
specify recipients and perform further editing of the email message.
For information on how to use the git send-email command,
- use the man git-send-email command.
+ see GIT-SEND-EMAIL(1) displayed using
+ the man git-send-email command.
+