Subject: re: port-i386/36962: Misleading use of "path" in swapctl(8)'s discussion of -a option.
To: None <gnats-bugs@NetBSD.org>
From: matthew green <firstname.lastname@example.org>
Date: 09/11/2007 06:23:23
The manpage for swapctl(8) discusses requirement of a path when
using the -a option. This path is actually a "node" as described
in the manpage for mount(8). Use of the word "path" is misleading.
i do not agree.
in mount(8) a "node" is the place mounted upon. it's a local
directory. in mount(8) a "special" is the device or remote
name to use (eg, /dev/sd0a or host:/path.)
in swapctl(8) the "path" is more akin to mount(8)'s "special",
in that it is normally a device or file. it certainly is not
"node" as described in mount(8). why a description in mount(8)
is relevant to swapctl, i'm not sure.
Likewise, it should be mentioned that use of swapctl(8)'s -a option
does not require a corresponding entry in /etc/fstab.
the manual already states in the 2nd paragraph of the
If either special or node are not provided, the
appropriate information is taken from the fstab(5) file
i see no reason to change swapctl(8).