Update the special chapter.

Sponsored by:	Absolight
This commit is contained in:
Mathieu Arnold 2014-03-19 13:13:29 +00:00
parent 6a2f4af72e
commit 50a10a110a
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=44282

View file

@ -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>&dollar;{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&nbsp;2.7 or newer is required for this. It does
not work with Python&nbsp;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>
<entry><varname>TCL_VER</varname></entry>
<entry> chosen major.minor version of
<application>Tcl</application></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>TCLSH</varname></entry>
<entry> full path of the <application>Tcl</application>
interpreter</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>TCL_LIBDIR</varname></entry>
<entry> path of the <application>Tcl</application>
libraries</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_INCLUDEDIR</varname></entry>
<entry> path of the <application>Tcl</application> C
header files</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>TK_VER</varname></entry>
<entry> chosen major.minor version of
<application>Tk</application></entry>
</row>
<row>
<entry><varname>USE_TCL_THREADS</varname></entry>
<entry>Require a threaded build of
<application>Tcl/Tk</application>.</entry>
<entry><varname>WISH</varname></entry>
<entry> full path of the <application>Tk</application>
interpreter</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>TK_LIBDIR</varname></entry>
<entry> path of the <application>Tk</application>
libraries</entry>
</row>
<row>
<entry><varname>USE_TK_BUILD</varname></entry>
<entry>Analog to the <varname>USE_TCL_BUILD</varname>
variable.</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>