diff --git a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
index 9110842053..23df786e75 100644
--- a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
@@ -2875,6 +2875,11 @@ GLIB_SCHEMAS=	 org.regexxer.gschema.xml
   <sect1 xml:id="using-qt">
     <title>Using Qt</title>
 
+    <note>
+      <para>For ports that are part of Qt itself, see <xref
+	  linkend="uses-qt-dist"/>.</para>
+    </note>
+
     <sect2 xml:id="qt-common">
       <title>Ports That Require Qt</title>
 
diff --git a/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
index 05bb5169cb..6b2e7a6997 100644
--- a/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
@@ -2748,6 +2748,69 @@ USE_PYQT=	core doc_build designer_run</programlisting>
       for more information.</para>
   </sect1>
 
+  <sect1 xml:id="uses-qt-dist">
+    <title><literal>qt-dist</literal></title>
+
+    <para>Possible arguments: (none) or <literal>5</literal> and
+      (none) or one of <literal>3d</literal>,
+      <literal>activeqt</literal>, <literal>androidextras</literal>,
+      <literal>base</literal>, <literal>canvas3d</literal>,
+      <literal>charts</literal>, <literal>connectivity</literal>,
+      <literal>datavis3d</literal>,  <literal>declarative</literal>,
+      <literal>doc</literal>,  <literal>gamepad</literal>,
+      <literal>graphicaleffects</literal>,
+      <literal>imageformats</literal>, <literal>location</literal>,
+      <literal>macextras</literal>, <literal>multimedia</literal>,
+      <literal>networkauth</literal>, <literal>purchasing</literal>,
+      <literal>quickcontrols2</literal>,
+      <literal>quickcontrols</literal>,
+      <literal>remoteobjects</literal>,  <literal>script</literal>,
+      <literal>scxml</literal>,  <literal>sensors</literal>,
+      <literal>serialbus</literal>,  <literal>serialport</literal>,
+      <literal>speech</literal>,  <literal>svg</literal>,
+      <literal>tools</literal>,  <literal>translations</literal>,
+      <literal>virtualkeyboard</literal>, <literal>wayland</literal>,
+      <literal>webchannel</literal>, <literal>webengine</literal>,
+      <literal>websockets</literal>, <literal>webview</literal>,
+      <literal>winextras</literal>, <literal>x11extras</literal>,
+      <literal>xmlpatterns</literal></para>
+
+    <para>Provides support for building <application>Qt
+	5</application> components.  It takes care of setting up the
+      appropriate configuration environment for the port to
+      build.</para>
+
+    <example xml:id="qt5-dist-example">
+      <title>Building Qt 5 Components</title>
+
+      <para>The port is <application>Qt 5</application>'s
+	  <literal>networkauth</literal> component, which is part of
+	the <literal>networkauth</literal> distribution file.</para>
+
+      <programlisting>PORTNAME=	networkauth
+DISTVERSION=	${QT5_VERSION}
+
+USES=		qt-dist:5</programlisting>
+    </example>
+
+    <para>If <varname>PORTNAME</varname> does not match the
+      component name, it can be passed as an argument to
+      <literal>qt-dist</literal>.</para>
+
+    <example xml:id="qt5-dist-example-explicit">
+      <title>Building Qt 5 Components with Different Names</title>
+
+      <para>The port is <application>Qt 5</application>'s
+	<literal>gui</literal> component, which is part of the
+	<literal>base</literal> distribution file.</para>
+
+      <programlisting>PORTNAME=	gui
+DISTVERSION=	${QT5_VERSION}
+
+USES=		qt-dist:5,base</programlisting>
+    </example>
+  </sect1>
+
   <sect1 xml:id="uses-readline">
     <title><literal>readline</literal></title>