[src/netbsd-1-6]: src/usr.sbin/pkg_install/lib Pull up revision 1.2 (requeste...

[tron <tron%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/f37ad13a0d07
branches:  netbsd-1-6
changeset: 529498:f37ad13a0d07
user:      tron <tron%NetBSD.org@localhost>
date:      Sun Nov 24 22:21:32 2002 +0000

description:
Pull up revision 1.2 (requested by jschauma in ticket #1011):
add some comments.

diffstat:

 usr.sbin/pkg_install/lib/path.c |  18 ++++++++++++++++--
 1 files changed, 16 insertions(+), 2 deletions(-)

diffs (53 lines):

diff -r f29e37103267 -r f37ad13a0d07 usr.sbin/pkg_install/lib/path.c
--- a/usr.sbin/pkg_install/lib/path.c   Sun Nov 24 19:43:43 2002 +0000
+++ b/usr.sbin/pkg_install/lib/path.c   Sun Nov 24 22:21:32 2002 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: path.c,v 1.1.2.2 2002/07/21 04:42:47 lukem Exp $       */
+/*     $NetBSD: path.c,v 1.1.2.3 2002/11/24 22:21:32 tron Exp $        */
 
 /*-
  * Copyright (c)2002 YAMAMOTO Takashi,
@@ -28,7 +28,7 @@
 
 #include <sys/cdefs.h>
 #ifndef lint
-__RCSID("$NetBSD: path.c,v 1.1.2.2 2002/07/21 04:42:47 lukem Exp $");
+__RCSID("$NetBSD: path.c,v 1.1.2.3 2002/11/24 22:21:32 tron Exp $");
 #endif
 
 #include <err.h>
@@ -37,6 +37,12 @@
 
 struct pathhead PkgPath = TAILQ_HEAD_INITIALIZER(PkgPath);
 
+/*
+ * path_create: make PkgPath from a given string.
+ *
+ * => relative pathes are resolved to absolute ones.
+ * => if NULL is passed, use "." instead. XXX
+ */
 void
 path_create(const char *path)
 {
@@ -99,6 +105,9 @@
        }
 }
 
+/*
+ * path_free: free PkgPath.
+ */
 void
 path_free()
 {
@@ -111,6 +120,11 @@
        }
 }
 
+/*
+ * path_setenv: construct string from PkgPath and set it to a environment.
+ *
+ * => the environment name is given by envname.
+ */
 void
 path_setenv(const char *envname)
 {