Bug 194306

Summary: Options missing from manpage ports.7
Product: Documentation Reporter: Daan K. <daanknip>
Component: Manual PagesAssignee: Mateusz Piotrowski <0mp>
Status: Closed FIXED    
Severity: Affects Many People CC: 0mp, bjk, doc
Priority: ---    
Version: Latest   
Hardware: amd64   
OS: Any   

Description Daan K. 2014-10-11 19:36:03 UTC
The new make.conf options described here:

https://lists.freebsd.org/pipermail/freebsd-ports-announce/2013-June/000062.html

Are not yet in the manpage for make.conf.
Comment 1 Daan K. 2014-10-11 19:36:31 UTC
Version: 10.1-RC1
Comment 2 Benjamin Kaduk freebsd_committer freebsd_triage 2014-10-17 02:48:16 UTC
make.conf.5 contains the following section:

   BUILDING PORTS
     Several make variables can be set that affect the building of ports.
     These variables and their effects are documented in ports(7),
     ${PORTSDIR}/Mk/* and the FreeBSD Porter's Handbook.

make.conf.5 is not the most appropriate place to document variables like OPTIONS_SET which only affect ports builds.  The particular variables in question are probably appropriate for ports.7, though, so I have retitled accordingly.
Comment 3 Daan K. 2014-10-29 12:32:06 UTC
(In reply to Benjamin Kaduk from comment #2)
> make.conf.5 contains the following section:
> 
>    BUILDING PORTS
>      Several make variables can be set that affect the building of ports.
>      These variables and their effects are documented in ports(7),
>      ${PORTSDIR}/Mk/* and the FreeBSD Porter's Handbook.
> 
> make.conf.5 is not the most appropriate place to document variables like
> OPTIONS_SET which only affect ports builds.  The particular variables in
> question are probably appropriate for ports.7, though, so I have retitled
> accordingly.

Thanks for clearing that up, as I am fairly new to FreeBSD I didn't know about the FreeBSD Porter's Handbook. :)
Comment 4 Mateusz Piotrowski freebsd_committer freebsd_triage 2019-09-21 15:02:26 UTC
Whoops, I did not mean to close it just yet. Sorry.
Comment 5 Mateusz Piotrowski freebsd_committer freebsd_triage 2020-06-08 00:20:47 UTC
Return the issue to the pool.
Comment 6 commit-hook freebsd_committer freebsd_triage 2020-11-03 13:26:23 UTC
A commit references this bug:

Author: 0mp
Date: Tue Nov  3 13:26:00 UTC 2020
New revision: 367295
URL: https://svnweb.freebsd.org/changeset/base/367295

Log:
  Document how to set ports options via make.conf(5)

  This patch is based on:
  - https://lists.freebsd.org/pipermail/freebsd-ports-announce/2013-June/000062.html
  - current content of /usr/ports/Mk/bsd.options.mk

  PR:		194306
  Reported by:	Daan K. <daanknip__hotmail_com>
  MFC after:	2 weeks

Changes:
  head/share/man/man7/ports.7