Makefiles for skip-level directories?

[Garrett Cooper]

On Wed, Apr 2, 2014 at 2:38 PM, Julio Merino <jmmv at freebsd.org> wrote:
> On Mon, Mar 31, 2014 at 7:07 PM, Peel, Casey <casey.peel at isilon.com> wrote:
>>> In a thread in January, we agreed not to put any tests in sys/.
>>> Instead, we'll put them in tests/sys.  Take a look at
>>> tests/sys/netinet; you can probably copy its structure for your tests.
>>
>> Ah, that helped, thanks. I was able to get them working in test/sys/.
>>
>>> The magic to install intermediate Kyuafiles lives in the 'tests'
>>> subdirectory corresponding to where they are installed!  See
>>> src/bin/tests/Makefile, for example.
>>
>> Thanks, but that's about as clear as mud. Is the "magic" the KYUAFILE=yes line? When is this required and when isn't it? Where is the documentation on its usage?
>
> The *.test.mk files in share/mk/ are reasonably documented.  The
> share/mk/README file also includes a few words on bsd.test.mk.  There
> are also heavily commented examples in
> /usr/src/share/examples/tests/tests/ .  And there is also
> https://wiki.freebsd.org/TestSuite/DeveloperHowTo .
>
> Please let me know where the documentation above is lacking and/or how
> to make it more discoverable.

    As a very brief sidenote, the Kyuafile that handles autodiscovery
in FreeBSD head lives under src/test/Kyuafile ; it automatically gets
installed when make install is run from src/tests .
Cheers!
-Garrett