Index | Thread | Search

From:
furyinbox@gmail.com
Subject:
Update man pages for proot and dpb
To:
tech@openbsd.org
Date:
Thu, 04 Jun 2026 21:07:33 +1000

Download raw body.

Thread
hey guys,
I'm exploring OpenBSD and I often use it without internet connection so
I explore it via man pages mostly.

I found out about proot.1 and dpb.1 but I couldn't run them and couldn't
find them on my machine. I went through mail archives and found this [1]
thread about moving some of the ports manpages into the base system.
In that conversation Ingo Schwarze suggested a nice disclaimer that I
believe could've helped me to figure out that these tools are in ports
tree somewhere.

Below is a patch that basically does what Ingo suggested, except I chose
CAVEATS section for this instead of the suggested SEE ALSO.
Let me know what do you think (and let me know if I attached the diff wrong).

[1] https://marc.info/?l=openbsd-ports&m=152986644217871&w=2

diff --git share/man/man1/dpb.1 share/man/man1/dpb.1
index 2e5d34940cb..f4d65e95c9a 100644
--- share/man/man1/dpb.1
+++ share/man/man1/dpb.1
@@ -1806,3 +1806,7 @@ This version is a complete rewrite from scratch using all the stuff
 we learnt over the years to make it better.
 .Sh AUTHORS
 .An Marc Espie Aq Mt espie@openbsd.org
+.Sh CAVEATS
+Using this utility requires the ports tree to be installed; see
+.Lk https://www.openbsd.org/faq/ports/ports.html
+for details.
diff --git share/man/man1/proot.1 share/man/man1/proot.1
index 3e68e41a991..002cd710d21 100644
--- share/man/man1/proot.1
+++ share/man/man1/proot.1
@@ -300,3 +300,7 @@ already have correct owners.
 .Xr chroot 8
 .Sh AUTHORS
 .An Marc Espie Aq Mt espie@openbsd.org
+.Sh CAVEATS
+Using this utility requires the ports tree to be installed; see
+.Lk https://www.openbsd.org/faq/ports/ports.html
+for details.