Date: Thu, 21 Feb 2019 05:53:29 +0000 (UTC) From: Mark Linimon <linimon@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r52825 - head/en_US.ISO8859-1/books/porters-handbook/porting-dads Message-ID: <201902210553.x1L5rTAV086657@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201902210553.x1L5rTAV086657>