[src/trunk]: src/share/man Move testing instructions from afterboot(8) to tes...

[jmmv <jmmv%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/8d9972747ec0
branches:  trunk
changeset: 755879:8d9972747ec0
user:      jmmv <jmmv%NetBSD.org@localhost>
date:      Sat Jun 26 11:26:17 2010 +0000

description:
Move testing instructions from afterboot(8) to tests(7) and change the
former to only provide a link to the latter.

diffstat:

 share/man/man7/tests.7     |  38 +++++++++++++++++++++++++++++++++++++-
 share/man/man8/afterboot.8 |  46 ++++++----------------------------------------
 2 files changed, 43 insertions(+), 41 deletions(-)

diffs (134 lines):

diff -r db599e20d8d8 -r 8d9972747ec0 share/man/man7/tests.7
--- a/share/man/man7/tests.7    Sat Jun 26 11:15:59 2010 +0000
+++ b/share/man/man7/tests.7    Sat Jun 26 11:26:17 2010 +0000
@@ -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
diff -r db599e20d8d8 -r 8d9972747ec0 share/man/man8/afterboot.8
--- a/share/man/man8/afterboot.8        Sat Jun 26 11:15:59 2010 +0000
+++ b/share/man/man8/afterboot.8        Sat Jun 26 11:26:17 2010 +0000
@@ -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, m4%umn.edu@localhost
@@ -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 ,