Subject: Re: advertising PKG_PATH better
To: Hubert Feyrer <hubert.feyrer@informatik.fh-regensburg.de>
From: None <itojun@iijlab.net>
List: tech-pkg
Date: 04/09/2001 17:18:24
>> 	do people think it a good thing to have?
>> 	(we may want to use some nroff macro in place of "1.5")
>It's good, but it should contain a bit more examples
> * pkg_add /usr/pkgsrc/packages/All/tcsh-6.10.00.tgz
> * pkg_add -v /usr/pkgsrc/packages/All/unzip

	fine I will.

> * pkg_add -v ftp://ftp.netbsd.org/pub/NetBSD/packages/1.5/i386/All/mozilla-0.8.1.tgz

	did pkg_add pull dependencies from ftp.netbsd.org in this case?
	i'm not too sure about the behavior in this case.

itojun


Index: pkg_add.1
===================================================================
RCS file: /cvsroot/basesrc/usr.sbin/pkg_install/add/pkg_add.1,v
retrieving revision 1.25
diff -u -r1.25 pkg_add.1
--- pkg_add.1	2001/03/20 19:43:36	1.25
+++ pkg_add.1	2001/04/09 08:18:14
@@ -397,6 +397,38 @@
 Staging directory for installing packages, defaults to /tmp.
 Set to directory with lots of free disk if you run out of
 space when installing a binary package.
+.Sh EXAMPLES
+You can specify a compiled binary package explicitly on the command line.
+.Bd -literal
+# pkg_add /usr/pkgsrc/packages/All/tcsh-6.10.00.tgz
+.Ed
+.Pp
+If you omit the version number,
+.Nm
+will install the latest version available.
+With
+.Fl v ,
+.Nm
+emits more messages to terminal.
+.Bd -literal
+# pkg_add -v /usr/pkgsrc/packages/All/unzip
+.Ed
+.Pp
+You can grab a compiled binary package from remote location, by specifying
+an URL.
+.\" XXX dependency?
+.Bd -literal
+# pkg_add -v ftp://ftp.netbsd.org/pub/NetBSD/packages/1.5/i386/All/mozilla-0.8.1.tgz
+.Ed
+.Pp
+The following example fetches and installs compiled binary package for mozilla,
+using the latest version available, with all dependencies considered,
+directly from
+.Li ftp.netbsd.org .
+.Bd -literal
+# export PKG_PATH=ftp://ftp.netbsd.org/pub/NetBSD/packages/1.5/i386/All
+# pkg_add -v mozilla
+.Ed
 .Sh SEE ALSO
 .Xr pkg_admin 1 ,
 .Xr pkg_create 1 ,