svn commit: r44282 - head/en_US.ISO8859-1/books/porters-handbook/special
Mathieu Arnold
mat at FreeBSD.org
Wed Mar 19 13:13:30 UTC 2014
Author: mat (ports committer)
Date: Wed Mar 19 13:13:29 2014
New Revision: 44282
URL: http://svnweb.freebsd.org/changeset/doc/44282
Log:
Update the special chapter.
Sponsored by: Absolight
Modified:
head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Wed Mar 19 12:30:25 2014 (r44281)
+++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Wed Mar 19 13:13:29 2014 (r44282)
@@ -1048,19 +1048,19 @@ PLIST_SUB+= NLS="@comment "
are:</para>
<para><literal>bigreqsproto compositeproto damageproto dmx
- dmxproto dri2proto evieproto fixesproto fontcacheproto
- fontenc fontsproto fontutil glproto ice inputproto kbproto
- libfs oldx pciaccess pixman printproto randrproto
- recordproto renderproto resourceproto scrnsaverproto sm
- trapproto videoproto x11 xau xaw xaw6 xaw7 xbitmaps
- xcmiscproto xcomposite xcursor xdamage xdmcp xevie xext
- xextproto xf86bigfontproto xf86dgaproto xf86driproto
- xf86miscproto xf86rushproto xf86vidmodeproto xfixes xfont
- xfontcache xft xi xinerama xineramaproto xkbfile xkbui
- xmu xmuu xorg-server xp xpm xprintapputil xprintutil
- xproto xproxymngproto xrandr xrender xres xscrnsaver xt
- xtrans xtrap xtst xv xvmc xxf86dga xxf86misc
- xxf86vm</literal>.</para>
+ dmxproto dri2proto dri3proto evieproto fixesproto
+ fontcacheproto fontenc fontsproto fontutil glproto ice
+ inputproto kbproto libfs oldx pciaccess pixman presentproto
+ printproto randrproto recordproto renderproto resourceproto
+ scrnsaverproto sm trapproto videoproto x11 xau xaw xaw6 xaw7
+ xbitmaps xcb xcmiscproto xcomposite xcursor xdamage xdmcp
+ xevie xext xextproto xf86bigfontproto xf86dgaproto
+ xf86driproto xf86miscproto xf86rushproto xf86vidmodeproto
+ xfixes xfont xfontcache xft xi xinerama xineramaproto
+ xkbfile xkbui xmu xmuu xorg-macros xorg-server xp xpm
+ xprintapputil xprintutil xproto xproxymngproto xrandr
+ xrender xres xscrnsaver xshmfence xt xtrans xtrap xtst xv
+ xvmc xxf86dga xxf86misc xxf86vm</literal>.</para>
<para>Always up-to-date list can be found in
<filename>/usr/ports/Mk/bsd.xorg.mk</filename>.</para>
@@ -1069,7 +1069,7 @@ PLIST_SUB+= NLS="@comment "
implementation. You can specify a dependency on various
components of this project with <varname>USE_GL</varname>
variable. Valid options are:
- <literal>glut, glu, glw, glew, gl</literal> and
+ <literal>egl, gl, glesv2, glew, glu, glut, glw</literal> and
<literal>linux</literal>. For backwards compatibility, the
value of <literal>yes</literal> maps to
<literal>glu</literal>.</para>
@@ -1120,10 +1120,10 @@ USE_XORG= x11 xpm</programlisting>
Users can choose
<package role="port">x11-toolkits/lesstif</package>
instead by setting <varname>WANT_LESSTIF</varname>
- variable.</para>
+ variable in their <filename>make.conf</filename>.</para>
<para>The <varname>MOTIFLIB</varname> variable will be set by
- <filename>bsd.port.mk</filename> to reference the
+ <filename>motif.mk</filename> to reference the
appropriate Motif library. Please patch the source of your
port to use <literal>${MOTIFLIB}</literal> wherever
the Motif library is referenced in the original
@@ -1150,7 +1150,7 @@ USE_XORG= x11 xpm</programlisting>
</itemizedlist>
<para>Note that <varname>MOTIFLIB</varname> (usually) expands
- to <literal>-L/usr/local/lib -lXm</literal> or
+ to <literal>-L/usr/local/lib -lXm -lXp</literal> or
<literal>/usr/local/lib/libXm.a</literal>, so there is no
need to add <literal>-L</literal> or <literal>-l</literal>
in front.</para>
@@ -1172,7 +1172,9 @@ USE_XORG= x11 xpm</programlisting>
that operate headless. When the following variable is used,
the build infrastructure will start the virtual framebuffer
X server. The working <envar>DISPLAY</envar> is then passed
- to the build.</para>
+ to the build. See <link
+ linkend="uses-display"><literal>USES=display</literal></link>
+ for the possible arguments.</para>
<programlisting>USES= display</programlisting>
</sect2>
@@ -2689,9 +2691,6 @@ _DOCSDIR= .
the value of the <varname>PYTHONPREFIX_SITELIBDIR</varname>
variable to make it relative to
<varname>PREFIX</varname>.</para>
-
- <para>Python 2.7 or newer is required for this. It does
- not work with Python 2.6.</para>
</sect1>
<sect1 xml:id="using-tcl">
@@ -2700,96 +2699,75 @@ _DOCSDIR= .
<para>The Ports Collection supports parallel installation of
multiple <application>Tcl/Tk</application> versions. Ports
should try to support at least the default
- <application>Tcl/Tk</application> version and higher with the
- <varname>USE_TCL</varname> and <varname>USE_TK</varname>
- variables. It is possible to specify the desired version of
- <command>tcl</command> with the
- <varname>WITH_TCL_VER</varname> variable.</para>
+ <application>Tcl/Tk</application> version and higher with
+ <literal>USES=tcl</literal>. It is possible to specify the
+ desired version of <command>tcl</command> by appending
+ <literal>:<replaceable>xx</replaceable></literal>, e.g.:
+ <literal>USES=tcl:85</literal>.</para>
<table frame="none">
- <title>The Most Useful Variables for Ports That Use
+ <title>The Most Useful Read-Only Variables for Ports That Use
<application>Tcl/Tk</application></title>
<tgroup cols="2">
<tbody>
<row>
- <entry><varname>USE_TCL</varname></entry>
- <entry>The port depends on the
- <application>Tcl</application> library (not the
- shell). Minimal required version can be specified
- with values such as 84+. Individual unsupported
- versions can be specified with the
- <varname>INVALID_TCL_VER</varname> variable.</entry>
- </row>
-
- <row>
- <entry><varname>USE_TCL_BUILD</varname></entry>
- <entry>The port needs <application>Tcl</application>
- only during the build time.</entry>
+ <entry><varname>TCL_VER</varname></entry>
+ <entry> chosen major.minor version of
+ <application>Tcl</application></entry>
</row>
<row>
- <entry><varname>USE_TCL_WRAPPER</varname></entry>
- <entry>Ports that require the
- <application>Tcl</application> shell and do not
- require a specific <literal>tclsh</literal> version
- should use this new variable. The
- <literal>tclsh</literal> wrapper is installed on the
- system. The user can specify the desired
- <command>tcl</command> shell to use.</entry>
+ <entry><varname>TCLSH</varname></entry>
+ <entry> full path of the <application>Tcl</application>
+ interpreter</entry>
</row>
<row>
- <entry><varname>WITH_TCL_VER</varname></entry>
- <entry>User-defined variable that sets the desired
- <application>Tcl</application> version.</entry>
+ <entry><varname>TCL_LIBDIR</varname></entry>
+ <entry> path of the <application>Tcl</application>
+ libraries</entry>
</row>
<row>
- <entry><varname><replaceable>UNIQUENAME</replaceable>_WITH_TCL_VER</varname></entry>
- <entry>Like <varname>WITH_TCL_VER</varname>, but
- per-port.</entry>
+ <entry><varname>TCL_INCLUDEDIR</varname></entry>
+ <entry> path of the <application>Tcl</application> C
+ header files</entry>
</row>
<row>
- <entry><varname>USE_TCL_THREADS</varname></entry>
- <entry>Require a threaded build of
- <application>Tcl/Tk</application>.</entry>
+ <entry><varname>TK_VER</varname></entry>
+ <entry> chosen major.minor version of
+ <application>Tk</application></entry>
</row>
<row>
- <entry><varname>USE_TK</varname></entry>
- <entry>The port depends on the
- <application>Tk</application> library (not the wish
- shell). Implies <varname>USE_TCL</varname> with the
- same value. For more information see the description
- of <varname>USE_TCL</varname> variable.</entry>
+ <entry><varname>WISH</varname></entry>
+ <entry> full path of the <application>Tk</application>
+ interpreter</entry>
</row>
<row>
- <entry><varname>USE_TK_BUILD</varname></entry>
- <entry>Analog to the <varname>USE_TCL_BUILD</varname>
- variable.</entry>
+ <entry><varname>TK_LIBDIR</varname></entry>
+ <entry> path of the <application>Tk</application>
+ libraries</entry>
</row>
<row>
- <entry><varname>USE_TK_WRAPPER</varname></entry>
- <entry>Analog to the <varname>USE_TCL_WRAPPER</varname>
- variable.</entry>
- </row>
-
- <row>
- <entry><varname>WITH_TK_VER</varname></entry>
- <entry>Analog to the <varname>WITH_TCL_VER</varname>
- variable and implies <varname>WITH_TCL_VER</varname>
- of the same value.</entry>
+ <entry><varname>TK_INCLUDEDIR</varname></entry>
+ <entry> path of the <application>Tk</application> C header
+ files</entry>
</row>
</tbody>
</tgroup>
</table>
- <para>A complete list of available variables can be found in
- <filename>/usr/ports/Mk/bsd.tcl.mk</filename>.</para>
+ <para>See the <link
+ linkend="uses-tcl"><literal>USES=tcl</literal></link> and
+ <link linkend="uses-tk"><literal>USES=tk</literal></link> of
+ <xref linkend="uses-values"/> for a full description of those
+ variables. A complete list of those variables is available in
+ <filename>/usr/ports/Mk/Uses/tcl.mk</filename>.</para>
</sect1>
<sect1 xml:id="using-emacs">
@@ -2865,40 +2843,40 @@ _DOCSDIR= .
<entry>Used as a <varname>PKGNAMEPREFIX</varname> to
distinguish packages for different Ruby
versions.</entry>
- <entry><literal>ruby18-</literal></entry>
+ <entry><literal>ruby19-</literal></entry>
</row>
<row>
<entry><varname>RUBY_VERSION</varname></entry>
<entry>Full version of Ruby in the form of
- <literal>x.y.z</literal>.</entry>
- <entry><literal>1.8.2</literal></entry>
+ <literal>x.y.z[.p]</literal>.</entry>
+ <entry><literal>1.9.3.484</literal></entry>
</row>
<row>
<entry><varname>RUBY_SITELIBDIR</varname></entry>
<entry>Architecture independent libraries installation
path.</entry>
- <entry><literal>/usr/local/lib/ruby/site_ruby/1.8</literal></entry>
+ <entry><literal>/usr/local/lib/ruby/site_ruby/1.9</literal></entry>
</row>
<row>
<entry><varname>RUBY_SITEARCHLIBDIR</varname></entry>
<entry>Architecture dependent libraries installation
path.</entry>
- <entry><literal>/usr/local/lib/ruby/site_ruby/1.8/amd64-freebsd6</literal></entry>
+ <entry><literal>/usr/local/lib/ruby/site_ruby/1.9/amd64-freebsd10</literal></entry>
</row>
<row>
<entry><varname>RUBY_MODDOCDIR</varname></entry>
<entry>Module documentation installation path.</entry>
- <entry><literal>/usr/local/share/doc/ruby18/patsy</literal></entry>
+ <entry><literal>/usr/local/share/doc/ruby19/patsy</literal></entry>
</row>
<row>
<entry><varname>RUBY_MODEXAMPLESDIR</varname></entry>
<entry>Module examples installation path.</entry>
- <entry><literal>/usr/local/share/examples/ruby18/patsy</literal></entry>
+ <entry><literal>/usr/local/share/examples/ruby19/patsy</literal></entry>
</row>
</tbody>
</tgroup>
@@ -4751,7 +4729,10 @@ run_rc_command "$1"</programlisting>
<command>perl</command>, <command>python</command>, or
<command>ruby</command>, make certain that
<varname>command_interpreter</varname> is set
- appropriately. Otherwise,</para>
+ appropriately, e.g., for <application>Perl</application>,
+ by adding <literal>PERL=${PERL}</literal> to
+ <varname>SUB_LIST</varname> and using
+ <literal>%%PERL%%</literal>. Otherwise,</para>
<screen>&prompt.root; <userinput>service name stop</userinput></screen>
More information about the svn-doc-head
mailing list