Module Name: src
Committed By: jmmv
Date: Sat Jun 26 11:26:17 UTC 2010
Modified Files:
src/share/man/man7: tests.7
src/share/man/man8: afterboot.8
Log Message:
Move testing instructions from afterboot(8) to tests(7) and change the
former to only provide a link to the latter.
To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/share/man/man7/tests.7
cvs rdiff -u -r1.46 -r1.47 src/share/man/man8/afterboot.8
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man7/tests.7
diff -u src/share/man/man7/tests.7:1.1 src/share/man/man7/tests.7:1.2
--- src/share/man/man7/tests.7:1.1 Sat Jun 26 11:15:27 2010
+++ src/share/man/man7/tests.7 Sat Jun 26 11:26:17 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: tests.7,v 1.1 2010/06/26 11:15:27 jmmv Exp $
+.\" $NetBSD: tests.7,v 1.2 2010/06/26 11:26:17 jmmv Exp $
.\"
.\" Copyright (c) 2010 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -91,6 +91,18 @@
third-party packages or manual modifications to configuration files) do not
introduce unexpected failures.
.El
+.Ss Installing the tests
+If you chose to install the
+.Pa tests.tgz
+distribution set while setting up your
+.Nx
+system, the tests are already available in
+.Pa /usr/tests .
+Otherwise, install the set now by running:
+.Bd -literal -offset indent
+# cd /
+# tar xzpf /path/to/tests.tgz
+.Ed
.Ss Running the tests
Use the following commands to run the whole test suite:
.Bd -literal -offset indent
@@ -155,6 +167,30 @@
Specifies the name of a local, unprivileged user, that will be used by those
tests that need to perform checks as non-root.
.El
+.Ss What to do if something fails?
+If there is
+.Em any failure
+during the execution of the test suite, please considering reporting it to the
+.Nx
+developers so that the failure can be analyzed and fixed.
+To do so, either send a message to the appropriate mailing list or file a
+problem report.
+For more details please refer to:
+.Bl -bullet -offset indent -compact
+.It
+.Pa http://www.netbsd.org/mailinglists/
+.It
+.Pa http://www.netbsd.org/support/send-pr.html
+.El
+.Sh FILES
+.Bl -tag -compact -width etcXatfXNetBSDXconfXX
+.It Pa /etc/atf/NetBSD.conf
+Configuration file for the
+.Nx
+test suite.
+.It Pa /usr/tests/
+Location of the test suites.
+.El
.Sh SEE ALSO
.Xr atf 7
.Sh HISTORY
Index: src/share/man/man8/afterboot.8
diff -u src/share/man/man8/afterboot.8:1.46 src/share/man/man8/afterboot.8:1.47
--- src/share/man/man8/afterboot.8:1.46 Wed Feb 17 00:49:21 2010
+++ src/share/man/man8/afterboot.8 Sat Jun 26 11:26:17 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: afterboot.8,v 1.46 2010/02/17 00:49:21 snj Exp $
+.\" $NetBSD: afterboot.8,v 1.47 2010/06/26 11:26:17 jmmv Exp $
.\" $OpenBSD: afterboot.8,v 1.72 2002/02/22 02:02:33 miod Exp $
.\"
.\" Originally created by Marshall M. Midden -- 1997-10-20, m...@umn.edu
@@ -59,7 +59,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd January 20, 2010
+.Dd June 26, 2010
.Dt AFTERBOOT 8
.Os
.Sh NAME
@@ -956,45 +956,10 @@
At this point, the system should be fully configured to your liking.
It is now a good time to ensure that the system behaves according to
its specifications and that it is stable on your hardware.
-You can easily do so by running the test suites available at
-.Pa /usr/tests/ ,
-assuming that you installed the
-.Pa tests.tgz
-set.
-If not, you can install it now by running:
-.Bd -literal -offset indent
-# cd /
-# tar xzpf /path/to/tests.tgz
-.Ed
-.Pp
-Once done, edit the
-.Pa /etc/atf/NetBSD.conf
-file to tune the configuration of the test suite, go to
-.Pa /usr/tests/
-hierarchy and use the
-.Xr atf-run 1
-and
-.Xr atf-report 1
-utilities to run all the tests in an automated way:
-.Bd -literal -offset indent
-# cd /usr/tests/
-# atf-run | atf-report
-.Ed
-.Pp
-Should any problems appear when running the test suite, please let the
-.Nx
-developers know by sending a message to the appropriate mailing list or
-by sending a problem report.
-For more details see:
-.Bl -bullet -offset indent
-.It
-.Pa http://www.netbsd.org/mailinglists/
-.It
-.Pa http://www.netbsd.org/support/send-pr.html
-.El
+Please refer to
+.Xr tests 7
+for details on how to do so.
.Sh SEE ALSO
-.Xr atf-report 1 ,
-.Xr atf-run 1 ,
.Xr chgrp 1 ,
.Xr chmod 1 ,
.Xr config 1 ,
@@ -1035,6 +1000,7 @@
.Xr hier 7 ,
.Xr hostname 7 ,
.Xr pkgsrc 7 ,
+.Xr tests 7 ,
.Xr amd 8 ,
.Xr ccdconfig 8 ,
.Xr chown 8 ,
