svn commit: r44958 - in head/en_US.ISO8859-1/books/porters-handbook: appendices makefiles special

Mathieu Arnold mat at FreeBSD.org
Mon May 26 15:14:16 UTC 2014


Author: mat (ports committer)
Date: Mon May 26 15:14:15 2014
New Revision: 44958
URL: http://svnweb.freebsd.org/changeset/doc/44958

Log:
  Add xml:id to all <table> and <example>.
  
  Sponsored by:	Absolight

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/appendices/chapter.xml
  head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
  head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/appendices/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/appendices/chapter.xml	Mon May 26 14:36:11 2014	(r44957)
+++ head/en_US.ISO8859-1/books/porters-handbook/appendices/chapter.xml	Mon May 26 15:14:15 2014	(r44958)
@@ -13,7 +13,7 @@
   <sect1 xml:id="uses-values">
     <title>Values of <varname>USES</varname></title>
 
-    <table>
+    <table xml:id="uses-values-table">
       <title>Values of <varname>USES</varname></title>
 
       <tgroup cols="3">
@@ -40,7 +40,7 @@
       <link
 	xlink:href="http://svnweb.FreeBSD.org/base/head/sys/sys/param.h?view=markup">sys/param.h</link>:</para>
 
-    <table frame="none">
+    <table frame="none" xml:id="freebsd-versions-table">
       <title><literal>__FreeBSD_version</literal> Values</title>
 
       <tgroup cols="3">

Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Mon May 26 14:36:11 2014	(r44957)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Mon May 26 15:14:15 2014	(r44958)
@@ -1649,7 +1649,7 @@ MASTER_SITE_SUBDIR=	make</programlisting
       <programlisting>MASTER_SITES=	SF
 MASTER_SITE_SUBDIR=	stardict/WyabdcRealPeopleTTS/${PORTVERSION}</programlisting>
 
-      <table frame="none">
+      <table frame="none" xml:id="makefile-master_sites-popular">
 	<title>Popular Magic <varname>MASTER_SITES</varname>
 	  Macros</title>
 
@@ -3117,7 +3117,7 @@ ALWAYS_KEEP_DISTFILES=	yes
 	  <literal>lang/gccXY</literal> itself!</para>
       </note>
 
-      <table frame="none">
+      <table frame="none" xml:id="use-vars-table">
 	<title>The
 	  <varname>USE_<replaceable>*</replaceable></varname>
 	  Variables</title>
@@ -3264,7 +3264,7 @@ ALWAYS_KEEP_DISTFILES=	yes
 	indexing, which causes problems for port and package
 	management.</para>
 
-      <example>
+      <example xml:id="makefile-automatic-dependencies-bad">
 	<title>Wrong Declaration of an Optional Dependency</title>
 
 	<programlisting>.include <bsd.port.pre.mk>
@@ -3284,7 +3284,7 @@ LIB_DEPENDS=	libbar.so:${PORTSDIR}/foo/b
 	determine their need for dependencies based on the existence
 	of other files.</para>
 
-      <example>
+      <example xml:id="makefile-automatic-dependencies-good">
 	<title>Correct Declaration of an Optional Dependency</title>
 
 	<programlisting>OPTIONS_DEFINE=	BAR
@@ -3685,7 +3685,7 @@ EXAMPLES_CONFIGURE_WITH=	examples
 	<literal>--disable-xxx</literal> in
 	<varname>CONFIGURE_ARGS</varname>.</para>
 
-      <example>
+      <example xml:id="makefile-options-auto-activation-bad">
 	<title>Wrong Handling of an Option</title>
 
 	<programlisting>.if ${PORT_OPTIONS:MFOO}
@@ -3704,7 +3704,7 @@ CONFIGURE_ARGS+=	--enable-foo
 	system does not protest (no dependency on libfoo was recorded)
 	but the application breaks.</para>
 
