Page MenuHomeFreeBSD

committers-guide: increase subject length limit to 67 characters
ClosedPublic

Authored by emaste on Dec 29 2024, 4:26 PM.
Tags
None
Referenced Files
Unknown Object (File)
Thu, Dec 25, 3:55 PM
Unknown Object (File)
Fri, Dec 19, 11:02 AM
Unknown Object (File)
Fri, Dec 19, 11:01 AM
Unknown Object (File)
Wed, Dec 17, 8:36 AM
Unknown Object (File)
Dec 12 2025, 10:08 AM
Unknown Object (File)
Dec 7 2025, 11:01 AM
Unknown Object (File)
Nov 26 2025, 9:17 PM
Unknown Object (File)
Nov 13 2025, 8:35 AM
Subscribers

Details

Summary
I originally suggested a 63-character limit "so that git log --oneline
avoids wrapping".  Short hashes in the tree are typically 12 characters.
With a space between the hash and the subject should result in a limit
of 67 characters.  I think I arrived at 63 by subtracting git's typical
4-space indentation, but that's not applicable to `git log --oneline`.

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Not Applicable
Unit
Tests Not Applicable

Event Timeline

emaste created this revision.

btw, I got this script. Named wrap74, it would wrap lines to 74 chars. And you can have several symlinks/hardlinks for it, with different names, e.g. wrap79, wrap64.

#!/usr/local/bin/python

import fileinput
import textwrap
import os
import re

len = int(re.search('[0-9]+$', os.path.basename(__file__)).group())

all = ''
for line in fileinput.input():
        if (line == '\n'):
                print(textwrap.fill(all, len))
                print()
                all = ''
        else:
                all += line

print(textwrap.fill(all, len))
This revision is now accepted and ready to land.Jul 31 2025, 2:04 PM