(patch) Documentation error in pkg_info(1)

From: James Devenish <j-devenish(at)users.sourceforge.net>
Date: Fri Jan 03 2003 - 04:28:53 EST

Hi,

Something seems amiss with pkg_info(1). Wrong documentation for -a and non-standard (and undocumented) -h. Patches attached, with comments about what I was thinking.

I previously said in misc:
> Hi,
>
> In the reference manual for pkg_info (section 1), I see:
>
> SYNOPSIS
> pkg_info [-cDdfIikLmpqRrvh] [-e package] [-l prefix] pkg-name [...]
>
> And yet I cannot see any documentation for "-h". Looks like it's been
> that way for a long time. My misunderstanding or a bug?
Index: src/usr.sbin/pkg_install/info/pkg_info.1 pkg_info(1) contains too much information ;) (-a doesn't take arguments, does it?). Also, there is a functional flag -h which performs the same action as -? but is not documented as such.

---

RCS file: /cvs/src/usr.sbin/pkg_install/info/pkg_info.1,v retrieving revision 1.10

diff -u -r1.10 pkg_info.1
--- src/usr.sbin/pkg_install/info/pkg_info.1	6 Apr 2002 01:07:19 -0000	1.10
+++ src/usr.sbin/pkg_install/info/pkg_info.1	3 Jan 2003 09:10:26 -0000

@@ -25,12 +25,12 @@

 .Nd a utility for displaying information on software packages
 .Sh SYNOPSIS
 .Nm pkg_info
-.Op Fl cDdfIikLmpqRrvh
+.Op Fl cDdfIikLmpqRrv
 .Op Fl e Ar package
 .Op Fl l Ar prefix
 .Ar pkg-name Op Ar ...
 .Nm pkg_info
-.Op Fl a Ar flags
+.Op Fl a
 .Sh DESCRIPTION

 The
 .Nm
Index: src/usr.sbin/pkg_install/info/main.c Removed non-standard and undocumentated -h flag.

---

RCS file: /cvs/src/usr.sbin/pkg_install/info/main.c,v retrieving revision 1.14

diff -u -r1.14 main.c
--- src/usr.sbin/pkg_install/info/main.c	16 Feb 2002 21:28:07 -0000	1.14
+++ src/usr.sbin/pkg_install/info/main.c	3 Jan 2003 09:23:06 -0000

@@ -29,7 +29,7 @@
 #include "lib.h"
 #include "info.h"  

-static char Options[] = "acDde:fIikLl:mpqRrvh"; +static char Options[] = "acDde:fIikLl:mpqRrv";  

 int	Flags		= 0;
 Boolean AllInstalled	= FALSE;
@@ -122,7 +122,6 @@
 		SHOW_REQBY;
 	    break;
 
-	case 'h':
 	case '?':
 	default:
 	    usage();

Received on Fri Jan 3 04:29:35 2003