os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Update the special chapter.

Browse source 
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
1 changed files with 67 additions and 86 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

153
en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
View file

@ -1048,19 +1048,19 @@ PLIST_SUB+= NLS="@comment "
are:</para> are:</para>
<para><literal>bigreqsproto compositeproto damageproto dmx <para><literal>bigreqsproto compositeproto damageproto dmx
dmxproto dri2proto evieproto fixesproto fontcacheproto dmxproto dri2proto dri3proto evieproto fixesproto
fontenc fontsproto fontutil glproto ice inputproto kbproto fontcacheproto fontenc fontsproto fontutil glproto ice
libfs oldx pciaccess pixman printproto randrproto inputproto kbproto libfs oldx pciaccess pixman presentproto
recordproto renderproto resourceproto scrnsaverproto sm printproto randrproto recordproto renderproto resourceproto
trapproto videoproto x11 xau xaw xaw6 xaw7 xbitmaps scrnsaverproto sm trapproto videoproto x11 xau xaw xaw6 xaw7
xcmiscproto xcomposite xcursor xdamage xdmcp xevie xext xbitmaps xcb xcmiscproto xcomposite xcursor xdamage xdmcp
xextproto xf86bigfontproto xf86dgaproto xf86driproto xevie xext xextproto xf86bigfontproto xf86dgaproto
xf86miscproto xf86rushproto xf86vidmodeproto xfixes xfont xf86driproto xf86miscproto xf86rushproto xf86vidmodeproto
xfontcache xft xi xinerama xineramaproto xkbfile xkbui xfixes xfont xfontcache xft xi xinerama xineramaproto
xmu xmuu xorg-server xp xpm xprintapputil xprintutil xkbfile xkbui xmu xmuu xorg-macros xorg-server xp xpm
xproto xproxymngproto xrandr xrender xres xscrnsaver xt xprintapputil xprintutil xproto xproxymngproto xrandr
xtrans xtrap xtst xv xvmc xxf86dga xxf86misc xrender xres xscrnsaver xshmfence xt xtrans xtrap xtst xv
xxf86vm</literal>.</para> xvmc xxf86dga xxf86misc xxf86vm</literal>.</para>
<para>Always up-to-date list can be found in <para>Always up-to-date list can be found in
<filename>/usr/ports/Mk/bsd.xorg.mk</filename>.</para> <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 implementation. You can specify a dependency on various
components of this project with <varname>USE_GL</varname> components of this project with <varname>USE_GL</varname>
variable. Valid options are: 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 <literal>linux</literal>. For backwards compatibility, the
value of <literal>yes</literal> maps to value of <literal>yes</literal> maps to
<literal>glu</literal>.</para> <literal>glu</literal>.</para>
@ -1120,10 +1120,10 @@ USE_XORG= x11 xpm</programlisting>
Users can choose Users can choose
<package role="port">x11-toolkits/lesstif</package> <package role="port">x11-toolkits/lesstif</package>
instead by setting <varname>WANT_LESSTIF</varname> 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 <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 appropriate Motif library. Please patch the source of your
port to use <literal>&dollar;{MOTIFLIB}</literal> wherever port to use <literal>&dollar;{MOTIFLIB}</literal> wherever
the Motif library is referenced in the original the Motif library is referenced in the original
@ -1150,7 +1150,7 @@ USE_XORG= x11 xpm</programlisting>
</itemizedlist> </itemizedlist>
<para>Note that <varname>MOTIFLIB</varname> (usually) expands <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 <literal>/usr/local/lib/libXm.a</literal>, so there is no
need to add <literal>-L</literal> or <literal>-l</literal> need to add <literal>-L</literal> or <literal>-l</literal>
in front.</para> in front.</para>
@ -1172,7 +1172,9 @@ USE_XORG= x11 xpm</programlisting>
that operate headless. When the following variable is used, that operate headless. When the following variable is used,
the build infrastructure will start the virtual framebuffer the build infrastructure will start the virtual framebuffer
X server. The working <envar>DISPLAY</envar> is then passed 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> <programlisting>USES= display</programlisting>
</sect2> </sect2>
@ -2689,9 +2691,6 @@ _DOCSDIR= .
the value of the <varname>PYTHONPREFIX_SITELIBDIR</varname> the value of the <varname>PYTHONPREFIX_SITELIBDIR</varname>
variable to make it relative to variable to make it relative to
<varname>PREFIX</varname>.</para> <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>
<sect1 xml:id="using-tcl"> <sect1 xml:id="using-tcl">
@ -2700,96 +2699,75 @@ _DOCSDIR= .
<para>The Ports Collection supports parallel installation of <para>The Ports Collection supports parallel installation of
multiple <application>Tcl/Tk</application> versions. Ports multiple <application>Tcl/Tk</application> versions. Ports
should try to support at least the default should try to support at least the default
<application>Tcl/Tk</application> version and higher with the <application>Tcl/Tk</application> version and higher with
<varname>USE_TCL</varname> and <varname>USE_TK</varname> <literal>USES=tcl</literal>. It is possible to specify the
variables. It is possible to specify the desired version of desired version of <command>tcl</command> by appending
<command>tcl</command> with the <literal>:<replaceable>xx</replaceable></literal>, e.g.:
<varname>WITH_TCL_VER</varname> variable.</para> <literal>USES=tcl:85</literal>.</para>
<table frame="none"> <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> <application>Tcl/Tk</application></title>
<tgroup cols="2"> <tgroup cols="2">
<tbody> <tbody>
<row> <row>
<entry><varname>USE_TCL</varname></entry> <entry><varname>TCL_VER</varname></entry>
<entry>The port depends on the <entry> chosen major.minor version of
<application>Tcl</application> library (not the <application>Tcl</application></entry>
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>
<row> <row>
<entry><varname>USE_TCL_BUILD</varname></entry> <entry><varname>TCLSH</varname></entry>
<entry>The port needs <application>Tcl</application> <entry> full path of the <application>Tcl</application>
only during the build time.</entry> interpreter</entry>
</row> </row>
<row> <row>
<entry><varname>USE_TCL_WRAPPER</varname></entry> <entry><varname>TCL_LIBDIR</varname></entry>
<entry>Ports that require the <entry> path of the <application>Tcl</application>
<application>Tcl</application> shell and do not libraries</entry>
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>
</row> </row>
<row> <row>
<entry><varname>WITH_TCL_VER</varname></entry> <entry><varname>TCL_INCLUDEDIR</varname></entry>
<entry>User-defined variable that sets the desired <entry> path of the <application>Tcl</application> C
<application>Tcl</application> version.</entry> header files</entry>
</row> </row>
<row> <row>
<entry><varname><replaceable>UNIQUENAME</replaceable>_WITH_TCL_VER</varname></entry> <entry><varname>TK_VER</varname></entry>
<entry>Like <varname>WITH_TCL_VER</varname>, but <entry> chosen major.minor version of
per-port.</entry> <application>Tk</application></entry>
</row> </row>
<row> <row>
<entry><varname>USE_TCL_THREADS</varname></entry> <entry><varname>WISH</varname></entry>
<entry>Require a threaded build of <entry> full path of the <application>Tk</application>
<application>Tcl/Tk</application>.</entry> interpreter</entry>
</row> </row>
<row> <row>
<entry><varname>USE_TK</varname></entry> <entry><varname>TK_LIBDIR</varname></entry>
<entry>The port depends on the <entry> path of the <application>Tk</application>
<application>Tk</application> library (not the wish libraries</entry>
shell). Implies <varname>USE_TCL</varname> with the
same value. For more information see the description
of <varname>USE_TCL</varname> variable.</entry>
</row> </row>
<row> <row>
<entry><varname>USE_TK_BUILD</varname></entry> <entry><varname>TK_INCLUDEDIR</varname></entry>
<entry>Analog to the <varname>USE_TCL_BUILD</varname> <entry> path of the <application>Tk</application> C header
variable.</entry> files</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>
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
</table> </table>
<para>A complete list of available variables can be found in <para>See the <link
<filename>/usr/ports/Mk/bsd.tcl.mk</filename>.</para> 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>
<sect1 xml:id="using-emacs"> <sect1 xml:id="using-emacs">
@ -2865,40 +2843,40 @@ _DOCSDIR= .
<entry>Used as a <varname>PKGNAMEPREFIX</varname> to <entry>Used as a <varname>PKGNAMEPREFIX</varname> to
distinguish packages for different Ruby distinguish packages for different Ruby
versions.</entry> versions.</entry>
<entry><literal>ruby18-</literal></entry> <entry><literal>ruby19-</literal></entry>
</row> </row>
<row> <row>
<entry><varname>RUBY_VERSION</varname></entry> <entry><varname>RUBY_VERSION</varname></entry>
<entry>Full version of Ruby in the form of <entry>Full version of Ruby in the form of
<literal>x.y.z</literal>.</entry> <literal>x.y.z[.p]</literal>.</entry>
<entry><literal>1.8.2</literal></entry> <entry><literal>1.9.3.484</literal></entry>
</row> </row>
<row> <row>
<entry><varname>RUBY_SITELIBDIR</varname></entry> <entry><varname>RUBY_SITELIBDIR</varname></entry>
<entry>Architecture independent libraries installation <entry>Architecture independent libraries installation
path.</entry> 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>
<row> <row>
<entry><varname>RUBY_SITEARCHLIBDIR</varname></entry> <entry><varname>RUBY_SITEARCHLIBDIR</varname></entry>
<entry>Architecture dependent libraries installation <entry>Architecture dependent libraries installation
path.</entry> 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>
<row> <row>
<entry><varname>RUBY_MODDOCDIR</varname></entry> <entry><varname>RUBY_MODDOCDIR</varname></entry>
<entry>Module documentation installation path.</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>
<row> <row>
<entry><varname>RUBY_MODEXAMPLESDIR</varname></entry> <entry><varname>RUBY_MODEXAMPLESDIR</varname></entry>
<entry>Module examples installation path.</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> </row>
</tbody> </tbody>
</tgroup> </tgroup>
@ -4751,7 +4729,10 @@ run_rc_command "$1"</programlisting>
<command>perl</command>, <command>python</command>, or <command>perl</command>, <command>python</command>, or
<command>ruby</command>, make certain that <command>ruby</command>, make certain that
<varname>command_interpreter</varname> is set <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> <screen>&prompt.root; <userinput>service name stop</userinput></screen>