Fwd: docs/178286: [PATCH] document the LOCAL_* vars in build(7)

[Brooks Davis]

On Wed, May 01, 2013 at 02:35:17PM -0700, Garrett Cooper wrote:
> Hi Brooks and Joel,
>     I'd really appreciate if you guys could help out with this. I'm
> having to fix the Isilon build system due to severe lack of
> documentation in build(7). So many mistakes have been made because
> people don't understand how to write FreeBSD Makefiles...

One minor concern I have with this patch is documenting LOCAL_LIB_DIRS.
I've not posted to the lists yet, but now that I understand buildworld
better, I think I implemented it wrong.  It should have required that
the directories be also be listed in LOCAL_DIRS.  The reason is that you
could then have LOCAL_DIRS=foo and LOCAL_LIB_DIRS=foo/lib so you only
added one directory to the FreeBSD tree but could still have libs.  I
feared that someone might have started using this feature which would
mean we can't easily change that.  Is Isilon using it?

-- Brooks