Update the special chapter.
Sponsored by: Absolight
This commit is contained in:
		
							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
				
			
		|  | @ -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> | ||||
| 	    <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> | ||||
| 
 | ||||
|  |  | |||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue