From owner-freebsd-bugs@FreeBSD.ORG Mon Aug 11 13:20:03 2003 Return-Path: Delivered-To: freebsd-bugs@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1C59237B401 for ; Mon, 11 Aug 2003 13:20:03 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 12AE443FA3 for ; Mon, 11 Aug 2003 13:20:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h7BKK1Up021319 for ; Mon, 11 Aug 2003 13:20:01 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h7BKK1Oj021318; Mon, 11 Aug 2003 13:20:01 -0700 (PDT) Resent-Date: Mon, 11 Aug 2003 13:20:01 -0700 (PDT) Resent-Message-Id: <200308112020.h7BKK1Oj021318@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-bugs@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Eric van Gyzen Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8405F37B401 for ; 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 ; 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 ; 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 To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: bin/55477: pkg_create(1) man page seems ambiguous X-BeenThere: freebsd-bugs@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Eric van Gyzen List-Id: Bug reports List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 11 Aug 2003 20:20:03 -0000 >Number: 55477 >Category: bin >Synopsis: pkg_create(1) man page seems ambiguous >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-bugs >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Mon Aug 11 13:20:01 PDT 2003 >Closed-Date: >Last-Modified: >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: >Unformatted: