From vangyzen@stat.duke.edu  Mon Aug 11 13:13:33 2003
Return-Path: <vangyzen@stat.duke.edu>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 8405F37B401
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 11 Aug 2003 13:13:33 -0700 (PDT)
Received: from which.isds.duke.edu (which.isds.duke.edu [152.3.22.3])
	by mx1.FreeBSD.org (Postfix) with ESMTP id E8E3743FAF
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 11 Aug 2003 13:13:32 -0700 (PDT)
	(envelope-from vangyzen@stat.duke.edu)
Received: from stat.duke.edu (sinatra.isds.duke.edu [152.3.22.120])
	by which.isds.duke.edu (Postfix) with ESMTP id 50D82C3848
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 11 Aug 2003 16:13:32 -0400 (EDT)
Received: (from vangyzen@localhost)
	by stat.duke.edu (8.12.9/8.12.9/Submit) id h7BKDWtX011068;
	Mon, 11 Aug 2003 16:13:32 -0400 (EDT)
	(envelope-from vangyzen)
Message-Id: <200308112013.h7BKDWtX011068@stat.duke.edu>
Date: Mon, 11 Aug 2003 16:13:32 -0400 (EDT)
From: Eric van Gyzen <vangyzen@stat.duke.edu>
Reply-To: Eric van Gyzen <vangyzen@stat.duke.edu>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: pkg_create(1) man page seems ambiguous
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         55477
>Category:       bin
>Synopsis:       pkg_create(1) man page seems ambiguous
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    roam
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Aug 11 13:20:01 PDT 2003
>Closed-Date:    Wed Sep 03 01:30:24 PDT 2003
>Last-Modified:  Wed Sep 03 01:30:24 PDT 2003
>Originator:     Eric van Gyzen
>Release:        FreeBSD 5.1-RELEASE i386
>Organization:
>Environment:
FreeBSD 5.1-RELEASE

>Description:
(In my opinion,) The explanation of the -i option to pkg_create(1) doesn't
sufficiently explain the order of the arguments to the +INSTALL script.
It says that the keyword P(RE|OST)-INSTALL will be passed, along with the
package's name.  To me, that sounds like the keyword is first, then the
package's name.  (Now that I have discovered otherwise, the intended meaning
seems obvious, but when I first read it, I was confused.)

>How-To-Repeat:
N/A
>Fix:
I would suggest changing the wording from:
    differentiating between the functionality by passing the keywords
    PRE-INSTALL and POST-INSTALL respectively, along with the package's name.
to:
    differentiating between the functionality by passing the keywords
    PRE-INSTALL and POST-INSTALL (respectively) after the package's name.
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: roam 
State-Changed-When: Tue Aug 26 07:49:39 PDT 2003 
State-Changed-Why:  
Change committed to -CURRENT, I will merge it into the -STABLE 
branch after the code freeze for 4.9-RELEASE is over. 


Responsible-Changed-From-To: freebsd-bugs->roam 
Responsible-Changed-By: roam 
Responsible-Changed-When: Tue Aug 26 07:49:39 PDT 2003 
Responsible-Changed-Why:  
Mine to MFC. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=55477 
State-Changed-From-To: patched->closed 
State-Changed-By: roam 
State-Changed-When: Wed Sep 3 01:25:19 PDT 2003 
State-Changed-Why:  
Merged into -STABLE after approval from the Release Engineering team. 
Thanks for the problem report! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=55477 
>Unformatted:
