Re: bin/46654: misleading man entry for pkg_info -F

[Thomas Klausner <wiz%NetBSD.org@localhost>]

The following reply was made to PR bin/46654; it has been noted by GNATS.

From: Thomas Klausner <wiz%NetBSD.org@localhost>
To: NetBSD bugtracking <gnats-bugs%NetBSD.org@localhost>
Cc: 
Subject: Re: bin/46654: misleading man entry for pkg_info -F
Date: Thu, 5 Jul 2012 20:50:06 +0200

 On Wed, Jul 04, 2012 at 02:09:28PM -0700, Hisashi T Fujinaka wrote:
 > On Wed, 4 Jul 2012, Thomas Klausner wrote:
 > 
 > >The following reply was made to PR bin/46654; it has been noted by GNATS.
 > >
 > >From: Thomas Klausner <wiz%NetBSD.org@localhost>
 > >To: gnats-bugs%NetBSD.org@localhost
 > >Cc:
 > >Subject: Re: bin/46654: misleading man entry for pkg_info -F
 > >Date: Wed, 4 Jul 2012 23:01:46 +0200
 > >
 > >On Wed, Jul 04, 2012 at 08:20:00PM +0000, htodd%twofifty.com@localhost 
 > >wrote:
 > >> Everything beyond the first sentence is extraneous and always leads to me 
 > >> trying "pkg_info -eF /path/to/filename" which doesn't work. Just delete 
 > >> the second sentence as it makes no sense.
 > >
 > >pkg_info -Fe /usr/pkg/bin/emacs
 > >does work (if you have emacs installed)
 > 
 > Ah, so -eF doesn't work, but -Fe works.
 
 This shouldn't be really surprising, because -e wants an argument, and
 it takes whatever it finds. With "pkg_info -eF" it finds "F". All
 getopt(3)-using programs behave this way.
 
 The man page documents that -e wants an argument:
 
 SYNOPSIS
      pkg_info [-BbcDdFfhIikLmNnpqRrSsVvX] [-e package] [-E package]
               [-K pkg_dbdir] [-l prefix] pkg-name ...
 ...
      -e pkg-name
              This option allows you to test for the existence of a given
             ...
 
 So I think it's documented correctly, but let me know if you have a
 suggestion how to improve it.
  Thomas