Differential D20732 Diff 59500 en_US.ISO8859-1/books/porters-handbook/special/chapter.xml

Changeset View

Standalone View

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

Show First 20 Lines • Show All 1,534 Lines • ▼ Show 20 Lines	USE_PERL5= modbuildtiny</programlisting>

<sect1 xml:id="using-x11">		<sect1 xml:id="using-x11">
<title>Using X11</title>		<title>Using X11</title>

<sect2 xml:id="x11-variables">		<sect2 xml:id="x11-variables">
<title>X.Org Components</title>		<title>X.Org Components</title>

<para>The X11 implementation available in The Ports Collection		<para>The X11 implementation available in The Ports Collection
is X.Org. If the application depends on X components, set		is X.Org. If the application depends on X components, add
		<varname>USES= xorg</varname> and set
<varname>USE_XORG</varname> to the list of required		<varname>USE_XORG</varname> to the list of required
components. A full list can be found in <xref		components. A full list can be found in <xref
linkend="using-x11-components" />. An always up-to-date		linkend="uses-xorg" />.</para>
list can be found in
<filename>/usr/ports/Mk/bsd.xorg.mk</filename>.</para>

<table frame="none" xml:id="using-x11-components">
<title>Available X.Org Components</title>

<tgroup cols="2">
<thead>
<row>
<entry>Name</entry>
<entry>Description</entry>
</row>
</thead>

<!-- From any ports checkout, run
for m in $(make -C x11/libX11 -V XORG_MODULES:O); do
port=$(make -C x11/libX11 -V "${m}_LIB_PC_DEPENDS:C/^.*://")
if [ -z "$port" ]; then
port=$(make -C x11/libX11 -V "${m}_BUILD_DEPENDS:C/^.*://")
fi
description=$(make -C "$port" -V COMMENT)
printf "<row>\n<entry><literal>$m</literal></entry>\n<entry>$description</entry>\n</row>\n\n"
done
-->
<tbody>
<row>
<entry><literal>dmx</literal></entry>
<entry>DMX extension library</entry>
</row>

<row>
<entry><literal>fontenc</literal></entry>
<entry>The fontenc Library</entry>
</row>

<row>
<entry><literal>fontutil</literal></entry>
<entry>Create an index of X font files in a
directory</entry>
</row>

<row>
<entry><literal>ice</literal></entry>
<entry>Inter Client Exchange library for X11</entry>
</row>

<row>
<entry><literal>libfs</literal></entry>
<entry>The FS library</entry>
</row>

<row>
<entry><literal>oldx</literal></entry>
<entry>Old X library</entry>
</row>

<row>
<entry><literal>pciaccess</literal></entry>
<entry>Generic PCI access library</entry>
</row>

<row>
<entry><literal>pixman</literal></entry>
<entry>Low-level pixel manipulation library</entry>
</row>

<row>
<entry><literal>sm</literal></entry>
<entry>Session Management library for X11</entry>
</row>

<row>
<entry><literal>x11</literal></entry>
<entry>X11 library</entry>
</row>

<row>
<entry><literal>xau</literal></entry>
<entry>Authentication Protocol library for X11</entry>
</row>

<row>
<entry><literal>xaw</literal></entry>
<entry>X Athena Widgets library</entry>
</row>

<row>
<entry><literal>xaw6</literal></entry>
<entry>X Athena Widgets library</entry>
</row>

<row>
<entry><literal>xaw7</literal></entry>
<entry>X Athena Widgets library</entry>
</row>

<row>
<entry><literal>xbitmaps</literal></entry>
<entry>X.Org bitmaps data</entry>
</row>

<row>
<entry><literal>xcb</literal></entry>
<entry>The X protocol C-language Binding (XCB)
library</entry>
</row>

<row>
<entry><literal>xcomposite</literal></entry>
<entry>X Composite extension library</entry>
</row>

<row>
<entry><literal>xcursor</literal></entry>
<entry>X client-side cursor loading library</entry>
</row>

<row>
<entry><literal>xdamage</literal></entry>
<entry>X Damage extension library</entry>
</row>

<row>
<entry><literal>xdmcp</literal></entry>
<entry>X Display Manager Control Protocol
library</entry>
</row>

<row>
<entry><literal>xevie</literal></entry>
<entry>The Xevie library</entry>
</row>

<row>
<entry><literal>xext</literal></entry>
<entry>X11 Extension library</entry>
</row>

<row>
<entry><literal>xfixes</literal></entry>
<entry>X Fixes extension library</entry>
</row>

<row>
<entry><literal>xfont</literal></entry>
<entry>X font library</entry>
</row>

<row>
<entry><literal>xfont2</literal></entry>
<entry>X font library version 2.x</entry>
</row>

<row>
<entry><literal>xfontcache</literal></entry>
<entry>The Xfontcache library</entry>
</row>

<row>
<entry><literal>xft</literal></entry>
<entry>Client-sided font API for X applications</entry>
</row>

<row>
<entry><literal>xi</literal></entry>
<entry>X Input extension library</entry>
</row>

<row>
<entry><literal>xinerama</literal></entry>
<entry>X11 Xinerama library</entry>
</row>

<row>
<entry><literal>xkbfile</literal></entry>
<entry>XKB file library</entry>
</row>

<row>
<entry><literal>xkbui</literal></entry>
<entry>The xkbui library</entry>
</row>

