Subject: re: port-i386/36962: Misleading use of "path" in swapctl(8)'s discussion of -a option.
To: None <port-i386-maintainer@netbsd.org, gnats-admin@netbsd.org,>
From: matthew green <mrg@eterna.com.au>
List: netbsd-bugs
Date: 09/10/2007 20:25:02
The following reply was made to PR port-i386/36962; it has been noted by GNATS.

From: matthew green <mrg@eterna.com.au>
To: gnats-bugs@NetBSD.org
Cc: port-i386-maintainer@netbsd.org, gnats-admin@netbsd.org,
	netbsd-bugs@netbsd.org
Subject: re: port-i386/36962: Misleading use of "path" in swapctl(8)'s discussion of -a option. 
Date: Tue, 11 Sep 2007 06:23:23 +1000

    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
 DESCRIPTION: 
 
 	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).
 
 
 .mrg.