From nobody@FreeBSD.org  Thu May  1 14:39:01 2014
Return-Path: <nobody@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 E406E9F5
	for <freebsd-gnats-submit@FreeBSD.org>; Thu,  1 May 2014 14:39:01 +0000 (UTC)
Received: from cgiserv.freebsd.org (cgiserv.freebsd.org [IPv6:2001:1900:2254:206a::50:4])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(Client did not present a certificate)
	by mx1.freebsd.org (Postfix) with ESMTPS id D167E12C4
	for <freebsd-gnats-submit@FreeBSD.org>; Thu,  1 May 2014 14:39:01 +0000 (UTC)
Received: from cgiserv.freebsd.org ([127.0.1.6])
	by cgiserv.freebsd.org (8.14.8/8.14.8) with ESMTP id s41Ed1jL040815
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 1 May 2014 14:39:01 GMT
	(envelope-from nobody@cgiserv.freebsd.org)
Received: (from nobody@localhost)
	by cgiserv.freebsd.org (8.14.8/8.14.8/Submit) id s41Ed1wL040808;
	Thu, 1 May 2014 14:39:01 GMT
	(envelope-from nobody)
Message-Id: <201405011439.s41Ed1wL040808@cgiserv.freebsd.org>
Date: Thu, 1 May 2014 14:39:01 GMT
From: Paul Hoffman <phoffman@proper.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: make.conf should mention WITH_OPENSSL_PORT
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         189199
>Category:       docs
>Synopsis:       make.conf should mention WITH_OPENSSL_PORT
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bjk
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu May 01 14:40:00 UTC 2014
>Closed-Date:    
>Last-Modified:  Sun May 18 21:10:01 UTC 2014
>Originator:     Paul Hoffman
>Release:        9.2
>Organization:
>Environment:
FreeBSD labbackup.proper.com 9.2-RELEASE-p5 FreeBSD 9.2-RELEASE-p5 #0: Tue Apr 29 18:53:19 UTC 2014     root@amd64-builder.daemonology.net:/usr/obj/usr/src/sys/GENERIC  i386
>Description:
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.
>How-To-Repeat:

>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.

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->bjk 
Responsible-Changed-By: bjk 
Responsible-Changed-When: Sat May 17 03:44:53 UTC 2014 
Responsible-Changed-Why:  
I have a draft patch for this issue. 

It is really a broader issue that should get a more general treatment. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=189199 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/189199: commit references a PR
Date: Sun, 18 May 2014 21:05:59 +0000 (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 7 ,
 +.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 7
  .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"
 
>Unformatted:
