From: me@tobin.cc (Tobin C. Harding)
To: kernelnewbies@lists.kernelnewbies.org
Subject: english grammar and patches
Date: Wed, 26 Apr 2017 10:27:00 +1000 [thread overview]
Message-ID: <20170426002700.GA5707@eros> (raw)
This question relates to English grammar and correct usage when
writing gitlog messages and patch series cover letters.
The writing of gitlog messages is covered in submitting-patches.rst,
of note is the mood to use. It is not stated but I think it is
a subjunctive description of the problem being addressed followed by
an imperative description of what is being done in the patch. Please
correct me if I am wrong.
The question is: what mood to use in the cover letter. Also, is the
subject of the cover letter explicit or implicit? Said another way is
it acceptable to say 'this series' within the cover letter? It is
specifically stated not to use the subject within the patch itself,
however, many patch sets on LKML use the subject in the cover letter.
Finally, has anyone, within easy reach, a link to a canonical patch
set cover letter. I have searched LKML but am unable to judge for
myself. I would like to add a link to the kernel newbies wiki also if
one is available.
thanks,
Tobin.
next reply other threads:[~2017-04-26 0:27 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-04-26 0:27 Tobin C. Harding [this message]
2017-04-26 1:25 ` english grammar and patches valdis.kletnieks at vt.edu
2017-04-26 4:34 ` Greg KH
2017-04-26 6:05 ` Tobin C. Harding
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20170426002700.GA5707@eros \
--to=me@tobin.cc \
--cc=kernelnewbies@lists.kernelnewbies.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
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).