From seggers@semyam.dinoco.de  Thu Jun 25 07:23:37 1998
Received: from tim.xenologics.com (tim.xenologics.com [194.77.5.24])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id HAA14864
          for <FreeBSD-gnats-submit@freebsd.org>; Thu, 25 Jun 1998 07:23:34 -0700 (PDT)
          (envelope-from seggers@semyam.dinoco.de)
Received: (from uucp@localhost)
	by tim.xenologics.com (8.8.5/8.8.8) with UUCP id QAA18470
	for FreeBSD-gnats-submit@freebsd.org; Thu, 25 Jun 1998 16:19:53 +0200 (MET DST)
Received: (from seggers@localhost)
	by semyam.dinoco.de (8.8.8/8.8.8) id OAA23503;
	Thu, 25 Jun 1998 14:23:27 +0200 (CEST)
	(envelope-from seggers)
Message-Id: <199806251223.OAA23503@semyam.dinoco.de>
Date: Thu, 25 Jun 1998 14:23:27 +0200 (CEST)
From: Stefan Eggers <seggers@semyam.dinoco.de>
Reply-To: seggers@semyam.dinoco.de
To: FreeBSD-gnats-submit@freebsd.org
Cc: seggers@semyam.dinoco.de
Subject: pkg_* man pages are incomplete regarding env variables
X-Send-Pr-Version: 3.2

>Number:         7064
>Category:       docs
>Synopsis:       pkg_* man pages are incomplete regarding env variables
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jun 25 07:30:01 PDT 1998
>Closed-Date:    Fri Jun 26 00:12:30 PDT 1998
>Last-Modified:  Fri Jun 26 00:16:45 PDT 1998
>Originator:     Stefan Eggers
>Release:        FreeBSD 2.2.6-STABLE i386
>Organization:
none
>Environment:

	2.2-stable CVSUped around June, 20th 1998

>Description:

	The environment variables and directories used for temporary
files are insufficiently documented.

>How-To-Repeat:

	As mentioned often before with this type of bugs:  Just read
the man page.  :-)

>Fix:
	
	I made three diffs to the man pages.  They are:

--- add/pkg_add.1.ORIG	Sat Oct 18 07:55:12 1997
+++ add/pkg_add.1	Thu Jun 25 14:04:59 1998
@@ -198,7 +198,11 @@
 .Sh TECHNICAL DETAILS
 .Nm Pkg_add
 is fairly simple.  It extracts each package's "packing list"
-into a special staging directory in /tmp (or $PKG_TMPDIR if set), parses it,
+into a special staging directory determined by the environment variables
+.Ev PKG_TMPDIR
+and
+.Ev TMPDIR ,
+parses it,
 and then runs through the following sequence to fully extract the contents:
 .Bl -enum -indent indent
 .It
@@ -334,6 +338,28 @@
 consists of a directory name. The current directory may be indicated
 implicitly by an empty directory name, or explicitly by a single
 period.
+.Pp
+.Ev PKG_TMPDIR
+points to the directory where pkg_add creates temporary files.
+.Ev TMPDIR
+gets used if
+.Ev PKG_TMPDIR
+is not set.  If both are unset built in defaults are used.
+.Sh FILES
+.Bl -tag -width /usr/tmp -compact
+.It Pa /var/tmp
+Used if
+.Ev PKG_TMPDIR
+and
+.Ev TMPDIR
+are either not set or the directories have insufficient space left.
+.It Pa /tmp
+The next choice if /var/tmp either does not exist or has insufficent
+space left.
+.It Pa /usr/tmp
+The last choice. Used if /tmp either does not exist or has
+insufficent space left.
+.El
 .Sh SEE ALSO
 .Xr pkg_create 1 ,
 .Xr pkg_delete 1 ,
----------------------------------------------------------------------
--- create/pkg_create.1.ORIG	Sun May 24 17:18:45 1998
+++ create/pkg_create.1	Thu Jun 25 14:00:00 1998
@@ -359,6 +359,28 @@
 .Cm @pkgdep
 directives may be used if the package depends on multiple other packages.
 .El
+.Sh ENVIRONMENT
+.Ev PKG_TMPDIR
+points to the directory where pkg_create creates temporary files.
+.Ev TMPDIR
+gets used if
+.Ev PKG_TMPDIR
+is not set.  If both are unset built in defaults are used.
+.Sh FILES
+.Bl -tag -width /usr/tmp -compact
+.It Pa /var/tmp
+Used if
+.Ev PKG_TMPDIR
+and
+.Ev TMPDIR
+are either not set or the directories have insufficient space left.
+.It Pa /tmp
+The next choice if /var/tmp either does not exist or has insufficent
+space left.
+.It Pa /usr/tmp
+The last choice. Used if /tmp either does not exist or has
+insufficent space left.
+.El
 .Sh SEE ALSO
 .Xr pkg_add 1 ,
 .Xr pkg_delete 1 ,
----------------------------------------------------------------------
--- info/pkg_info.1.ORIG	Thu Oct  9 09:09:45 1997
+++ info/pkg_info.1	Thu Jun 25 14:00:12 1998
@@ -118,6 +118,28 @@
 command line, or from already installed package information
 in
 .Pa /var/db/pkg/<pkg-name> .
+.Sh ENVIRONMENT
+.Ev PKG_TMPDIR
+points to the directory where pkg_info creates temporary files.
+.Ev TMPDIR
+gets used if
+.Ev PKG_TMPDIR is not set.  If both are unset built in defaults are
+used.
+.Sh FILES
+.Bl -tag -width /usr/tmp -compact
+.It Pa /var/tmp
+Used if
+.Ev PKG_TMPDIR
+and
+.Ev TMPDIR
+are either not set or the directories have insufficient space left.
+.It Pa /tmp
+The next choice if /var/tmp either does not exist or has insufficent
+space left.
+.It Pa /usr/tmp
+The last choice. Used if /tmp either does not exist or has
+insufficent space left.
+.El
 .Sh SEE ALSO
 .Xr pkg_add 1 ,
 .Xr pkg_create 1 ,
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: jkoshy 
State-Changed-When: Fri Jun 26 00:12:30 PDT 1998 
State-Changed-Why:  
Changed in rev 1.25 of pkg_add.1, rev 1.26 of pkg_crate.1, rev 1.16 pf 
pkg_info.1; thanks! 
>Unformatted:
