top.1: Begin documenting modes in DISPLAY
Needs ReviewPublic
Actions

Authored by ziaee on Jun 9 2025, 6:11 PM.

Tags

None

Referenced Files

	Unknown Object (File)
	Sun, Mar 29, 7:13 AM

	Unknown Object (File)
	Sat, Mar 28, 11:10 PM

	Unknown Object (File)
	Sat, Mar 28, 6:14 AM

	Unknown Object (File)
	Mon, Mar 16, 1:29 PM

	Unknown Object (File)
	Mon, Mar 16, 1:23 PM

	Unknown Object (File)
	Feb 8 2026, 1:25 AM

	Unknown Object (File)
	Jan 30 2026, 8:47 AM

	Unknown Object (File)
	Jan 11 2026, 12:42 PM

Subscribers

Details

Reviewers

carlavilla
mhorne

Group Reviewers

manpages

Summary

This is obviously not ready, but here's a draft with what i could figure
out so far. The commit log is suprisingly unhelpful, but I found ivct on
a mail from two decades ago and figured I'd get started and throw up a
draft for discussion.

There's some duplication here but I can't think of a more logical way to
do it initially.

Diff Detail

Repository

rG FreeBSD src repository

Lint

Lint Skipped

Unit

Tests Skipped

Build Status

Buildable 64724
Build 61608: arc lint + arc unit

Event Timeline

ziaee created this revision.Jun 9 2025, 6:11 PM

Herald added a subscriber: imp. · View Herald TranscriptJun 9 2025, 6:11 PM

ziaee requested review of this revision.Jun 9 2025, 6:11 PM

Harbormaster completed remote builds in B64724: Diff 156724.Jun 9 2025, 6:11 PM

bcr added a subscriber: bcr.Jul 13 2025, 9:12 AM

bcr added inline comments.

usr.bin/top/top.1
391	Capitalize CPU
400	This "If" needs to be on a line of its own after a sentence stop.
445	Capitalize CPU here and in other instances below, too?
460	s/io/IO/

The problem is that these modes are a literal lowercase option. I think that makes them command modifiers? In which case they should actually be .Cm cpu and .Cm io.