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

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

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 71045
Build 67928: 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.