-      <example>
+      <example xml:id="makefile-options-auto-activation-good">
 	<title>Correct Handling of an Option</title>
 
 	<programlisting>FOO_LIB_DEPENDS=		libfoo.so:${PORTSDIR}/devel/foo

Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Mon May 26 14:36:11 2014	(r44957)
+++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Mon May 26 15:14:15 2014	(r44958)
@@ -392,7 +392,7 @@ IGNORE=	may not be redistributed because
 	environment variables can be passed using
 	<varname>CONFIGURE_ENV</varname> variable.</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-configure-variables">
 	<title>Variables for Ports That Use
 	  <command>configure</command></title>
 
@@ -449,7 +449,7 @@ IGNORE=	may not be redistributed because
 	<literal>USES= cmake:outsource</literal> to build in a
 	separate directory (see below).</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-cmake-variables">
 	<title>Variables for Ports That Use
 	  <command>cmake</command></title>
 
@@ -494,7 +494,7 @@ IGNORE=	may not be redistributed because
 	</tgroup>
       </table>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-cmake-user-variables">
 	<title>Variables the Users can define for
 	  <command>cmake</command> builds</title>
 
@@ -581,7 +581,7 @@ CMAKE_SOURCE_PATH=	${WRKSRC}/subp
       <para>If your port uses <application>SCons</application>,
 	define <literal>USE_SCONS=yes</literal>.</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-scons-variables">
 	<title>Variables for Ports That Use
 	  <command>scons</command></title>
 
@@ -933,7 +933,7 @@ PLIST_SUB+=		NLS="@comment "
       <varname>USE_PERL5</varname> like described in <link
 	linkend="uses-perl5">the perl5 USES description</link>.</para>
 
-    <table frame="none">
+    <table frame="none" xml:id="using-perl-variables">
       <title>Read-Only Variables for Ports That Use
 	<application>Perl</application></title>
 
@@ -1081,7 +1081,7 @@ PLIST_SUB+=		NLS="@comment "
 USE_GL=		glu</programlisting>
       </example>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-xorg-variables">
 	<title>Variables for Ports That Use X</title>
 
 	<tgroup cols="2">
@@ -1292,7 +1292,7 @@ USE_XORG=	x11 xpm</programlisting>
       <para>The Qt framework exports a number of variables which can
 	be used by ports, some of them listed below:</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-qt-variables">
 	<title>Variables Provided to Ports That Use Qt</title>
 
 	<tgroup cols="2">
@@ -1391,7 +1391,7 @@ PLIST_SUB+=	QT_INCDIR=${QT_INCDIR_REL} \
 	<varname>_USE_QT5_ONLY</varname> variables in
 	<filename>/usr/ports/Mk/bsd.qt.mk</filename>):</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-qt-library-list">
 	<title>Available Qt Library Components</title>
 
 	<tgroup cols="2">
@@ -1465,7 +1465,7 @@ PLIST_SUB+=	QT_INCDIR=${QT_INCDIR_REL} \
 	depends on, run <command>ldd</command> on the main
 	executable after a successful compilation.</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-qt-tools-list">
 	<title>Available Qt Tool Components</title>
 
 	<tgroup cols="2">
@@ -1525,7 +1525,7 @@ PLIST_SUB+=	QT_INCDIR=${QT_INCDIR_REL} \
 	</tgroup>
       </table>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-qt-plugins-list">
 	<title>Available Qt Plugin Components</title>
 
 	<tgroup cols="2">
@@ -1592,7 +1592,7 @@ PLIST_SUB+=	QT_INCDIR=${QT_INCDIR_REL} \
 	  linkend="using-qmake-example"><literal>USES= qmake</literal>
 	  example</link>).</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-qmake-variables">
 	<title>Variables for Ports That Use
 	  <command>qmake</command></title>
 
@@ -1700,7 +1700,7 @@ USE_QT5=	buildtools_build</programlistin
 	components are documented at the top of
 	<filename>/usr/ports/Mk/bsd.kde4.mk</filename>):</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-kde-components">
 	<title>Available KDE 4 Components</title>
 
 	<tgroup cols="2">
@@ -1894,7 +1894,7 @@ USE_QT4=	moc_build qmake_build rcc_build
 	most current version, and &os; default is
 	<package role="port">java/openjdk6</package>.</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-java-variables">
 	<title>Variables Which May be Set by Ports That Use
 	  Java</title>
 
@@ -1964,7 +1964,7 @@ USE_QT4=	moc_build qmake_build rcc_build
       <para>Below is the list of all settings a port will receive
 	after setting <varname>USE_JAVA</varname>:</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-java-variables2">
 	<title>Variables Provided to Ports That Use Java</title>
 
 	<tgroup cols="2">
@@ -2129,7 +2129,7 @@ USE_QT4=	moc_build qmake_build rcc_build
       <para>Additionally, the following constants are defined so all
 	Java ports may be installed in a consistent way:</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-java-constants">
 	<title>Constants Defined for Ports That Use Java</title>
 
 	<tgroup cols="2">
@@ -2304,7 +2304,7 @@ do-install:
     <sect2 xml:id="using-apache">
       <title>Apache</title>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-apache-variables">
 	<title>Variables for Ports That Use Apache</title>
 
 	<tgroup cols="2">
@@ -2369,7 +2369,7 @@ do-install:
 	</tgroup>
       </table>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-apache-modules">
 	<title>Useful Variables for Porting Apache Modules</title>
 
 	<tgroup cols="2">
@@ -2452,7 +2452,7 @@ do-install:
     <sect2 xml:id="php-variables">
       <title>PHP</title>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-php-variables">
 	<title>Variables for Ports That Use PHP</title>
 
 	<tgroup cols="2">
@@ -2599,7 +2599,7 @@ _DOCSDIR=	.
 
     <programlisting>PKGNAMEPREFIX=	${PYTHON_PKGNAMEPREFIX}</programlisting>
 
-    <table frame="none">
+    <table frame="none" xml:id="using-python-variables">
       <title>Most Useful Variables for Ports That Use Python</title>
 
       <tgroup cols="2">
@@ -2719,7 +2719,7 @@ _DOCSDIR=	.
       <literal>:<replaceable>xx</replaceable></literal>, e.g.:
       <literal>USES=tcl:85</literal>.</para>
 
-    <table frame="none">
+    <table frame="none" xml:id="using-tcl-variables">
       <title>The Most Useful Read-Only Variables for Ports That Use
 	<application>Tcl/Tk</application></title>
 
@@ -2793,7 +2793,7 @@ _DOCSDIR=	.
   <sect1 xml:id="using-ruby">
     <title>Using Ruby</title>
 
-    <table frame="none">
+    <table frame="none" xml:id="using-ruby-variables">
       <title>Useful Variables for Ports That Use Ruby</title>
 
       <tgroup cols="2">
@@ -2838,7 +2838,7 @@ _DOCSDIR=	.
       possible.  These variables should not be redefined in the
       port.</para>
 
-    <table frame="none">
+    <table frame="none" xml:id="using-ruby-variables-ro">
       <title>Selected Read-Only Variables for Ports That Use
 	Ruby</title>
 
@@ -3133,7 +3133,7 @@ USE_SDL+=	mixer
 	<application>wxWidgets</application> versions and the
 	corresponding ports in the tree:</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="wx-widgets-versions-table">
 	<title>Available <application>wxWidgets</application>
 	  Versions</title>
 
@@ -3180,7 +3180,7 @@ USE_SDL+=	mixer
 	be set to one or more of the following combinations
 	separated by spaces:</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="wx-widgets-versions-specification">
 	<title><application>wxWidgets</application> Version
 	  Specifications</title>
 
