Bug 189199

Summary: make.conf should mention WITH_OPENSSL_PORT
Product: Documentation Reporter: phoffman
Component: Books & ArticlesAssignee: Benjamin Kaduk <bjk>
Status: Closed Overcome By Events    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description phoffman 2014-05-01 15:40:00 UTC
In a recent thread on freebsd-security and freebsd-ports, it turns out that there is a very useful feature of make.conf called WITH_OPENSSL_PORT. This should be documented in the make.conf man page.

Fix: 

Proposed wording (but this needs to be checked the ports people):

WITH_OPENSSL_PORT
(bool) Causes port building to use the OpenSSL from the ports (if available) instead of the OpenSSL from base.
Comment 1 Benjamin Kaduk freebsd_committer freebsd_triage 2014-05-17 04:44:53 UTC
Responsible Changed
From-To: freebsd-doc->bjk

I have a draft patch for this issue. 

It is really a broader issue that should get a more general treatment.
Comment 2 dfilter service freebsd_committer freebsd_triage 2014-05-18 22:05:59 UTC
Author: bjk (doc committer)
Date: Sun May 18 21:05:54 2014
New Revision: 266416
URL: http://svnweb.freebsd.org/changeset/base/266416

Log:
  Document some user-settable make variables in ports.7
  
  This is not a comprehensive list, as the variables themselves are spread
  out over multiple files, but it is a start.
  
  Add a section to make.conf noting that variables may be set there that
  affect ports builds, but refer to ports.7 and elsewhere for the actual
  listing; any listing in make.conf.5 would likely become out of date
  fairly quickly.
  
  PR:		docs/189199
  Reviewed by:	bdrewery (previous version)
  Approved by:	hrs (mentor)

Modified:
  head/share/man/man5/make.conf.5
  head/share/man/man7/ports.7

Modified: head/share/man/man5/make.conf.5
==============================================================================
--- head/share/man/man5/make.conf.5	Sun May 18 19:52:36 2014	(r266415)
+++ head/share/man/man5/make.conf.5	Sun May 18 21:05:54 2014	(r266416)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 2, 2014
+.Dd May 17, 2014
 .Dt MAKE.CONF 5
 .Os
 .Sh NAME
@@ -658,6 +658,14 @@ for simple printers, or
 for postscript or graphics printers with a ghostscript
 filter, or both.
 .El
+.Ss "BUILDING PORTS"
+Several make variables can be set that affect the building of ports.
+These variables and their effects are documented in
+.Xr ports r7 ,
+.Pa ${PORTSDIR}/Mk/*
+and the
+.Fx
+Porter's Handbook.
 .Sh FILES
 .Bl -tag -width ".Pa /usr/share/examples/etc/make.conf" -compact
 .It Pa /etc/make.conf

Modified: head/share/man/man7/ports.7
==============================================================================
--- head/share/man/man7/ports.7	Sun May 18 19:52:36 2014	(r266415)
+++ head/share/man/man7/ports.7	Sun May 18 21:05:54 2014	(r266416)
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 18, 2012
+.Dd May 17, 2014
 .Dt ports r7
 .Os
 .Sh NAME
@@ -486,6 +486,44 @@ have been configured will have a uniquel
 single file
 .Pa options .
 .El
+.Sh MAKE VARIABLES
+The following list provides a name and short description for many of the
+variables that are used when building ports.
+More information on these and other related variables may be found in
+.Pa ${PORTSDIR}/Mk/*
+and the
+.Fx
+Porter's Handbook.
+.Bl -tag -width ".Va OVERRIDE_LINUX_BASE_PORT"
+.It Va WITH_OPENSSL_PORT
+.Pq Vt bool
+If set, causes ports that make use of OpenSSL to use the OpenSSL from
+ports
+.Pq if available
+instead of the OpenSSL from the base system.
+.It Va WITH_DEBUG
+.Pq Vt bool
+If set, debugging symbols are installed for ports binaries.
+.It Va WITH_DEBUG_PORTS
+A list of origins for which to set
+.Va WITH_DEBUG_PORTS .
+.It Va WITH_SSP_PORTS
+.Pq Vt bool
+If set, enables
+.Fl fstack-protector
+for most ports.
+.It Va WITH_GHOSTSCRIPT_VER
+If set, the version of ghostscript to be used by ports.
+.It Va OVERRIDE_LINUX_BASE_PORT
+The default linux base to use.
+.It Va WITH_CCACHE_BUILD
+.Pq Vt bool
+If set, enables the use of
+.Xr ccache 1
+for building ports.
+.It Va CCACHE_DIR
+Which directory to use for the ccache data.
+.El
 .Sh FILES
 .Bl -tag -width ".Pa /usr/ports/Mk/bsd.port.mk" -compact
 .It Pa /usr/ports
@@ -495,6 +533,7 @@ The big Kahuna.
 .El
 .Sh SEE ALSO
 .Xr make 1 ,
+.Xr make.conf 5 ,
 .Xr pkg 8 ,
 .Xr portsnap 8
 .Pp
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 3 Mathieu Arnold freebsd_committer freebsd_triage 2017-08-04 13:35:05 UTC
WITH_OPENSSL_PORT does not exist any more.