bin/60013: pstat(8) (man page) contains references to ancient history

["kre%munnari.OZ.AU@localhost via gnats" <gnats-admin%NetBSD.org@localhost>]

>Number:         60013
>Category:       bin
>Synopsis:       pstat(8) (man page) contains references to ancient history
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bin-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Feb 17 01:05:00 +0000 2026
>Originator:     Robert Elz
>Release:        NetBSD 11.99.5
>Organization:
>Environment:
System: NetBSD jacaranda.noi.kre.to 11.99.5 NetBSD 11.99.5 (JACARANDA:1.1-20260213) #251: Fri Feb 13 09:40:29 +07 2026 kre%jacaranda.noi.kre.to@localhost:/usr/obj/testing/kernels/amd64/JACARANDA amd64
Architecture: x86_64
Machine: amd64
>Description:

	While reading pstat(8) we encounter gems like:

	     -s      Print information about swap space usage on all the swap areas
		     compiled into the kernel.

	It goes on to fail to mention the Priority column in the -s output.

	For the -t option, the DISC (line discipline) column doesn't mention "termios"
	which seems to be what all of mine are, but does Xr strip(4) which I think was
	removed long ago.   Some of the others are probably also dead.

	Then:

	     -v      Print the active vnodes.  Each group of vnodes corresponding to a
		     particular filesystem is preceded by a two line header.  The
		     first line consists of the following:

		     *** MOUNT fstype from on on fsflags

		     where fstype is one of adosfs, afs, cd9660, fdesc, ffs, ext2fs,
		     kernfs, lfs, lofs, mfs, msdos, nfs, null, procfs, umap, union;

	But I see (for example):

		*** MOUNT tmpfs tmpfs on /tmp (local)
		*** MOUNT ptyfs ptyfs on /dev/pts (hidden,local)

	which aren't meant to appear, according to the above list (and if I had any
	zfs, ntfs, and probably others, they'd probably appear too.)

	It also fails to mention that the output might be millions of lines long
	for me:
		pstat -v | wc -l
		 2788637

	And:

		ENVIRONMENT
		     BLOCKSIZE  If the environment variable BLOCKSIZE is set, and the -k
			        option is not specified, the block counts will be displayed in
				units of that size block.

	which I suspect only applies to pstat -s but neither that, nor the -k option mentions
	that, nor does that paragraph mention -g -h or -m which are kind of -k clones.

	Also:
		FILES
			/netbsd       namelist
			/dev/kmem     default source of tables

	which I suspect is mostly (or perhaps entirely) no longer true.
	(neither of those strings appears to exist in the binary).

	and last (for me for now, I suspect there is more)

		BUGS
		     Swap statistics are reported for all swap partitions compiled into the
		     kernel, regardless of whether those partitions are being used.

		     Does not understand NFS swap servers.
	
	The first is certainly no longer relevant, I suspect the 2nd might no longer
	apply either, but I have no NFS setup to test it.


>How-To-Repeat:
	RTFM.

>Fix:
	Apply an editor, and some knowledge.