<row>
<entry><literal>xmu</literal></entry>
<entry>X Miscellaneous Utilities libraries</entry>
</row>

<row>
<entry><literal>xmuu</literal></entry>
<entry>X Miscellaneous Utilities libraries</entry>
</row>

<row>
<entry><literal>xorg-macros</literal></entry>
<entry>X.Org development aclocal macros</entry>
</row>

<row>
<entry><literal>xorg-server</literal></entry>
<entry>X.Org X server and related programs</entry>
</row>

<row>
<entry><literal>xorgproto</literal></entry>
<entry>X.Org protocol headers</entry>
</row>

<row>
<entry><literal>xp</literal></entry>
<entry>X print library</entry>
</row>

<row>
<entry><literal>xpm</literal></entry>
<entry>X Pixmap library</entry>
</row>

<row>
<entry><literal>xprintapputil</literal></entry>
<entry>The XprintAppUtil library</entry>
</row>

<row>
<entry><literal>xprintutil</literal></entry>
<entry>The XprintUtil library</entry>
</row>

<row>
<entry><literal>xrandr</literal></entry>
<entry>X Resize and Rotate extension library</entry>
</row>

<row>
<entry><literal>xrender</literal></entry>
<entry>X Render extension library</entry>
</row>

<row>
<entry><literal>xres</literal></entry>
<entry>X Resource usage library</entry>
</row>

<row>
<entry><literal>xscrnsaver</literal></entry>
<entry>The XScrnSaver library</entry>
</row>

<row>
<entry><literal>xshmfence</literal></entry>
<entry>Shared memory 'SyncFence' synchronization
primitive</entry>
</row>

<row>
<entry><literal>xt</literal></entry>
<entry>X Toolkit library</entry>
</row>

<row>
<entry><literal>xtrans</literal></entry>
<entry>Abstract network code for X</entry>
</row>

<row>
<entry><literal>xtrap</literal></entry>
<entry>The XTrap library</entry>
</row>

<row>
<entry><literal>xtst</literal></entry>
<entry>X Test extension</entry>
</row>

<row>
<entry><literal>xv</literal></entry>
<entry>X Video Extension library</entry>
</row>

<row>
<entry><literal>xvmc</literal></entry>
<entry>X Video Extension Motion Compensation
library</entry>
</row>

<row>
<entry><literal>xxf86dga</literal></entry>
<entry>X DGA Extension</entry>
</row>

<row>
<entry><literal>xxf86misc</literal></entry>
<entry>X XF86-Misc Extension</entry>
</row>

<row>
<entry><literal>xxf86vm</literal></entry>
<entry>X Vidmode Extension</entry>
</row>
</tbody>
</tgroup>
</table>

<para>The Mesa Project is an effort to provide free OpenGL		<para>The Mesa Project is an effort to provide free OpenGL
implementation. To specify a dependency on various		implementation. To specify a dependency on various
components of this project, use <literal>USES= gl</literal>		components of this project, use <literal>USES= gl</literal>
and <varname>USE_GL</varname>. See		and <varname>USE_GL</varname>. See
<xref linkend="uses-gl" /> for a full list of available		<xref linkend="uses-gl" /> for a full list of available
components. For backwards compatibility, the value of		components. For backwards compatibility, the value of
<literal>yes</literal> maps to <literal>glu</literal>.</para>		<literal>yes</literal> maps to <literal>glu</literal>.</para>

<example xml:id="use-xorg-example">		<example xml:id="use-xorg-example">
<title><varname>USE_XORG</varname> Example</title>		<title><varname>USE_XORG</varname> Example</title>
		matUnsubmitted Done Inline Actions Probably needs to reword the title here. mat: Probably needs to reword the title here.

<programlisting>USES= gl		<programlisting>USES= gl
		matUnsubmitted Done Inline Actions missing `xorg` here. mat: missing `xorg` here.
USE_GL= glu		USE_GL= glu
USE_XORG= xrender xft xkbfile xt xaw</programlisting>		USE_XORG= xrender xft xkbfile xt xaw</programlisting>
</example>		</example>

<table frame="none" xml:id="using-xorg-variables">		<table frame="none" xml:id="using-xorg-variables">
<title>Variables for Ports That Use X</title>		<title>Variables for Ports That Use X</title>

<tgroup cols="2">		<tgroup cols="2">
Show All 12 Lines	<tgroup cols="2">
</tbody>		</tbody>
</tgroup>		</tgroup>
</table>		</table>

<example xml:id="using-x11-vars">		<example xml:id="using-x11-vars">
<title>Using X11-Related Variables</title>		<title>Using X11-Related Variables</title>

<programlisting># Use some X11 libraries		<programlisting># Use some X11 libraries
USE_XORG= x11 xpm</programlisting>		USE_XORG= x11 xpm</programlisting>
		matUnsubmitted Done Inline Actions Probably needs `USES=xorg` here. mat: Probably needs `USES=xorg` here.
</example>		</example>
</sect2>		</sect2>

<sect2 xml:id="x11-motif">		<sect2 xml:id="x11-motif">
<title>Ports That Require Motif</title>		<title>Ports That Require Motif</title>

<para>If the port requires a Motif library, define		<para>If the port requires a Motif library, define
<varname>USES= motif</varname> in the		<varname>USES= motif</varname> in the
▲ Show 20 Lines • Show All 5,430 Lines • Show Last 20 Lines