From: zhuk <zhuk@openbsd.org>
Date: Thu, 15 Jun 2017 16:03:52 +0000 (+0000)
Subject: Document MODQMAKE_RECURSIVE and test framework support for devel/qmake.
X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=c9d6097ec58310143274d57df84205bb6fb43274;p=openbsd

Document MODQMAKE_RECURSIVE and test framework support for devel/qmake.
---

diff --git a/share/man/man5/port-modules.5 b/share/man/man5/port-modules.5
index e2cd3c2b3a8..7709a2b604b 100644
--- a/share/man/man5/port-modules.5
+++ b/share/man/man5/port-modules.5
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: port-modules.5,v 1.219 2017/06/15 15:53:23 zhuk Exp $
+.\"	$OpenBSD: port-modules.5,v 1.220 2017/06/15 16:03:52 zhuk Exp $
 .\"
 .\" Copyright (c) 2008 Marc Espie
 .\"
@@ -747,6 +747,11 @@ targets, unless port already defines one; also,
 will be set to
 .Sq Yes
 unless it's already set to some value.
+Also, unless
+.Ev NO_TEST
+is set, the
+.Ar do-test
+target will be defined.
 .Pp
 The following variables could be used in qmake-based ports:
 .Bl -tag -width 1234
@@ -764,6 +769,19 @@ see qmake documentation for details.
 Defaults to
 .Sq \&. ,
 which means the (only) project in WRKSRC directory.
+.It Ev MODQMAKE_RECURSIVE
+If
+.Sq Yes ,
+then qmake will be run recursively during configure stage;
+otherwise, only projects mentioned in
+.Ev MODQMAKE_PROJECTS
+will be processed during configure stage, and their descendants will
+be visited during main build phase.
+Sometimes a qmake project processing depends on files generated
+by other qmake project during build, and recursive builds break this.
+For Qt4+ defaults to
+.Sq Yes ,
+and Qt3 doesn't support recursive configuring.
 .It Ev MODQMAKE_build
 Actual commands that module will use to build all
 .Ev MODQMAKE_PROJECTS