The first two or three posts here might be mind-bending.
Post #10 puts things in context.
FreeBSD bug 254466 – sysutils/beadm-devel section (1) and sysutils/beadm section (8) for the two manual pages for beadm; consequences
works as intended – Wolfram Schneider's...
Before I open a bug for a part of the page that's wrong:
does anyone else have corrections, or suggestions for improvement?