Thanks pauamma! You've been really crushing it finding typos that I sincerely read over and didn't notice lately!

In D53724#1226655, @ziaee wrote:

Would it fix it if we add a FILES section to acpi.4 showing the device
nodes?

We might also need to move the interfaces that were documented in apm.4 to there.

Can I do anything with this or push it? I want to have 15.0R not have a doc that says it's going to be removed in 5 years ago at the top.

Hmmm, I wonder if what might be better is to rework the existing apm.4 manpage to say it is an interface (instead of a driver), but not merge all its content over into acpi.4. It's more that this is a way to describe an API than a device driver. There would be no real SYNOPSIS in this case in the classic sense (we don't really have a model for a SYNOPSIS for something that is an abstract interface as opposed to a foo.ko you can load). That is, you would take the existing apm.4, and make the following changes:

.Dt "Power management interface"

SYNOPSIS - remove (there's nothing to really put here)

.Sh DESCRIPTION
.Nm
is an interface to power management on i386 and amd64.
This interface was originally designed to support the
Advanced Power Management (APM) BIOS extension on i386.
However,
the interface is now implemented by
.Xr acpi 4.
...

Then only keep bullets 4 and 5 from the list, but don't make them part of a bullet list, just separate paragraphs. There's a separate issue that 4 is missing some commands, and in particular the list from bullet 5 should be a nested list under a description of APMIO_NEXTEVENT instead. Also, there manpage needs a .Sh FILES section that lists /dev/apm.