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

Mathieu Arnold <[email protected]>
Newsgroups gmane.os.freebsd.devel.cvs.doc
Message-ID <[email protected]>
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 &lt;bsd.port.pre.mk&gt;
@@ -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=	&dollar;{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">
_______________________________________________
[email protected] mailing list
http://lists.freebsd.org/mailman/listinfo/svn-doc-all
To unsubscribe, send any mail to "[email protected]"
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.