From owner-svn-src-all@FreeBSD.ORG Sun Apr 13 11:35:43 2014 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 09F19110; Sun, 13 Apr 2014 11:35:43 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id CF88414FB; Sun, 13 Apr 2014 11:35:42 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s3DBZg7e005486; Sun, 13 Apr 2014 11:35:42 GMT (envelope-from jmmv@svn.freebsd.org) Received: (from jmmv@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s3DBZgbn005482; Sun, 13 Apr 2014 11:35:42 GMT (envelope-from jmmv@svn.freebsd.org) Message-Id: <201404131135.s3DBZgbn005482@svn.freebsd.org> From: Julio Merino Date: Sun, 13 Apr 2014 11:35:42 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r264410 - head/share/man/man7 X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 13 Apr 2014 11:35:43 -0000 Author: jmmv Date: Sun Apr 13 11:35:42 2014 New Revision: 264410 URL: http://svnweb.freebsd.org/changeset/base/264410 Log: Document how to install the test suite. As part of this, install the tests(7) manual page unconditionally (not only when WITH_TESTS=yes) so that users that have not yet enabled the build of the test suite can read details on how to do so. Modified: head/share/man/man7/Makefile head/share/man/man7/tests.7 Modified: head/share/man/man7/Makefile ============================================================================== --- head/share/man/man7/Makefile Sun Apr 13 11:31:41 2014 (r264409) +++ head/share/man/man7/Makefile Sun Apr 13 11:35:42 2014 (r264410) @@ -27,12 +27,9 @@ MAN= adding_user.7 \ sprog.7 \ stdint.7 \ sticky.7 \ + tests.7 \ tuning.7 -.if ${MK_TESTS} != "no" -MAN+= tests.7 -.endif - MLINKS= intro.7 miscellaneous.7 MLINKS+= security.7 securelevel.7 MLINKS+= c99.7 c.7 Modified: head/share/man/man7/tests.7 ============================================================================== --- head/share/man/man7/tests.7 Sun Apr 13 11:31:41 2014 (r264409) +++ head/share/man/man7/tests.7 Sun Apr 13 11:35:42 2014 (r264410) @@ -26,7 +26,7 @@ .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd March 20, 2014 +.Dd April 13, 2014 .Dt TESTS 7 .Os .Sh NAME @@ -50,12 +50,31 @@ maintenance. .Pp The .Fx -test suite is installed in the +test suite can be found in the .Pa /usr/tests hierarchy. .Pp This manual page describes how to run the test suite and how to configure some of its optional features. +.Ss Installing the test suite +The test suite is not yet installed by default as part of +.Fx , +but this is bound to change during the development of +.Fx 11.0 . +.Pp +If the +.Pa /usr/tests +directory is missing, then you will have to enable the build of the test +suite, rebuild your system and install the results. +You can do so by setting +.Sq WITH_TESTS=yes +in your +.Pa /etc/src.conf +file (see +.Xr src.conf 5 +for details) +and rebuilding the system as described in +.Xr build 7 . .Ss When to run the tests? Before diving into the details of how to run the test suite, here are some scenarios in which you should run it: @@ -197,7 +216,8 @@ test suite. Top-level test suite definition file. .El .Sh SEE ALSO -.Xr kyua 1 . +.Xr kyua 1 , +.Xr build 7 .Sh HISTORY This test suite first appeared in .Fx 11.0 .