@@ -3221,7 +3221,7 @@ USE_SDL+=	mixer
 	of versions, the first ones will have higher
 	priority.</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="wx-widgets-preferred-version">
 	<title>Variables to Select Preferred
 	  <application>wxWidgets</application> Versions</title>
 
@@ -3257,7 +3257,7 @@ USE_SDL+=	mixer
 	<varname>WX_COMPS</varname> variable.  The following
 	components are available:</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="wx-widgets-components-table">
 	<title>Available <application>wxWidgets</application>
 	  Components</title>
 
@@ -3311,7 +3311,7 @@ USE_SDL+=	mixer
 	<xref linkend="wx-def-dep-types"/>).  The following types
 	are available:</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="wx-widgets-dependency-table">
 	<title>Available <application>wxWidgets</application>
 	  Dependency Types</title>
 
@@ -3518,7 +3518,7 @@ CONFIGURE_ARGS+=	--enable-wxpython
 	defining one from
 	<xref linkend="wx-ver-sel-table"/>).</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="wx-widgets-variables">
 	<title>Variables Defined for Ports That Use
 	  <application>wxWidgets</application></title>
 
@@ -3621,7 +3621,7 @@ PLIST_SUB+=	VERSION="${VER_STR}"
 	<varname>WX_CONF_ARGS</varname> variable can be used for
 	provide them.</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="wx-conf-args-values">
 	<title>Legal Values for
 	  <varname>WX_CONF_ARGS</varname></title>
 
@@ -3714,7 +3714,7 @@ PLIST_SUB+=	VERSION="${VER_STR}"
 	<application>Lua</application> versions and the
 	corresponding ports in the tree:</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-lua-available-versions">
 	<title>Available <application>Lua</application>
 	  Versions</title>
 
@@ -3751,7 +3751,7 @@ PLIST_SUB+=	VERSION="${VER_STR}"
 	be set to one or more of the following combinations
 	separated by spaces:</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-lua-version-specifications">
 	<title><application>Lua</application> Version
 	  Specifications</title>
 
@@ -3792,7 +3792,7 @@ PLIST_SUB+=	VERSION="${VER_STR}"
 	of versions, the first ones will have higher
 	priority.</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-lua-variables">
 	<title>Variables to Select Preferred
 	  <application>Lua</application> Versions</title>
 
@@ -3842,7 +3842,7 @@ WANT_LUA_VER=	5.0</programlisting>
 	<varname>LUA_COMPS</varname> variable.  The following
 	components are available:</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-lua-components-list">
 	<title>Available <application>Lua</application>
 	  Components</title>
 
@@ -3889,7 +3889,7 @@ WANT_LUA_VER=	5.0</programlisting>
 	<xref linkend="lua-def-dep-types"/>).  The following types
 	are available:</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-lua-dependency-types">
 	<title>Available <application>Lua</application> Dependency
 	  Types</title>
 
@@ -4026,7 +4026,7 @@ CONFIGURE_ARGS+=	--enable-tolua
 	defining one from
 	<xref linkend="lua-ver-sel-table"/>).</para>
 
-      <table frame="none">
+      <table frame="none" xml:id="using-lua-variables-ports">
 	<title>Variables Defined for Ports That Use
 	  <application>Lua</application></title>
 
@@ -4420,7 +4420,7 @@ post-patch:
   <sect1 xml:id="using-mozilla">
     <title>Using Mozilla</title>
 
-    <table frame="none">
+    <table frame="none" xml:id="using-mozilla-variables">
       <title>Variables for Ports That Use Mozilla</title>
 
       <tgroup cols="2">
@@ -4500,7 +4500,7 @@ post-patch:
   <sect1 xml:id="using-databases">
     <title>Using Databases</title>
 
-    <table frame="none">
+    <table frame="none" xml:id="using-databases-variables">
       <title>Variables for Ports Using Databases</title>
 
       <tgroup cols="2">


More information about the svn-doc-all mailing list