Makefiles for skip-level directories?

[Julio Merino]

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.

Cheers