From nobody@FreeBSD.org  Tue Feb  8 22:30:32 2005
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 329DB16A537
	for <freebsd-gnats-submit@FreeBSD.org>; Tue,  8 Feb 2005 22:30:25 +0000 (GMT)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 6660243D41
	for <freebsd-gnats-submit@FreeBSD.org>; Tue,  8 Feb 2005 22:30:25 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.13.1/8.13.1) with ESMTP id j18MUOiA023166
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 8 Feb 2005 22:30:25 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id j18MUOKK023165;
	Tue, 8 Feb 2005 22:30:24 GMT
	(envelope-from nobody)
Message-Id: <200502082230.j18MUOKK023165@www.freebsd.org>
Date: Tue, 8 Feb 2005 22:30:24 GMT
From: Ian <cdine@cdine.org>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Typo in swapon man page
X-Send-Pr-Version: www-2.3

>Number:         77280
>Category:       docs
>Synopsis:       Typo in swapon man page
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Feb 08 22:40:12 GMT 2005
>Closed-Date:    Wed Feb 09 10:12:38 GMT 2005
>Last-Modified:  Wed Feb  9 17:30:10 GMT 2005
>Originator:     Ian
>Release:        FreeBSD 5.3-RELEASE
>Organization:
Negative Nine Security (Neg9)
>Environment:
FreeBSD dedication.neg9.org 5.3-RELEASE-p2 FreeBSD 5.3-RELEASE-p2 #0: Mon Jan  3 02:17:43 PST 2005
root@dedication.neg9.org:/usr/obj/usr/src/sys/SMIRNOFF  i386

>Description:
Snipped from `man swapon` (Yes, swapon, swapinfo does not say to use -h) on FreeBSD -- 5.3-RELEASE-p2 FreeBSD 5.3-RELEASE-p2 #0: Mon Jan  3 02:17:43 PST 2005

==============================

SWAPON(8)               FreeBSD System Manager's Manual              SWAPON(8)

NAME
     swapon, swapoff, swapctl -- specify devices for paging and swapping
..
     Swap information can be generated using the swapinfo(8) utility, pstat
     -s, or swapctl -l.  The swapctl utility has the following options for
     listing swap:

     -h      Output values in megabytes.
..
HISTORY
     The swapon utility appeared in 4.0BSD.  The swapoff and swapctl utilities
     appeared in FreeBSD 5.1.

FreeBSD 5.3                    December 28, 2002                   FreeBSD 5.3


==============================

-h Is not a valid option of swapinfo, as demonstrated here:

# swapinfo -h
swapinfo: illegal option -- h
usage: swapinfo [-k] [-M core [-N system]]
# swapinfo -k
Device          1K-blocks     Used    Avail Capacity
/dev/ad0s1b       1572864    31132  1541732     2%

>How-To-Repeat:
# man swapon, search for "-h" i.e. if your viwer is more, type "/" and then "-h" followed by a return.
>Fix:

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: ru 
State-Changed-When: Wed Feb 9 10:11:46 GMT 2005 
State-Changed-Why:  
-h is a valid option for swapctl(8). 
-h is not a valid option for swapinfo(8) which has its own manpage. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=77280 

From: Giorgos Keramidas <keramida@freebsd.org>
To: Ian <cdine@cdine.org>
Cc: bug-followup@freebsd.org
Subject: Re: misc/77280: Typo in swapon man page
Date: Wed, 9 Feb 2005 19:22:39 +0200

 On 2005-02-08 22:30, Ian <cdine@cdine.org> wrote:
 > NAME
 >      swapon, swapoff, swapctl -- specify devices for paging and swapping
 > ..
 >      Swap information can be generated using the swapinfo(8) utility, pstat
 >      -s, or swapctl -l.  The swapctl utility has the following options for
 >      listing swap:
 >
 >      -h      Output values in megabytes.
 >
 > ==============================
 >
 > -h Is not a valid option of swapinfo, as demonstrated here:
 
 Good point...
 
 FWIW, I have a patch that adds this option to pstat and swapinfo.
 Most of it has been reviewed a couple of times by Ruslan Ermilov, and
 I plan to commit it as soon as I get back home.
 
 So, in my opinion, the correct fix is to add the missing option,
 instead of removing the manpage stuff :-)
 
 - Giorgos
 
>Unformatted:
