document new target gen

3 files changed, 43 insertions, 13 deletions

diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5
index a3c3569717e..d2b1b5e9352 100644
--- a/share/man/man5/bsd.port.mk.5
+++ b/share/man/man5/bsd.port.mk.5
@@ -1,4 +1,4 @@
-.\" $OpenBSD: bsd.port.mk.5,v 1.499 2018/10/25 09:56:57 espie Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.500 2018/11/05 15:59:47 espie Exp $
 .\"
 .\" Copyright (c) 2000-2008 Marc Espie
 .\"
@@ -24,7 +24,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 $Mdocdate: October 25 2018 $
+.Dd $Mdocdate: November 5 2018 $
 .Dt BSD.PORT.MK 5
 .Os
 .Sh NAME
@@ -115,6 +115,7 @@ Specialization hooks exist for
 .Cm distpatch ,
 .Cm extract ,
 .Cm fake ,
+.Cm gen ,
 .Cm install ,
 .Cm patch ,
 .Cm test .
@@ -376,6 +377,20 @@ ownership of their contents is modified to conform to
 and
 .Xr dpb 1
 requirements.
+.It Cm gen
+Generate configure script when needed, either after patching
+input files, or from scratch for some ports,
+generally using automake, autoconf, autogen and similar gnu tools.
+This target only has modules
+.Po Ev MODxxx_gen Pc
+and a
+.Ar do-gen
+hooks.
+Then adjust timestamps to avoid regeneration during build
+.Po
+see
+.Ev REORDER_DEPENDENCIES
+.Pc .
 .It Cm generate-readmes
 Generate READMEs and rc scripts from
 .Pa ${PKGDIR}
@@ -526,11 +541,6 @@ exists, the files described under
 .Ev PATCH_LIST
 will be applied under
 .Ev WRKDIST .
-See also
-.Ev REORDER_DEPENDENCIES
-for possible
-.Cm post-patch
-clean-up.
 .It Cm peek-ftp
 Connect to the first site in
 .Ev MASTER_SITES ,
@@ -678,6 +688,10 @@ and
 so that the packing-list is complete.
 .It Cm rebuild
 Force rebuild of the port.
+.It Cm regen
+Force rebuilding configure scripts using
+.Ar gen
+steps.
 .It Cm reinstall
 Force reinstallation of a port, by first cleaning the old installation.
 Seldom needed, as
diff --git a/share/man/man5/port-modules.5 b/share/man/man5/port-modules.5
index 1c6fba78bd8..2e3679710b7 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.233 2018/09/03 22:12:37 bcallah Exp $
+.\"	$OpenBSD: port-modules.5,v 1.234 2018/11/05 15:59:47 espie Exp $
 .\"
 .\" Copyright (c) 2008 Marc Espie
 .\"
@@ -24,7 +24,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 $Mdocdate: September 3 2018 $
+.Dd $Mdocdate: November 5 2018 $
 .Dt PORT-MODULES 5
 .Os
 .Sh NAME
@@ -170,7 +170,14 @@ There is a
 hook that can be activated by defining
 .Ev MODFOO_post-patch .
 It will be run right after
-.Cm post-patch
+.Cm post-patch .
+.It Cm gen
+There is a
+.Cm gen
+hook that can be activated by defining
+.Ev MODFOO_gen .
+It will be run right after
+.Cm do-gen
 and before
 .Ev REORDER_DEPENDENCIES
 touches things.
diff --git a/share/man/man7/ports.7 b/share/man/man7/ports.7
index 3529184f95b..9ec6d41b619 100644
--- a/share/man/man7/ports.7
+++ b/share/man/man7/ports.7
@@ -23,10 +23,10 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\" $OpenBSD: ports.7,v 1.121 2018/10/17 05:45:14 jmc Exp $
+.\" $OpenBSD: ports.7,v 1.122 2018/11/05 15:59:47 espie Exp $
 .\" $FreeBSD: ports.7,v 1.7 1998/06/23 04:38:50 hoek Exp $
 .\"
-.Dd $Mdocdate: October 17 2018 $
+.Dd $Mdocdate: November 5 2018 $
 .Dt PORTS 7
 .Os
 .Sh NAME
@@ -274,6 +274,9 @@ will skip this step.
 Expand the distfile into a work directory.
 .It Cm patch
 Apply any patches that are necessary for the port.
+.It Cm gen
+Recreate configure machinery if needed, mainly used by GNU based software
+that wants autogen/autoconf/automake.
 .It Cm configure
 Configure the port.
 Some ports will ask questions during this stage.
@@ -299,7 +302,13 @@ install the port with
 Install the resulting package.
 .El
 .Pp
-The following targets are not run during the normal install process.
+The following targets are not run during the normal install process
+.Po
+exception
+.Cm clean
+is run for dependencies with the default settings of
+.Ev BULK Ns = Ns Dv Auto
+.Pc .
 .Bl -tag -width fetch-list
 .It Cm print-build-depends , print-run-depends
 Print an ordered list of all the compile and run dependencies.