mi_switch.9: Remove cpu_switch, cpu_throw
ClosedPublic
Actions

Authored by emaste on Jan 7 2025, 4:08 PM.

Details

Reviewers

jhb
kib

Commits

rG0cfebe47d9e3: mi_switch.9: Remove cpu_switch, cpu_throw
rGf73c9b5da190: mi_switch.9: Remove cpu_switch, cpu_throw

Summary

cpu_machdep.9 was added to document cpu_*, but cpu_switch and cpu_throw
were already documented in mi_switch.9, and MLINKed.  cpu_machdep.9
seems like the correct place for this, so remove them from mi_switch.9.

Reported by: tools/pkgbase/metalog_reader.lua
Fixes: 9c87cbbcaaed ("cpu_machdep.9: New manpage describing the semantics of several cpu_*")

Diff Detail

Repository

rG FreeBSD src repository

Lint

Lint Not Applicable

Unit

Tests Not Applicable

Event Timeline

Found via:

error: ./usr/share/man/man9/cpu_switch.9.gz exists in multiple locations and with different meta: line 27352,28023. off by "size"
error: ./usr/share/man/man9/cpu_throw.9.gz exists in multiple locations and with different meta: line 27358,28024. off by "size"

Not sure if some of the text removed from here should be added to to cpu_machdep.9.

The differences in cpu_throw are actually stale (we don't use it from thread_exit anymore). The fact that curthread and the current pmap are changed in cpu_switch probably is a detail worth carrying over to cpu_machdep(9).

This revision is now accepted and ready to land.Jan 7 2025, 4:17 PM

Closed by commit rGf73c9b5da190: mi_switch.9: Remove cpu_switch, cpu_throw (authored by emaste). · Explain WhyJan 7 2025, 4:25 PM

This revision was automatically updated to reflect the committed changes.

emaste added a commit: rGf73c9b5da190: mi_switch.9: Remove cpu_switch, cpu_throw.

Herald added a subscriber: imp. · View Herald TranscriptJan 7 2025, 4:25 PM

jhb added a commit: rG0cfebe47d9e3: mi_switch.9: Remove cpu_switch, cpu_throw.Mar 3 2025, 4:58 PM

Herald added a subscriber: ziaee. · View Herald TranscriptMar 3 2025, 4:58 PM