Module Name: src
Committed By: jruoho
Date: Fri May 18 15:36:21 UTC 2012
Modified Files:
src/tests: README
Log Message:
Clarify this a little.
To generate a diff of this commit:
cvs rdiff -u -r1.3 -r1.4 src/tests/README
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/tests/README
diff -u src/tests/README:1.3 src/tests/README:1.4
--- src/tests/README:1.3 Mon Feb 13 08:55:20 2012
+++ src/tests/README Fri May 18 15:36:21 2012
@@ -1,11 +1,20 @@
-$NetBSD: README,v 1.3 2012/02/13 08:55:20 wiz Exp $
+$NetBSD: README,v 1.4 2012/05/18 15:36:21 jruoho Exp $
-When adding new tests, please try to follow the directory structure of
-the real source tree. For instance, interfaces available via the C library
-should follow:
+When adding new tests, please try to follow the following conventions.
+
+1. For library routines, including system calls, the directory structure of
+ the tests should follow the directory structure of the real source tree.
+ For instance, interfaces available via the C library should follow:
src/lib/libc/gen -> src/tests/lib/libc/gen
src/lib/libc/sys -> src/tests/lib/libc/sys
+ ...
+
+2. Equivalently, all tests for userland utilities should try to follow their
+ location in the source tree. If this can not be satisfied, the tests for
+ a utility should be located under the directory to which the utility is
+ installed. Thus, a test for env(1) should go to src/tests/usr.bin/env.
+ Likewise, a test for tcpdump(8) should be in src/tests/usr.sbin/tcpdump,
+ even though the source code for the program is located under src/external.
-Equivalently, tests for a program residing in src/usr.bin/program should be
-added to the src/tests/usr.bin/program subdirectory.
+3. Otherwise use your own discretion.
