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)
Sun, Jun 21, 10:05 PM
Unknown Object (File)
Tue, Jun 2, 4:55 PM
Unknown Object (File)
Sat, May 30, 10:45 PM
Unknown Object (File)
Apr 27 2026, 1:16 PM
Unknown Object (File)
Apr 27 2026, 9:38 AM
Unknown Object (File)
Apr 15 2026, 11:09 AM
Unknown Object (File)
Apr 7 2026, 11:18 AM
Unknown Object (File)
Apr 3 2026, 4:26 PM
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