document the subtle tweak to Vstat that allows updates to account for

size issues accurately.

1 files changed, 7 insertions, 1 deletions

diff --git a/usr.sbin/pkg_add/pod/OpenBSD::Vstat.pod b/usr.sbin/pkg_add/pod/OpenBSD::Vstat.pod
index dac2dd65b01..d3181901796 100644
--- a/usr.sbin/pkg_add/pod/OpenBSD::Vstat.pod
+++ b/usr.sbin/pkg_add/pod/OpenBSD::Vstat.pod
@@ -1,4 +1,4 @@
-$OpenBSD: OpenBSD::Vstat.pod,v 1.2 2006/02/07 11:34:32 espie Exp $
+$OpenBSD: OpenBSD::Vstat.pod,v 1.3 2007/04/17 00:00:55 espie Exp $
 
 =head1 NAME
 
@@ -63,6 +63,12 @@ the C<$tag> specified as an optional argument. Otherwise, it returns 1.
 C<OpenBSD::Vstat:tally> displays a summary of filesystem manipulations
 after a series of additions and removals.
 
+Due to the way packages get updated, size modifications through 
+C<OpenBSD::Vstat::remove> are delayed until the next call to
+C<OpenBSD::Vstat::synchronize>: old files must be removed before
+adding the new files in order to properly account for collisions,
+but the old files occupy disk space while the new package gets extracted.
+
 =head1 CAVEATS
 
 The API to this module may change.