Skip site navigation (1)Skip section navigation (2)
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>&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>
-	  </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>