document -X

infrastructure/man/man1/dpb.1

@@ -1,4 +1,4 @@
-.\"	$OpenBSD: dpb.1,v 1.59 2013/01/06 18:21:52 espie Exp $
+.\"	$OpenBSD: dpb.1,v 1.60 2013/01/07 11:04:25 espie Exp $
 .\"
 .\" Copyright (c) 2010 Marc Espie <espie@openbsd.org>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: January 6 2013 $
+.Dd $Mdocdate: January 7 2013 $
 .Dt DPB 1
 .Os
 .Sh NAME
@@ -39,6 +39,7 @@
 .Op Fl M Ar threshold
 .Op Fl P Ar pathlist
 .Op Fl S Ar sizefile
+.Op Fl X Ar pathlist
 .Op Ar pathlist ...
 .Ek
 .Sh DESCRIPTION
@@ -471,6 +472,15 @@ even if the new package apparently didn't change.
 .It Fl x
 No tty report, only report really important things, like hosts going down
 and coming back up, build errors, or builds not progressing.
+.It Fl X Ar pathlist
+Read a list of
+.Xr pkgpath 7
+from file, and pass them along in the junk phase:
+those are packages that should stay on the machine if they've been
+installed by a dependency.
+Can be used to avoid endlessly removing/reinstalling the most common
+packages, e.g.,
+.Pa devel/gmake .
 .El
 .Pp
 .Nm