On 2026/06/04 21:07, furyinbox@gmail.com wrote:
> 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.

While maybe the manuals could give more of a clue about where to find
these scripts, this doesn't seem a good way to do it, it still doesn't
say where to find them, and surely it's self evident that you need the
ports tree to be able to build the ports tree?

> 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.

you will also need internet to run dpb to build (i.e. to fetch the
distfiles), also btw - proot is handy if you need to build in a chroot
jail (e.g. running dpb on a non-dedicated machine), but dpb can be used
perfectly well without it.