public inbox for gcc@gcc.gnu.org
 help / color / mirror / Atom feed
* Commit messages and the move to git
@ 2019-11-04 10:29 Richard Earnshaw (lists)
  2019-11-04 12:11 ` Arnaud Charlet
                   ` (4 more replies)
  0 siblings, 5 replies; 139+ messages in thread
From: Richard Earnshaw (lists) @ 2019-11-04 10:29 UTC (permalink / raw)
  To: GCC Development

With the move to git fairly imminent now it would be nice if we could 
agree on a more git-friendly style of commit messages; and, ideally, 
start using them now so that the converted repository can benefit from this.

Some tools, particularly gitk or git log --oneline, can use one-line 
summaries from a commit's log message when listing commits.  It would be 
nice if we could start adopting a style that is compatible with this, so 
that in future commits are summarized in a useful way.  Unfortunately, 
some of our existing commits show no useful information with tools like 
this.

Eg.

git log --oneline
2b70dbd64b5 (HEAD -> master, origin/trunk, origin/master, origin/HEAD) 
2019-11-01  Kewen Lin  <linkw@gcc.gnu.org>
29f4f5f13b9 [C++ PATCH] cleanup check_field_decls
0f931fb75ae 2019-11-01  Kewen Lin  <linkw@gcc.gnu.org>
e9c4da22199 OpenMP] use_device_addr/use_device_ptr with Fortran 
allocatable/pointer arrays
377311a90fa 2019-11-01  Kewen Lin  <linkw@gcc.gnu.org>
cc286dd8517 Daily bump.
8e87e30df8d Regenerate libstdc++ HTML docs
fad04d507e0 Add remaining changes from P1065R2 "constexpr INVOKE"
d5e4b5a17de Partial implementation of C++20 of <ranges> header
345d712f776 Test --help=common for full sentences
a737cc23c15     PR preprocessor/92296   * internal.h (struct 
def_pragma_macro): Add is_builtin bitfield. 
(_cpp_restore_special_builtin): Declare.        * init.c 
(_cpp_restore_special_builtin): New function.  * directives.c 
(do_pragma_push_macro): For NT_BUILTIN_MACRO     set is_builtin and 
don't try to grab definition.        (cpp_pop_definition): Use 
_cpp_restore_special_builtin to restore       builtin macros.
e9c843f92f6 2019-10-31  Jozef Lawrynowicz  <jozef.l@mittosystems.com>
d7069e154ee [AArch64] Fix g++.target/aarch64/sve/vcond_1_run.C
ae5f034c085 [AArch64] Split gcc.target/aarch64/sve/vcond_4*

As you can see, some of these are useful and give a good summary of the 
patch, others only tell me who committed the patch, which is less than 
useful.  In other cases almost the entire ChangeLog entry gets printed 
because there is no blank line to tell git where the end of the summary 
lies.

The normal convention in git is that the one line summary is essentially 
the subject line of the email message that describes the patch and is 
then followed by a blank line before the body of the commit message.

R.

^ permalink raw reply	[flat|nested] 139+ messages in thread

end of thread, other threads:[~2019-12-20 23:53 UTC | newest]

Thread overview: 139+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-11-04 10:29 Commit messages and the move to git Richard Earnshaw (lists)
2019-11-04 12:11 ` Arnaud Charlet
2019-11-04 12:43 ` Martin Jambor
2019-11-04 17:43   ` Segher Boessenkool
2019-11-04 16:04 ` Jeff Law
2019-11-04 16:18   ` Richard Earnshaw (lists)
2019-11-05 15:48   ` Richard Earnshaw
2019-11-07 14:27   ` Eric S. Raymond
2019-11-08 13:43     ` Richard Earnshaw (lists)
2019-11-09  6:01       ` Eric S. Raymond
2019-11-18 15:32         ` Richard Earnshaw (lists)
2019-11-18 15:55           ` Segher Boessenkool
2019-11-18 16:48             ` Richard Earnshaw (lists)
2019-11-18 17:11               ` Segher Boessenkool
     [not found]                 ` <8c32c288-e9e6-b01b-7911-3f186116da85@gmail.com>
