Deleted Added
full compact
README (257097) README (260013)
1src/tests: The FreeBSD test suite
2=================================
3
4This file describes the build infrastructure of the FreeBSD test suite.
5If you are only interested in using the test suite itself, please refer
6to tests(7) instead.
7
8The build of the test suite is organized in the following manner:

--- 30 unchanged lines hidden (view full) ---

39
40In order to keep the src/tests/ hierarchy decoupled from the actual test
41programs being installed --which is a worthy goal because it simplifies
42the addition of new test programs and simplifies the maintenance of the
43tree-- the top-level Kyuafile does not know which subdirectories may
44exist upfront. Instead, such Kyuafile automatically detects, at
45run-time, which */Kyuafile files exist and uses those directly.
46
1src/tests: The FreeBSD test suite
2=================================
3
4This file describes the build infrastructure of the FreeBSD test suite.
5If you are only interested in using the test suite itself, please refer
6to tests(7) instead.
7
8The build of the test suite is organized in the following manner:

--- 30 unchanged lines hidden (view full) ---

39
40In order to keep the src/tests/ hierarchy decoupled from the actual test
41programs being installed --which is a worthy goal because it simplifies
42the addition of new test programs and simplifies the maintenance of the
43tree-- the top-level Kyuafile does not know which subdirectories may
44exist upfront. Instead, such Kyuafile automatically detects, at
45run-time, which */Kyuafile files exist and uses those directly.
46
47Similarly, every category subdirectory within src/tests/ provides the
48same Kyuafile with auto-discovery features. For example: src/tests/lib/
49holds a generic Makefile to install test-suite related material but such
50directory does not know upfront which libraries within src/lib/ will
51install tests. For this reason, the Kyuafile in src/tests/lib/ has to
52also use the auto-discovery features. The same applies for any other
53category subdirectory (e.g. bin, usr.sbin, etc.).
47Similarly, every directory in src/ that wants to install a Kyuafile to
48just recurse into other subdirectories reuses this Kyuafile with
49auto-discovery features. As an example, take a look at src/lib/tests/
50whose sole purpose is to install a Kyuafile into /usr/tests/lib/.
51The goal in this specific case is for /usr/tests/lib/ to be generated
52entirely from src/lib/.
54
55--
53
54--
56$FreeBSD: head/tests/README 257097 2013-10-25 05:25:19Z rpaulo $
55$FreeBSD: stable/10/tests/README 260013 2013-12-28 20:05:31Z jmmv $