initial docs for COMPILER_WRAPPER and COMPILER_LINKS
authorsthen <sthen@openbsd.org>
Mon, 5 Jun 2017 21:54:07 +0000 (21:54 +0000)
committersthen <sthen@openbsd.org>
Mon, 5 Jun 2017 21:54:07 +0000 (21:54 +0000)
share/man/man5/bsd.port.mk.5

index 35c5cae..fd85ed1 100644 (file)
@@ -1,4 +1,4 @@
-.\" $OpenBSD: bsd.port.mk.5,v 1.459 2017/05/31 10:06:02 jmc Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.460 2017/06/05 21:54:07 sthen Exp $
 .\"
 .\" Copyright (c) 2000-2008 Marc Espie
 .\"
@@ -24,7 +24,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 $Mdocdate: May 31 2017 $
+.Dd $Mdocdate: June 5 2017 $
 .Dt BSD.PORT.MK 5
 .Os
 .Sh NAME
@@ -1300,6 +1300,22 @@ to select, e.g.,
 from gcc 4.9 while having clang from base.
 See also
 .Ev CHOSEN_COMPILER .
+.It Ev COMPILER_LINKS
+Used by
+.Nm
+and compiler
+.Ev MODULES
+to build scripts in ${WRKDIR}/bin to force setting compiler flags
+(-B is required for clang to find ${WRKDIR}/bin/ld as used by
+.Ev USE_WXNEEDED )
+and call
+.Ev COMPILER_WRAPPER
+if used.
+.It Ev COMPILER_WRAPPER
+External program used to "wrap" compilers.
+Populated automatically by
+.Ev USE_CCACHE
+or can be set explicitly for other purposes (e.g. distcc).
 .It Ev CONFIG_SITE_LIST
 Used when
 .Li CONFIGURE_STYLE=gnu ,