Makefiles: Reflow and align at 72 for comfort
Needs ReviewPublic
Actions

Authored by ziaee on Dec 13 2025, 4:41 PM.

Details

Reviewers

Group Reviewers

docs
doceng

Summary

Much of the base system, including the rules for commit messages, is
wrapped at 72 so that it's comfortable in a traditional 80 character
console with line numbering. Wrap and align these files at 72 where
convenient to increase comfort and consistency. Minor touch-ups to
some comments as well.

If you hate this, no problem, no hard feelings!

Test Plan

+ Read the patched files
+ Make the targets

Diff Detail

Repository

R9 FreeBSD doc repository

Lint

Lint Skipped

Unit

Tests Skipped

Build Status

Buildable 69627
Build 66510: arc lint + arc unit

Event Timeline

ziaee requested review of this revision.Dec 13 2025, 4:41 PM

ziaee created this revision.

Harbormaster completed remote builds in B69235: Diff 167970.Dec 13 2025, 4:41 PM

ziaee edited the summary of this revision. (Show Details)Dec 13 2025, 4:45 PM

ziaee edited the test plan for this revision. (Show Details)

ziaee added reviewers: docs, doceng.Dec 23 2025, 4:16 PM

increase capitalization and punctuation consistency

Harbormaster completed remote builds in B69627: Diff 169070.Jan 5 2026, 4:21 PM

Ping

Is it necessary to decrease line length? The style(9) states:

This  file specifies the	preferred style	for kernel source files	in the
FreeBSD source tree.  It	is also	a guide	 for  the  preferred  userland
code style.  The	preferred line width is	80 characters, but some	excep-
tions  are  made	 when  a  slightly longer line is clearer or easier to
read.

I think, 80 chars length is acceptable.

It isn't actually wrapped at 80. Most of the document is wrapped at 73, which is extremely annoying when using line numbering because many lines takes two lines for one extra character.