svn commit: r52825 - head/en_US.ISO8859-1/books/porters-handbook/porting-dads

[Mark Linimon]

Author: linimon
Date: Thu Feb 21 05:53:29 2019
New Revision: 52825
URL: https://svnweb.freebsd.org/changeset/doc/52825

Log:
  Currently the only ARCH documentation is placed before the IGNORE
  variables are introduced.
  
  This patch swaps the order of those two sections and pushes "Marking
  a Port as Architecture Neutral" down one level.
  
  By itself this patch seems trivial; however, it needs to be done to
  prepare for expanding the section with non-trivial material.
  
  Approved by:	mat
  Differential Revision:	https://reviews.freebsd.org/D19233

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml	Mon Feb 18 03:30:09 2019	(r52824)
+++ head/en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml	Thu Feb 21 05:53:29 2019	(r52825)
@@ -370,14 +370,6 @@ cc -o someprogram source1.o source2.o -L/usr/local/lib
     </note>
   </sect1>
 
-  <sect1 xml:id="dads-arch-neutral">
-    <title>Marking a Port as Architecture Neutral</title>
-
-    <para>Ports that do not have any architecture-dependent files
-      or requirements are identified by setting
-      <literal>NO_ARCH=yes</literal>.</para>
-  </sect1>
-
   <sect1 xml:id="dads-noinstall">
     <title>Marking a Port Not Installable with
       <varname>BROKEN</varname>, <varname>FORBIDDEN</varname>, or
@@ -501,7 +493,45 @@ cc -o someprogram source1.o source2.o -L/usr/local/lib
 	      <varname>IGNORE</varname> by itself.</para>
 	  </note>
 	</listitem>
+      </itemizedlist>
+    </sect2>
 
+    <sect2 xml:id="dads-noinstall-notes">
+      <title>Implementation Notes</title>
+
+      <para>Do not quote the values of <varname>BROKEN</varname>,
+	<varname>IGNORE</varname>, and related variables.  Due to the
+	way the information is shown to the user, the wording of
+	messages for each variable differ:</para>
+
+      <programlisting>BROKEN=	fails to link with base -lcrypto</programlisting>
+
+      <programlisting>IGNORE=	unsupported on recent versions</programlisting>
+
+      <para>resulting in this output from
+	<command>make describe</command>:</para>
+
+      <programlisting>===>  foobar-0.1 is marked as broken: fails to link with base -lcrypto.</programlisting>
+
+      <programlisting>===>  foobar-0.1 is unsupported on recent versions.</programlisting>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="dads-arch">
+    <title>Architectural Considerations</title>
+
+    <sect2 xml:id="dads-arch-neutral">
+      <title>Marking a Port as Architecture Neutral</title>
+
+      <para>Ports that do not have any architecture-dependent files
+        or requirements are identified by setting
+        <literal>NO_ARCH=yes</literal>.</para>
+    </sect2>
+
+    <sect2 xml:id="dads-arch-ignore">
+      <title>Marking a Port as Ignored Only On Certain Architectures</title>
+
+      <itemizedlist>
 	<listitem>
 	  <para>To mark a port as <varname>IGNORE</varname>d
 	    only on certain architectures, there are two other
@@ -522,7 +552,12 @@ cc -o someprogram source1.o source2.o -L/usr/local/lib
 	    and
 	    <varname>NOT_FOR_ARCHS_REASON_<replaceable>ARCH</replaceable></varname>.</para>
 	</listitem>
+      </itemizedlist>
 
+    </sect2>
+
+    <sect2 xml:id="dads-arch-i386">
+      <itemizedlist>
 	<listitem>
 	  <para>If a port fetches i386 binaries and installs them,
 	    set <varname>IA32_BINARY_PORT</varname>.  If this variable
@@ -533,26 +568,6 @@ cc -o someprogram source1.o source2.o -L/usr/local/lib
 	    will be set automatically.</para>
 	</listitem>
       </itemizedlist>
-    </sect2>
-
-    <sect2 xml:id="dads-noinstall-notes">
-      <title>Implementation Notes</title>
-
-      <para>Do not quote the values of <varname>BROKEN</varname>,
-	<varname>IGNORE</varname>, and related variables.  Due to the
-	way the information is shown to the user, the wording of
-	messages for each variable differ:</para>
-
-      <programlisting>BROKEN=	fails to link with base -lcrypto</programlisting>
-
-      <programlisting>IGNORE=	unsupported on recent versions</programlisting>
-
-      <para>resulting in this output from
-	<command>make describe</command>:</para>
-
-      <programlisting>===>  foobar-0.1 is marked as broken: fails to link with base -lcrypto.</programlisting>
-
-      <programlisting>===>  foobar-0.1 is unsupported on recent versions.</programlisting>
     </sect2>
   </sect1>