os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Update and complete the section on porting SDL

Browse source 
Submitted by:	mva
This commit is contained in:
Eitan Adler 2013-11-17 16:10:31 +00:00
parent ad868f12d7
commit 7b2ae6ea86
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=43202
1 changed files with 62 additions and 12 deletions

74
en_US.ISO8859-1/books/porters-handbook/book.xml
View file

@ -8142,9 +8142,9 @@ _DOCSDIR= .
<para>The <varname>USE_SDL</varname> variable is used to
autoconfigure the dependencies for ports which use an SDL
based library like
<package>devel/sdl12</package> and <package>x11-toolkits/sdl_gui</package>.</para>
<package>devel/sdl12</package> and <package>graphics/sdl_image</package>.</para>
<para>The following SDL libraries are recognized at the
<para>The following SDL libraries for version 1.2 are recognized at the
moment:</para>
<itemizedlist>
@ -8152,22 +8152,18 @@ _DOCSDIR= .
<para>sdl: <package>devel/sdl12</package></para>
</listitem>
<listitem>
<para>console: <package>devel/sdl_console</package></para>
</listitem>
<listitem>
<para>gfx: <package>graphics/sdl_gfx</package></para>
</listitem>
<listitem>
<para>gui: <package>x11-toolkits/sdl_gui</package></para>
</listitem>
<listitem>
<para>image: <package>graphics/sdl_image</package></para>
</listitem>
<listitem>
<para>ldbad: <package>devel/sdl_ldbad</package></para>
</listitem>
<listitem>
<para>mixer: <package>audio/sdl_mixer</package></para>
</listitem>
@ -8180,6 +8176,10 @@ _DOCSDIR= .
<para>net: <package>net/sdl_net</package></para>
</listitem>
<listitem>
<para>pango: <package>x11-toolkits/sdl_pango</package></para>
</listitem>
<listitem>
<para>sound: <package>audio/sdl_sound</package></para>
</listitem>
@ -8189,6 +8189,35 @@ _DOCSDIR= .
</listitem>
</itemizedlist>
<para>The following SDL libraries for version 2.0 are recognized at the
moment:</para>
<itemizedlist>
<listitem>
<para>sdl: <package>devel/sdl20</package></para>
</listitem>
<listitem>
<para>gfx: <package>graphics/sdl2_gfx</package></para>
</listitem>
<listitem>
<para>image: <package>graphics/sdl2_image</package></para>
</listitem>
<listitem>
<para>mixer: <package>audio/sdl2_mixer</package></para>
</listitem>
<listitem>
<para>net: <package>net/sdl2_net</package></para>
</listitem>
<listitem>
<para>ttf: <package>graphics/sdl2_ttf</package></para>
</listitem>
</itemizedlist>
<para>Therefore, if a port has a dependency on
<package>net/sdl_net</package> and
<package>audio/sdl_mixer</package>,
@ -8202,8 +8231,8 @@ _DOCSDIR= .
and <package>audio/sdl_mixer</package>, is
automatically added as well.</para>
<para>If you use <varname>USE_SDL</varname>, it will
automatically:</para>
<para>If you use <varname>USE_SDL</varname> with entries using
SDL 1.2, it will automatically:</para>
<itemizedlist>
<listitem>
@ -8223,6 +8252,27 @@ _DOCSDIR= .
</listitem>
</itemizedlist>
<para>If you use <varname>USE_SDL</varname> with entries using
SDL 2.0, it will automatically:</para>
<itemizedlist>
<listitem>
<para>Add a dependency on
<application>sdl2-config</application> to
<varname>BUILD_DEPENDS</varname></para>
</listitem>
<listitem>
<para>Add the variable <varname>SDL2_CONFIG</varname> to
<varname>CONFIGURE_ENV</varname></para>
</listitem>
<listitem>
<para>Add the dependencies of the selected libraries to the
<varname>LIB_DEPENDS</varname></para>
</listitem>
</itemizedlist>
<para>To check whether an SDL library is available, you can do
it with the <varname>WANT_SDL</varname> variable:</para>