News for hackers. Stuff that matters.
Re:How to Write a Git Commit Message (2014) by pmontra on Thursday March 16, 2017 @05:27PM (#13889366)
The most important tip is "Use the body to explain what and why vs. how".

I'd also say: remove thw -m option from git and force people to open the editor. Do not accept messages shorter than 3 lines, start the editor with a template

  Title

  What changed and why it changed.
Re:How to Write a Git Commit Message (2014) by eriknstr on Thursday March 16, 2017 @05:38PM (#13889436)
For my own commits in my personal repos I often find that less than 80 chars are sufficient to describe the change entirely. I generally don't care about surpassing 80 chars for commit messages though, so even if my commit message is somewhat long I won't split it up.

I commit very often and usually small, "atomic" changes most of the time.

What I will do, is that I start the commit message with the most important sentence and add less important sentences after, so even if it exceeds 80 chars and you can't see the whole message you will still get the most relevant info without having to scroll sideways.

For reference, here are the commits to a project I am currently working on: https://github.com/eriknstr/jumper/commits/master

Re:How to Write a Git Commit Message (2014) by rosser on Thursday March 16, 2017 @05:53PM (#13889547)
Dogmatism like "commit messages must be at least three lines" will result in commit messages like:

  here's
  some
  code.
Concentrating on form over substance is myopic.
Re:How to Write a Git Commit Message (2014) by petepete on Friday March 17, 2017 @04:35AM (#13892436)
Totally agree. Using three lines of text to describe fixing a typo in the comments or rewording/reformatting a block of text will just lead to an unclear message.
Re:How to Write a Git Commit Message (2014) by ecma on Thursday March 16, 2017 @05:36PM (#13889421)
It's likely that this would push the tools toward being too opinionated. I spend a lot of time pushing little WIPs so I know where I am and my macros rely heavily on -m, e.g. I end up with a commit message like "WIP: don't merge these debugging lines" or "WIP: Tweak the IO timeout and profile". -m is also useful for making trivial commits, I don't use it for this often because it's easy to violate 50 chars but it's a perfectly valid use of the tool IMO.
Re:How to Write a Git Commit Message (2014) by dtech on Thursday March 16, 2017 @05:33PM (#13889400)
You can easily enforce this if you want through a pre-commit hook, but this is frankly ridiculous to enforce on everybody.
Re:How to Write a Git Commit Message (2014) by tomjen3 on Thursday March 16, 2017 @06:21PM (#13889723)
From SO:

>Git can take the commit message from a file using the -F or --file flags:

>git commit -F message.txt

So something like

    echo 'pmontra\n say\n this\n should be several lines' | git commit -F /dev/stdin
would get around your block.
Re:How to Write a Git Commit Message (2014) by jwilk on Thursday March 16, 2017 @08:39PM (#13890410)
You want printf, not echo.

echo is a very non-portable command. POSIX says: "if any of the operands contain a <backslash> character, the results are implementation‐defined."

Re:How to Write a Git Commit Message (2014) by milesrout on Friday March 17, 2017 @09:00PM (#13899290)
why would the portability of the commands I type directly into my shell matter?
Re:How to Write a Git Commit Message (2014) by jwilk on Saturday March 18, 2017 @06:13PM (#13903770)
In your shell, it doesn't matter much.

In a HN comment, it matters, because other people will read the comment and may learn bad habits.