--- a/doc/makefile-variables.txt	Mon May 16 14:46:20 2016 +0200
+++ b/doc/makefile-variables.txt	Fri May 20 17:42:29 2016 -0400
@@ -110,6 +110,11 @@
   name substituted for "foo".  This likewise should be near the top of any
   Makefile, just below the various COMPONENT_foo definitions, and it must
   also be before the inclusion of ips.mk .
+* PKGREPO_REMOVE_BEFORE_PUBLISH allows automatic removal of previously
+  published components from PKG_REPO (including obsolete and renamed
+  versions). When set as PKGREPO_REMOVE_BEFORE_PUBLISH=yes removal
+  occurs immediately prior to pkgsend. default: "no"
+
 
 ---