Download raw body.
pkg_add.1: improve clarity for -U
On 2025 May 02 (Fri) at 11:53:19 +0200 (+0200), Kirill A. Korinsky wrote: :On Fri, 02 May 2025 11:28:47 +0200, :Stuart Henderson <stu@spacehopper.org> wrote: :> :> On 2025/05/01 21:56, Josh Grosse wrote: :> > For consideration. :> :> > diff --git usr.sbin/pkg_add/pkg_add.1 usr.sbin/pkg_add/pkg_add.1 :> > index 67be4b80179..17b3fc12687 100644 :> > --- usr.sbin/pkg_add/pkg_add.1 :> > +++ usr.sbin/pkg_add/pkg_add.1 :> > @@ -109,7 +109,9 @@ with :> > .Fl u :> > whenever possible, but :> > .Fl U :> > -can be much faster. :> > +can be much faster, and is intended for use when running -current, if :> > +a new package needs to be added without conducting a full update of all :> > +packages. :> > .It :> > Replace existing packages with explicit other versions, using option :> > .Fl r . :> :> -U is a bit of a hack and I think mostly useful for ports developers. :> :> Diff below gives a better reason *not* to use it. :> :> Perhaps pkg_add should reject -Uu, afaict it is meaningless, and there :> is some meme which won't go away about running -Uu for updates. :> :> Bonus -u -> .Fl u fix. :> : :Cleaner wording, indeed! : :Meanwhile, I was able to backtrace the source why so many people uses -U. I :don't belive that all of them read man page and decided to speedup things. : :Long story short: I almost sure that the root cause this page: :https://www.openbsdhandbook.com/upgrade/ : Their sysmerge recommendation is also broken, and the OS install section is suspect. The networking section is also bad, most especially the Wireless section. Yuck, I hope this site gets fixed. -- You will be a winner today. Pick a fight with a four-year-old.
pkg_add.1: improve clarity for -U