svn commit: r341343 - head/share/man/man7

[Warner Losh]

On Fri, Nov 30, 2018 at 9:24 AM Bjoern A. Zeeb <
bzeeb-lists at lists.zabbadoz.net> wrote:

> On 30 Nov 2018, at 15:56, Edward Tomasz Napierala wrote:
>
> > Author: trasz
> > Date: Fri Nov 30 15:56:14 2018
> > New Revision: 341343
> > URL: https://svnweb.freebsd.org/changeset/base/341343
> >
> > Log:
> >   Add an example of rebuilding a single piece of userspace.
> >
> > Modified:
> >   head/share/man/man7/development.7
> >
> > Modified: head/share/man/man7/development.7
> >
> ==============================================================================
> > --- head/share/man/man7/development.7 Fri Nov 30 15:52:03
> > 2018  (r341342)
> > +++ head/share/man/man7/development.7 Fri Nov 30 15:56:14
> > 2018  (r341343)
> > @@ -118,6 +118,14 @@ After reboot:
> >  cd src
> >  make -j8 installworld
> >  reboot
> > +.Ed
> > +.Pp
> > +Rebuild and reinstall a single piece of userspace, in this
> > +case
> > +.Xr ls 1 :
> > +.Bd -literal -offset indent
> > +cd src/bin/ls
> > +make clean all install
>
> I always thought the proper sequence was:  make clean cleandepend obj
> depend all install
>
> However I have recently figured that it’s not actually true as
> building inside an individual user space source directory seems to pick
> up headers etc from the installed machine and not from the source tree.
> I keep arguing with myself if that had always been the case or not..  I
> am sure some people here do know better than me (so please see this as
> asking for help/advise).
>

obj and depend are now optional (they are now reconstructed the first time
something builds), but used to be required though sometime in the 9.x/10.x
series. Except for on super-weird case involving FS level corruption, I've
never needed these targets since the cut-over.

cleandepend may be required in some weird edge cases, but it's rarely
needed that you can omit it most of the time. It used to be required
whenever the dependencies changed as part of the build. That's mostly, but
not entirely, fixed today.

Warner