From c9c8768dedb2accc23dc46fda49d8fb383e12003 Mon Sep 17 00:00:00 2001
From: Mathieu Arnold <mat@FreeBSD.org>
Date: Fri, 9 Jun 2017 15:04:52 +0000
Subject: [PATCH] Create one more level of sections to group CONFIGURE_ARGS and
 CMAKE_ARGS helpers.

Sponsored by:	Absolight
---
 .../porters-handbook/makefiles/chapter.xml    | 24 ++++++++++++-------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
index 8cece05b35..9edeb554b1 100644
--- a/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
@@ -5699,7 +5699,10 @@ USE_OPENSSL=	yes
 .endif</programlisting>
       </sect3>
 
-      <sect3 xml:id="options-configure_enable">
+      <sect3 xml:id="options-configure-helpers">
+	<title><varname>CONFIGURE_ARGS</varname> Helpers</title>
+
+      <sect4 xml:id="options-configure_enable">
 	<title><varname><replaceable>OPT</replaceable>_CONFIGURE_ENABLE</varname></title>
 
 	<para>When option <replaceable>OPT</replaceable> is selected,
@@ -5739,9 +5742,9 @@ CONFIGURE_ARGS+=	--enable-test2=exhaustive
 .else
 CONFIGURE_ARGS+=	--disable-test2
 .endif</programlisting>
-      </sect3>
+      </sect4>
 
-      <sect3 xml:id="options-configure_with">
+      <sect4 xml:id="options-configure_with">
 	<title><varname><replaceable>OPT</replaceable>_CONFIGURE_WITH</varname></title>
 
 	<para>When option <replaceable>OPT</replaceable> is selected,
@@ -5781,9 +5784,9 @@ CONFIGURE_ARGS+=	--with-test2=exhaustive
 .else
 CONFIGURE_ARGS+=	--without-test2
 .endif</programlisting>
-      </sect3>
+      </sect4>
 
-      <sect3 xml:id="options-configure_on">
+      <sect4 xml:id="options-configure_on">
 	<title><varname><replaceable>OPT</replaceable>_CONFIGURE_ON</varname>
 	  and
 	  <varname><replaceable>OPT</replaceable>_CONFIGURE_OFF</varname></title>
@@ -5819,9 +5822,13 @@ CONFIGURE_ARGS+=	--no-test
 	      linkend="options-configure_with"/> provide a shorter
 	    and more comprehensive functionality.</para>
 	</tip>
+      </sect4>
       </sect3>
 
-      <sect3 xml:id="options-cmake_on">
+      <sect3 xml:id="options-cmake-helpers">
+	<title><varname>CMAKE_ARGS</varname> Helpers</title>
+
+      <sect4 xml:id="options-cmake_on">
 	<title><varname><replaceable>OPT</replaceable>_CMAKE_ON</varname>
 	  and
 	  <varname><replaceable>OPT</replaceable>_CMAKE_OFF</varname></title>
@@ -5854,9 +5861,9 @@ CMAKE_ARGS+=	-DOPTIMIZE:BOOL=true
 	  <para>See <xref linkend="options-cmake_bool"/> for a shorter
 	    helper when the value is boolean.</para>
 	</tip>
-      </sect3>
+      </sect4>
 
-      <sect3 xml:id="options-cmake_bool">
+      <sect4 xml:id="options-cmake_bool">
 	<title><varname><replaceable>OPT</replaceable>_CMAKE_BOOL</varname>
 	  and
 	  <varname><replaceable>OPT</replaceable>_CMAKE_BOOL_OFF</varname></title>
@@ -5897,6 +5904,7 @@ CMAKE_ARGS+=	-DTEST:BOOL=true -DDEBUG:BOOL=true \
 CMAKE_ARGS+=	-DTEST:BOOL=false -DDEBUG:BOOL=false \
 		-DOPTIMIZE:BOOL=true
 .endif</programlisting>
+      </sect4>
       </sect3>
 
       <sect3 xml:id="options-qmake_on">