cvs commit: src/usr.bin/make make.1

[Ruslan Ermilov]

On Thu, Oct 13, 2005 at 05:54:54PM +0400, Yar Tikhiy wrote:
> On Wed, Oct 12, 2005 at 03:53:13PM -0600, M. Warner Losh wrote:
> > In message: <200510121440.15780.jhb at freebsd.org>
> >             John Baldwin <jhb at FreeBSD.org> writes:
> > : make(1) does honor some special environment variables like MAKEOBJDIRPREFIX, 
> > : but __MAKE_CONF is not one of them.  It is handled in sys.mk, not in the 
> > : make(1) program itself.
> > 
> > We've already wasted too much time on this bikeshed...
> > 
And we've been discussing with Yar how this can be improved
before this bikeshed ever started.

> No problem, __MAKE_CONF mentioned will be among other improvements
> to the make(1) page that are to be committed in a day or two.
> Ruslan doesn't object to it since now __MAKE_CONF will be described
> in an apparent connection to sys.mk.
> 
One idea was to add a sys.mk(7) manpage documenting what it
does, but I thought it was an overkill given a relatively
small amount of information that could be put there.
Documenting (briefly) what the standard FreeBSD sys.mk file
does in a separate section in the make(1) manpage shouldn't
be a problem, but in this case I insist it should be made
clear this is specific to FreeBSD and not the make(1) itself.
Having /etc/make.conf included with every make(1) run is a
design bug.  It's a bug because the implementation doesn't
match the goal.  The goal (as advertised in the make.conf
manpage) is to "contain settings that control the compilation
of the FreeBSD sources and ported applications" and "it is
included by the various makefiles in /usr/src, /usr/ports
and /usr/doc".  I mean, the visibility of /etc/make.conf
would better be constrained by src/, ports/, and doc/
makefiles, not the universe under the control of FreeBSD.
I think it's too late to change that, so we'll have to
live with this backward compatibility bug or come up
with a better replacement.  NetBSD, for example, that
has a very elegant build system, doesn't suffer from this
bug.  They only include their mk.conf for system builds.


Cheers,
-- 
Ruslan Ermilov
ru at FreeBSD.org
FreeBSD committer
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/cvs-src/attachments/20051013/3c3b9769/attachment.bin