From owner-svn-doc-all@FreeBSD.ORG Sun Nov 17 16:10:32 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 63F2D12C; Sun, 17 Nov 2013 16:10:32 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 5364C2589; Sun, 17 Nov 2013 16:10:32 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id rAHGAWZi058328; Sun, 17 Nov 2013 16:10:32 GMT (envelope-from eadler@svn.freebsd.org) Received: (from eadler@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id rAHGAW94058327; Sun, 17 Nov 2013 16:10:32 GMT (envelope-from eadler@svn.freebsd.org) Message-Id: <201311171610.rAHGAW94058327@svn.freebsd.org> From: Eitan Adler Date: Sun, 17 Nov 2013 16:10:32 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43202 - head/en_US.ISO8859-1/books/porters-handbook X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.16 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 17 Nov 2013 16:10:32 -0000 Author: eadler Date: Sun Nov 17 16:10:31 2013 New Revision: 43202 URL: http://svnweb.freebsd.org/changeset/doc/43202 Log: Update and complete the section on porting SDL Submitted by: mva Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/book.xml Sun Nov 17 16:09:51 2013 (r43201) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Sun Nov 17 16:10:31 2013 (r43202) @@ -8142,9 +8142,9 @@ _DOCSDIR= . The USE_SDL variable is used to autoconfigure the dependencies for ports which use an SDL based library like - devel/sdl12 and x11-toolkits/sdl_gui. + devel/sdl12 and graphics/sdl_image. - The following SDL libraries are recognized at the + The following SDL libraries for version 1.2 are recognized at the moment: @@ -8153,11 +8153,11 @@ _DOCSDIR= . - gfx: graphics/sdl_gfx + console: devel/sdl_console - gui: x11-toolkits/sdl_gui + gfx: graphics/sdl_gfx @@ -8165,10 +8165,6 @@ _DOCSDIR= . - ldbad: devel/sdl_ldbad - - - mixer: audio/sdl_mixer @@ -8181,6 +8177,10 @@ _DOCSDIR= . + pango: x11-toolkits/sdl_pango + + + sound: audio/sdl_sound @@ -8189,6 +8189,35 @@ _DOCSDIR= . + The following SDL libraries for version 2.0 are recognized at the + moment: + + + + sdl: devel/sdl20 + + + + gfx: graphics/sdl2_gfx + + + + image: graphics/sdl2_image + + + + mixer: audio/sdl2_mixer + + + + net: net/sdl2_net + + + + ttf: graphics/sdl2_ttf + + + Therefore, if a port has a dependency on net/sdl_net and audio/sdl_mixer, @@ -8202,8 +8231,8 @@ _DOCSDIR= . and audio/sdl_mixer, is automatically added as well. - If you use USE_SDL, it will - automatically: + If you use USE_SDL with entries using + SDL 1.2, it will automatically: @@ -8223,6 +8252,27 @@ _DOCSDIR= . + If you use USE_SDL with entries using + SDL 2.0, it will automatically: + + + + Add a dependency on + sdl2-config to + BUILD_DEPENDS + + + + Add the variable SDL2_CONFIG to + CONFIGURE_ENV + + + + Add the dependencies of the selected libraries to the + LIB_DEPENDS + + + To check whether an SDL library is available, you can do it with the WANT_SDL variable: