From owner-svn-src-head@freebsd.org Tue Mar 31 22:42:02 2020 Return-Path: Delivered-To: svn-src-head@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id CE91A26EDD4; Tue, 31 Mar 2020 22:42:02 +0000 (UTC) (envelope-from imp@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 48sPTP6h4Rz3Jvb; Tue, 31 Mar 2020 22:42:01 +0000 (UTC) (envelope-from imp@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id C3A7119F89; Tue, 31 Mar 2020 22:41:53 +0000 (UTC) (envelope-from imp@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id 02VMfr4A048283; Tue, 31 Mar 2020 22:41:53 GMT (envelope-from imp@FreeBSD.org) Received: (from imp@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id 02VMfr5O048282; Tue, 31 Mar 2020 22:41:53 GMT (envelope-from imp@FreeBSD.org) Message-Id: <202003312241.02VMfr5O048282@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: imp set sender to imp@FreeBSD.org using -f From: Warner Losh Date: Tue, 31 Mar 2020 22:41:53 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r359496 - head/share/man/man7 X-SVN-Group: head X-SVN-Commit-Author: imp X-SVN-Commit-Paths: head/share/man/man7 X-SVN-Commit-Revision: 359496 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 31 Mar 2020 22:42:03 -0000 Author: imp Date: Tue Mar 31 22:41:53 2020 New Revision: 359496 URL: https://svnweb.freebsd.org/changeset/base/359496 Log: Document universe better Document the kernels and worlds targets. Document the TARGETS and EXTRA_TARGETS variables. Reviewed by: brooks, bdrewery, emaste (LGTM) MFC After: 3 days Differential Revision: https://reviews.freebsd.org/D24212 Modified: head/share/man/man7/build.7 Modified: head/share/man/man7/build.7 ============================================================================== --- head/share/man/man7/build.7 Tue Mar 31 22:41:48 2020 (r359495) +++ head/share/man/man7/build.7 Tue Mar 31 22:41:53 2020 (r359496) @@ -289,6 +289,18 @@ for all kernels for that architecture, including .Pa LINT . This command takes a long time. +.It Cm kernels +Like +.Cm universe +with +.Va WITHOUT_WORLDS +defined so only the kernels for each architecture are built. +.It Cm worlds +Like +.Cm universe +with +.Va WITHOUT_KERNELS +defined so only the worlds for each architecture are built. .It Cm update Get updated sources as configured in .Xr make.conf 5 . @@ -761,7 +773,7 @@ The default action is to build documentation for all l .Pp Builds using the .Cm universe -target are influenced by the following +and related targets are influenced by the following .Xr make 1 variables: .Bl -tag -width ".Va MAKE_JUST_KERNELS" @@ -786,6 +798,15 @@ target for each supported architecture instead of the building a world and one or more kernels. This variable implies .Va WITHOUT_KERNELS . +.It Va TARGETS +Only build the listed targets instead of each supported architecture. +.It Va EXTRA_TARGETS +In addition to the supported architectures, build the semi-supported +architectures. +A semi-supported architecture has build support in the +.Fx +tree, but receives significantly less testing and is generally for +fringe uses that do not have a wide appeal. .El .Sh FILES .Bl -tag -width ".Pa /usr/share/examples/etc/make.conf" -compact