svn commit: r325080 - in head: . share/man/man7

[Bryan Drewery]

Author: bdrewery
Date: Sun Oct 29 01:21:22 2017
New Revision: 325080
URL: https://svnweb.freebsd.org/changeset/base/325080

Log:
  build(7): Document native-xtools.
  
  MFC after:	2 weeks
  Sponsored by:	Dell EMC Isilon

Modified:
  head/Makefile
  head/share/man/man7/build.7

Modified: head/Makefile
==============================================================================
--- head/Makefile	Sun Oct 29 01:21:19 2017	(r325079)
+++ head/Makefile	Sun Oct 29 01:21:22 2017	(r325080)
@@ -39,7 +39,9 @@
 # xdev-install        - Install cross-development tools.
 # xdev-links          - Create traditional links in /usr/bin for cc, etc
 # native-xtools       - Create host binaries that produce target objects
-#                       for use in qemu user-mode jails.
+#                       for use in qemu user-mode jails.  Override
+#                       target location with NXBDESTDIR.  TARGET and
+#                       TARGET_ARCH should be defined.
 # 
 # "quick" way to test all kernel builds:
 # 	_jflag=`sysctl -n hw.ncpu`

Modified: head/share/man/man7/build.7
==============================================================================
--- head/share/man/man7/build.7	Sun Oct 29 01:21:19 2017	(r325079)
+++ head/share/man/man7/build.7	Sun Oct 29 01:21:22 2017	(r325080)
@@ -222,6 +222,18 @@ variable
 .Va DISTDIR .
 This target is used while building a release; see
 .Xr release 7 .
+.It Cm native-xtools
+This target builds a cross-toolchain for the given
+.Sy TARGET
+and
+.Sy TARGET_ARCH ,
+as well as a select list of static userland tools for the host system.
+This is intended to be used in a jail where QEMU is used to improve
+performance by avoiding emulating binaries that do not need to be emulated.
+.Sy TARGET
+and
+.Sy TARGET_ARCH
+should be defined.
 .It Cm packageworld
 Archive the results of
 .Cm distributeworld ,