git: e2cf718062cc - main - ports.7: Document test target

The branch main has been updated by patmaddox:

URL: https://cgit.FreeBSD.org/src/commit/?id=e2cf718062ccabb20601f8051848f3ab5f28ba2b

commit e2cf718062ccabb20601f8051848f3ab5f28ba2b
Author:     Pat Maddox <patmaddox@FreeBSD.org>
AuthorDate: 2026-08-25 08:12:49 +0000
Commit:     Pat Maddox <patmaddox@FreeBSD.org>
CommitDate: 2026-09-02 17:21:09 +0000

    ports.7: Document test target
    
    While here, document WITHOUT_DEBUG_PORTS.
    
    Approved by: dch (mentor)
    Approved by: kevans
    Approved by: ziaee
    Closes:      https://github.com/freebsd/freebsd-src/pull/2387
---
 share/man/man7/ports.7 | 25 +++++++++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/share/man/man7/ports.7 b/share/man/man7/ports.7
index f187a1d8c1ce..0a56afd9d644 100644
--- a/share/man/man7/ports.7
+++ b/share/man/man7/ports.7
@@ -25,7 +25,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 February 24, 2026
+.Dd August 25, 2026
 .Dt PORTS 7
 .Os
 .Sh NAME
@@ -294,6 +294,12 @@ Remove an installed port from the system, similar to
 Remove all installed ports with the same
 .Va PKGORIGIN
 from the system.
+.It Cm test
+Run the port's tests, if it has defined a
+.Va TEST_TARGET
+value or a
+.Cm do-test
+target.
 .It Cm package
 Make a binary package for the port.
 The port will be installed if it has not already been.
@@ -567,13 +573,16 @@ More information on these and other related variables may be found in
 and the
 .Fx
 Porter's Handbook.
-.Bl -tag -width "WITH_CCACHE_BUILD"
+.Bl -tag -width "WITHOUT_TESTING_PORTS"
 .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 .
+.It Va WITHOUT_DEBUG_PORTS
+A list of origins for which to unset
+.Va WITH_DEBUG .
 .It Va DEBUG_FLAGS
 .Pq Default: Ql -g
 Additional
@@ -581,6 +590,18 @@ Additional
 to set when
 .Va WITH_DEBUG
 is set.
+.It Va WITH_TESTING
+.Pq Vt bool
+If set, runs the
+.Cm test
+target before
+.Cm package .
+.It Va WITH_TESTING_PORTS
+A list of origins for which to set
+.Va WITH_TESTING .
+.It Va WITHOUT_TESTING_PORTS
+A list of origins for which to unset
+.Va WITH_TESTING .
 .It Va DEFAULT_VERSIONS
 Override the default variant used for ports
 with multiple concurrent versions in the tree,