From: espie <espie@openbsd.org>
Date: Tue, 16 May 2023 14:33:04 +0000 (+0000)
Subject: cleaner documentation of what's going on
X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=b9dc0093d2fd0bac25a8a41bb96fcbbe165335f6;p=openbsd

cleaner documentation of what's going on
---

diff --git a/usr.sbin/pkg_add/OpenBSD/ArcCheck.pm b/usr.sbin/pkg_add/OpenBSD/ArcCheck.pm
index 906b5ed632c..b4195cd3ca8 100644
--- a/usr.sbin/pkg_add/OpenBSD/ArcCheck.pm
+++ b/usr.sbin/pkg_add/OpenBSD/ArcCheck.pm
@@ -1,5 +1,5 @@
 # ex:ts=8 sw=4:
-# $OpenBSD: ArcCheck.pm,v 1.37 2022/06/06 06:57:35 espie Exp $
+# $OpenBSD: ArcCheck.pm,v 1.38 2023/05/16 14:33:04 espie Exp $
 #
 # Copyright (c) 2005-2006 Marc Espie <espie@openbsd.org>
 #
@@ -21,14 +21,16 @@
 # between tar balls OpenBSD::Ustar::Object and 
 # packing list OpenBSD::PackingElement
 
-# specifically, during create time, we call prepare_long:
-# - prevent a lot of weird objects from entering the archives
-# - make sure all relevant users/modes are recorded in the PLIST item
+# specifically, during create time:
+# 	$o = $archive->prepare_long($item);
+# 	if (!$o->verify_modes($self))
+# 		error...
+# 	if (!$o->is_allowed)
+#		error...
 
-# during extraction: we call validate_meta:
-# - make sure complex objects have all their relevant properties recorded
-# - disallow extraction of non-files/links.
-# - guard against files much longer than they should be.
+# during extraction:
+#	$o->validate_meta($item) or
+#		error...
 
 use strict;
 use warnings;