2019-11-18 17:24                   ` Nicholas Krause
2019-11-18 17:26                     ` Nicholas Krause
2019-11-18 17:46                       ` Richard Earnshaw (lists)
2019-11-18 17:49                         ` Richard Earnshaw (lists)
2019-11-18 17:55                         ` Nicholas Krause
2019-11-18 18:05                           ` Richard Earnshaw (lists)
2019-11-18 18:24                             ` Joseph Myers
2019-11-19 11:26                               ` Eric S. Raymond
2019-11-19 11:25                             ` Eric S. Raymond
2019-11-19 11:46                               ` Richard Earnshaw (lists)
2019-11-19 19:32                                 ` Eric S. Raymond
2019-11-19 19:47                                   ` Richard Earnshaw (lists)
2019-11-19 19:49                                     ` Richard Earnshaw (lists)
2019-11-19 22:14                                     ` Eric S. Raymond
2019-11-19 22:19                                       ` Richard Earnshaw (lists)
2019-11-21 16:41                                       ` Joseph Myers
2019-11-21 16:52                                         ` Richard Earnshaw (lists)
2019-11-21 18:11                                           ` Eric S. Raymond
2019-11-21 18:09                                         ` Eric S. Raymond
2019-11-21 19:22                                         ` Richard Earnshaw (lists)
2019-11-19 19:43                                 ` Richard Earnshaw (lists)
2019-11-19 22:08                                   ` Eric S. Raymond
2019-11-18 17:38                 ` Richard Earnshaw (lists)
2019-11-18 18:53                   ` Segher Boessenkool
2019-11-18 19:14                     ` Richard Earnshaw (lists)
2019-11-18 19:21                     ` Richard Earnshaw (lists)
2019-11-18 19:44                       ` Segher Boessenkool
2019-11-18 20:53                         ` Jason Merrill
2019-11-18 21:38                           ` Richard Earnshaw (lists)
2019-11-19 14:57                             ` Jason Merrill
2019-11-19 16:31                               ` Segher Boessenkool
2019-11-19 16:47                                 ` Jonathan Wakely
2019-11-19 16:48                                 ` Jason Merrill
2019-11-19 19:36                                   ` Eric S. Raymond
2019-11-19 23:29                                     ` Segher Boessenkool
2019-11-19 23:44                                       ` Joseph Myers
2019-11-19 23:51                                         ` Nicholas Krause
2019-11-20  8:55                                           ` Jonathan Wakely
2019-11-20 14:50                                         ` Szabolcs Nagy
2019-11-20 17:30                                         ` Richard Earnshaw (lists)
2019-11-20  8:58                                       ` Jonathan Wakely
2019-11-20 11:27                                         ` Segher Boessenkool
2019-11-20 11:30                                           ` Richard Earnshaw (lists)
2019-11-20 11:42                                             ` Segher Boessenkool
2019-11-20 14:25                                           ` Jason Merrill
2019-11-20 16:01                                             ` Segher Boessenkool
2019-11-19 16:49                                 ` Richard Earnshaw (lists)
2019-12-02 10:54                               ` Richard Earnshaw (lists)
2019-12-02 15:35                                 ` Segher Boessenkool
2019-12-02 16:19                                   ` Richard Earnshaw (lists)
2019-12-02 17:25                                     ` Segher Boessenkool
2019-12-02 17:47                                       ` Richard Earnshaw (lists)
2019-12-02 18:00                                         ` Segher Boessenkool
2019-12-02 18:11                                           ` Richard Earnshaw (lists)
2019-12-02 18:17                                           ` Eric S. Raymond
2019-12-02 20:24                                       ` Joseph Myers
2019-12-03  0:48                                         ` Segher Boessenkool
2019-12-03  9:44                                           ` Richard Earnshaw (lists)
2019-12-03 10:12                                             ` Richard Earnshaw (lists)
2019-12-02 20:22                                     ` Richard Sandiford
2019-12-04 23:52                                 ` Richard Earnshaw (lists)
2019-12-05 10:26                                   ` Jonathan Wakely
2019-12-05 10:32                                     ` Jonathan Wakely
2019-12-05 10:36                                       ` Richard Earnshaw (lists)
2019-12-05 10:41                                         ` Jonathan Wakely
2019-12-05 10:54                                           ` Jonathan Wakely
2019-12-05 13:18                                         ` Joseph Myers
2019-12-05 17:10                                           ` Eric S. Raymond
2019-12-05 17:22                                             ` Joseph Myers
2019-12-05 17:45                                               ` Eric S. Raymond
2019-12-05 20:14                                                 ` Joseph Myers
2019-12-05 20:46                                                   ` Joseph Myers
2019-12-05 21:14                                                     ` Eric S. Raymond
2019-12-05 21:13                                                   ` Eric S. Raymond
2019-12-05 15:33                                         ` Eric S. Raymond
2019-12-18 23:43                   ` Joseph Myers
2019-12-19  0:01                     ` Joseph Myers
2019-12-19  9:27                       ` Jonathan Wakely
2019-12-19 11:05                         ` Jonathan Wakely
2019-12-19 11:50                         ` Richard Earnshaw (lists)
2019-12-19 11:58                           ` Richard Earnshaw (lists)
2019-12-19 12:23                           ` Jonathan Wakely
2019-12-19 12:33                             ` Richard Earnshaw (lists)
2019-12-19 12:35                               ` Jonathan Wakely
2019-12-19 12:42                                 ` Richard Earnshaw (lists)
2019-12-19 13:34                                   ` Jonathan Wakely
2019-12-19 16:00                                     ` Joseph Myers
2019-12-19 16:06                                       ` Richard Earnshaw (lists)
2019-12-19 14:29                           ` Joseph Myers
2019-12-19 15:17                             ` Jonathan Wakely
2019-12-19 15:20                               ` Richard Earnshaw (lists)
2019-12-19 15:44                                 ` Jonathan Wakely
2019-12-19 15:47                                   ` Joseph Myers
2019-12-19 15:48                                     ` Jonathan Wakely
2019-12-19 15:48                                   ` Richard Earnshaw (lists)
2019-12-19 15:49                                 ` Joseph Myers
2019-12-19 16:27                                   ` Jonathan Wakely
2019-12-19 16:28                                     ` Jonathan Wakely
2019-12-19 16:33                                     ` Joseph Myers
2019-12-19 16:39                                       ` Jonathan Wakely
2019-12-19 16:43                                         ` Joseph Myers
2019-12-20 20:30                                     ` Joseph Myers
2019-12-20 21:30                                       ` Jonathan Wakely
2019-12-20 21:41                                         ` Joseph Myers
2019-12-20 22:11                                           ` Jonathan Wakely
2019-12-20 22:58                                             ` Joseph Myers
2019-12-20 23:23                                               ` Jonathan Wakely
2019-12-20 23:53                                                 ` Joseph Myers
2019-12-19 11:16                       ` Jakub Jelinek
2019-12-19 15:05                         ` Richard Earnshaw (lists)
2019-11-04 16:19 ` Jonathan Wakely
2019-11-04 16:35   ` Richard Earnshaw (lists)
2019-11-04 17:33   ` Segher Boessenkool
2019-11-04 17:42     ` Joseph Myers
2019-11-04 17:50       ` Segher Boessenkool
2019-11-05 11:07       ` Jonathan Wakely
2019-11-05 11:28         ` Jason Merrill
2019-11-05 14:12           ` Marek Polacek
2019-11-05 21:40             ` Richard Earnshaw (lists)
2019-11-05 14:50           ` David Malcolm
2019-11-05 22:08             ` Segher Boessenkool
2019-11-05 20:16         ` Segher Boessenkool
2019-11-05 21:01           ` Iain Sandoe
2019-11-05  2:51 ` Kewen.Lin
2019-11-05 21:42   ` Richard Earnshaw (lists)

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 read-only IMAP folder(s) and NNTP newsgroup(s).