README (f9b2a21c9eb4d2715be82dc9049eae29fdb40d17) | README (cc21b86f50a0eb078c5d42c7ddffbc7ac6dae6e0) |
---|---|
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-- 56$FreeBSD$ | 53 54-- 55$FreeBSD$ |