Date: Wed, 19 Mar 2014 13:13:29 +0000 (UTC) From: Mathieu Arnold <mat@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44282 - head/en_US.ISO8859-1/books/porters-handbook/special Message-ID: <201403191313.s2JDDTRx045493@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201403191313.s2JDDTRx045493>