svn commit: r53329 - in head/en_US.ISO8859-1/books/porters-handbook: makefiles special uses
Niclas Zeising
zeising at FreeBSD.org
Mon Aug 26 09:47:57 UTC 2019
Author: zeising
Date: Mon Aug 26 09:47:56 2019
New Revision: 53329
URL: https://svnweb.freebsd.org/changeset/doc/53329
Log:
Update porters handbook for USES=xorg xorg-cat
Update porters handbook to document the new USES=xorg and USES=xorg-cat
additions.
Reviewed by: mat
Differential Revision: https://reviews.freebsd.org/D20732
Modified:
head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Sun Aug 25 19:53:46 2019 (r53328)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Mon Aug 26 09:47:56 2019 (r53329)
@@ -6539,6 +6539,7 @@ SUB_LIST+= OPT1="@comment " NO_OPT1=""
<emphasis>not</emphasis> selected. For example:</para>
<programlisting>OPTIONS_DEFINE= OPT1
+OPT1_USES= xorg
OPT1_USE= mysql=yes xorg=x11,xextproto,xext,xrandr
OPT1_USE_OFF= openssl=yes</programlisting>
@@ -6550,6 +6551,7 @@ OPT1_USE_OFF= openssl=yes</programlisting>
.if ${PORT_OPTIONS:MOPT1}
USE_MYSQL= yes
+USES+= xorg
USE_XORG= x11 xextproto xext xrandr
.else
USE_OPENSSL= yes
@@ -7003,6 +7005,7 @@ CONFIGURE_ARGS+= --disable-opt2
<programlisting>OPTIONS_DEFINE= X11 GNOME
OPTIONS_DEFAULT= X11
+X11_USES= xorg
X11_USE= xorg=xi,xextproto
GNOME_USE= gnome=gtk30
GNOME_IMPLIES= X11</programlisting>
Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Sun Aug 25 19:53:46 2019 (r53328)
+++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Mon Aug 26 09:47:56 2019 (r53329)
@@ -1643,312 +1643,12 @@ USE_PERL5= modbuildtiny</programlisting>
<title>X.Org Components</title>
<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
components. A full list can be found in <xref
- linkend="using-x11-components" />. An always up-to-date
- list can be found in
- <filename>/usr/ports/Mk/bsd.xorg.mk</filename>.</para>
+ linkend="uses-xorg" />.</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
implementation. To specify a dependency on various
Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Sun Aug 25 19:53:46 2019 (r53328)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Mon Aug 26 09:47:56 2019 (r53329)
@@ -3438,6 +3438,338 @@ BROKEN_SSL_REASON_libressl= needs features only availa
<package role="port">x11-wm/xfce4-panel</package>.</para>
</sect1>
+ <sect1 xml:id="uses-xorg">
+ <title><literal>xorg</literal></title>
+
+ <para>Possible arguments: (none)</para>
+
+ <para>Provides an easy way to depend on
+ <application>X.org</application> components. The components
+ should be listed in <varname>USE_XORG</varname>. The available
+ components are:</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>
+ </sect1>
+
+ <sect1 xml:id="uses-xorg-cat">
+ <title><literal>xorg-cat</literal></title>
+
+ <para>Possible arguments: <literal>app</literal>, <literal>data</literal>,
+ <literal>doc</literal>, <literal>driver</literal>,
+ <literal>font</literal>, <literal>lib</literal>, <literal>proto</literal>,
+ <literal>util</literal>, <literal>xserver</literal> and (none) or one off
+ <literal>autotools</literal> (default), <literal>meson</literal></para>
+
+ <para>Provide support for building <application>Xorg</application>
+ components. It takes care of setting up common dependencies and an
+ appropriate configuration environment needed. This is intended only
+ for <application>Xorg</application> components.></para>
+
+ <para>The category has to match upstream categories.</para>
+
+ <para>The second argument is the build system to use.
+ <application>autotools</application> is the default, but
+ <application>meson</application> is also supported.</para>
+ </sect1>
+
<sect1 xml:id="uses-zip">
<title><literal>zip</literal></title>
More information about the svn-doc-all
mailing list