package/sfml: new package
PATCH 1/1 package/sfml: new package
--- package/Config.in | 1 + package/sfml/Config.in | 116 +++++++++++++++++++++++++++++++++++++++++ package/sfml/sfml.hash | 3 ++ package/sfml/sfml.mk | 79 ++++++++++++++++++++++++++++ 4 files changed, 199 insertions(+) create mode 100644 package/sfml/Config.in create mode 100644 package/sfml/sfml.hash create mode 100644 package/sfml/sfml.mk
package/Config.in +1 -0
@@ -314,6 +314,7 @@ comment "Graphic libraries" source "package/sdl2_mixer/Config.in" source "package/sdl2_net/Config.in" source "package/sdl2_ttf/Config.in" + source "package/sfml/Config.in" source "package/tk/Config.in" comment "Other GUIs"
package/sfml/Config.in new file +116 -0
116 lines not on this page · raw message
package/sfml/sfml.hash new file +3 -0
@@ -0,0 +1,3 @@ +# Locally calculated +sha256 438c91a917cc8aa19e82c6f59f8714da353c488584a007d401efac8368e1c785 sfml-2.5.1.tar.gz +sha256 8143f9ad51ddf0a5b0629beabf8e1432ac3e5a2f3b62b510f3b16712e4bb9143 license.md
package/sfml/sfml.mk new file +79 -0
80 lines not on this page · raw message
Signature · 1 line
2.21.0
PATCH 1/1 package/sfml: new package
Hello Victor,
Thanks for this contribution. There are (obviously) a number of issues with the patch, which is perfectly normal for a first submission of a not-so-trivial package. See below for all the comments.
Quoted 7 lines · On Mon, 27 May 2019 17:39:06 +0200 Victor Huesca <[email protected]>…
Signed-off-by Victor Huesca <[email protected]>--- package/Config.in | 1 + package/sfml/Config.in | 116 +++++++++++++++++++++++++++++++++++++++++ package/sfml/sfml.hash | 3 ++ package/sfml/sfml.mk | 79 ++++++++++++++++++++++++++++ 4 files changed, 199 insertions(+)
You need to add an entry to the DEVELOPERS file for this package, so that you can receive e-mail notifications of build failures happening on the autobuilders, and be Cc'ed on patches that are posted on this package.
package/sfml/Config.in line 3
Quoted 9 lines
package/sfml/Config.in new file +3
-0@@ -0,0 +1,116 @@ +config BR2_PACKAGE_SFML + bool "sfml" + # depends on BR2_PACKAGE_HAS_UDEV
Why is this commented ? I just tried a build, and it builds successfully without udev, so is it really a dependency ?
package/sfml/Config.in line 4
Quoted 1 line
package/sfml/Config.in new file +1
-0+
Please drop this empty new line.
package/sfml/Config.in line 13
Quoted 9 lines
package/sfml/Config.in new file +9
-0+ help + Simple and Fast Multimedia Library 2 - SFML provides a simple + interface to the various components of your PC, to ease the + development of games and multimedia applications. It is composed + of five modules: system, window, graphics, audio and network. + + https://www.sfml-dev.org/ + +
Two empty lines: keep only one.
package/sfml/Config.in line 21
Quoted 8 lines
package/sfml/Config.in new file +8
-0+if BR2_PACKAGE_SFML + +# X11 and OpenGL related stuff + +config BR2_PACKAGE_SFML_X11 + bool "X11 video driver" + depends on BR2_PACKAGE_XORG7 + # select BR2_PACKAGE_XLIB_LIBX11
Please don't keep comments.
Quoted 4 lines
package/sfml/Config.in new file +4
-0+ +comment "X11 video driver needs X.org" + depends on !BR2_PACKAGE_XORG7 +
package/sfml/Config.in line 35
Quoted 10 lines
package/sfml/Config.in new file +10
-0+config BR2_PACKAGE_SFML_OPENGL + bool "OpenGL (GLX)" + depends on BR2_PACKAGE_HAS_LIBGL && BR2_PACKAGE_SFML_X11 + +comment "OpenGL support needs X11 and an OpenGL provider" + depends on !BR2_PACKAGE_HAS_LIBGL || !BR2_PACKAGE_SFML_X11 + + + +
Please keep only one empty line.
package/sfml/Config.in line 36
Quoted 1 line
package/sfml/Config.in new file +1
-0+# Exemples
This comment is not needed (and uses the French spelling, it should have been Examples).
package/sfml/Config.in line 44
Quoted 8 lines
package/sfml/Config.in new file +8
-0+config BR2_PACKAGE_SFML_EXAMPLES + bool "examples" + help + This boolean option controls whether the SFML examples are + built alongside the library or not. + + +
Only one empty new line.
package/sfml/Config.in line 45
Quoted 1 line
package/sfml/Config.in new file +1
-0+# Allow to select only Audio, Window, Graphics or Network
Comments are not needed.
package/sfml/Config.in line 49
Quoted 4 lines
package/sfml/Config.in new file +4
-0+config BR2_PACKAGE_SFML_CUSTOM_MODULES + bool "custom modules" + help + Allow to select only a subset of modules.
Do we really need this option ?
package/sfml/Config.in line 55
Quoted 5 lines
package/sfml/Config.in new file +5
-0+if BR2_PACKAGE_SFML_CUSTOM_MODULES + +config BR2_PACKAGE_SFML_AUDIO + bool "audio" + default y
Defaulting to y is not really the classic Buildroot choice: we generally try to have a very minimal build by default.
package/sfml/Config.in line 56
Quoted 1 line
package/sfml/Config.in new file +1
-0+ select BR2_PACKAGE_FLAC
BR2_PACKAGE_FLAC has a depends on BR2_USE_WCHAR, so you need to replicate this dependency.
package/sfml/Config.in line 59
Quoted 3 lines
package/sfml/Config.in new file +3
-0+ select BR2_PACKAGE_LIBOGG + select BR2_PACKAGE_LIBVORBIS + select BR2_PACKAGE_OPENAL
This option has the following dependencies:
depends on BR2_INSTALL_LIBSTDCPP depends on BR2_TOOLCHAIN_HAS_THREADS_NPTL depends on BR2_PACKAGE_OPENAL_ARCH_SUPPORTS
so you need to replicate these dependencies.
package/sfml/Config.in line 67
Quoted 8 lines
package/sfml/Config.in new file +8
-0+ help + This boolean option controls whether the SFML audio module + is built or not. + +config BR2_PACKAGE_SFML_GRAPHICS + bool "graphics" + default y + select BR2_PACKAGE_SFML_WINDOW
This option has a depends on BR2_PACKAGE_SFML_X11, so you need to replicate this dependency.
package/sfml/Config.in line 77
Quoted 10 lines
package/sfml/Config.in new file +10
-0+ select BR2_PACKAGE_FREETYPE + select BR2_PACKAGE_JPEG + help + This boolean option controls whether the SFML graphics module + is built or not. + +config BR2_PACKAGE_SFML_WINDOW + bool "window" + default y + depends on BR2_PACKAGE_SFML_X11
I am not really sure at this point of the articulation between BR2_PACKAGE_SFML_X11 and BR2_PACKAGE_SFML_WINDOW. What happens if BR2_PACKAGE_SFML_X11=y, but BR2_PACKAGE_SFML_WINDOW is disabled ? Your .mk file will only add xlib_{libX11,libXext} to the dependencies, but that's it.
I'm not sure it makes sense to have separate options: SFML_WINDOW should just depend on BR2_PACKAGE_XORG7 and select BR2_PACKAGE_XLIB_{LIBX11,LIBXEXT}.
Quoted 4 lines
package/sfml/Config.in new file +4
-0+ help + This boolean option controls whether the SFML window module + is built or not. +
package/sfml/Config.in line 91
Quoted 10 lines
package/sfml/Config.in new file +10
-0+config BR2_PACKAGE_SFML_NETWORK + bool "network" + default y + help + This boolean option controls whether the SFML network module + is built or not. + +endif # BR2_PACKAGE_SFML_CUSTOM_MODULES + +
Only one empty line.
package/sfml/Config.in line 101
Quoted 10 lines
package/sfml/Config.in new file +10
-0+# TODO: Check if it can build w/ the internals libraries +# Use buildroot libs by default +config BR2_PACKAGE_SFML_EXTLIB + bool "extlibs" + default y + help + This boolean option controls whether the dependencies from + the extlibs directory are used or whether the system + dependencies are used. The stb_image_* header in the extlibs + directory are used regardless of this option.
We don't need this option: we never want to use bundled libraries, and always want to use external libraries built by separate Buildroot packages.
package/sfml/Config.in line 110
Quoted 7 lines
package/sfml/Config.in new file +7
-0+config BR2_PACKAGE_SFML_PKGCONF + bool "install pkg-config file" + depends on BR2_PACKAGE_PKGCONF + default y + help + This boolean option controls whether CMake will install the + pkg-config files on your system or not.
We don't need this option: it should be installed unconditionally.
package/sfml/Config.in line 116
Quoted 4 lines
package/sfml/Config.in new file +4
-0+endif + +comment "SFML needs a toolchain w/ thread support" + depends on !BR2_TOOLCHAIN_HAS_THREADS
You have a comment about a thread dependency, but you don't have any BR2_TOOLCHAIN_HAS_THREADS dependency anywhere, this does not make sense.
Of course, if you read my review above, you will see that you will have many more dependencies than BR2_TOOLCHAIN_HAS_THREADS.
package/sfml/sfml.hash line 3
Quoted 10 lines
package/sfml/sfml.hash new file +3
-0@@ -0,0 +1,3 @@ +# Locally calculated +sha256 438c91a917cc8aa19e82c6f59f8714da353c488584a007d401efac8368e1c785 sfml-2.5.1.tar.gz +sha256 8143f9ad51ddf0a5b0629beabf8e1432ac3e5a2f3b62b510f3b16712e4bb9143 license.md
Please make sure the last line has a final newline.
Quoted 8 lines
package/sfml/sfml.mk new file +2
-0@@ -0,0 +1,79 @@ +################################################################################ +#
package/sfml/sfml.mk line 12
Quoted 10 lines
package/sfml/sfml.mk new file +10
-0+# sfml +# +################################################################################ + +SFML_VERSION = 2.5.1 +SFML_SITE = $(call github,SFML,SFML,$(SFML_VERSION)) +SFML_LICENSE = Zlib +SFML_LICENSE_FILES = license.md +SFML_INSTALL_STAGING = YES +SFML_DEPENDENCIES = udev #pthread
You cannot have udev in the dependencies without having a "depends on BR2_PACKAGE_UDEV" in the Config.in file.
package/sfml/sfml.mk line 17
Quoted 3 lines
package/sfml/sfml.mk new file +3
-0+# x-includes and x-libraries must be set for cross-compiling +# By default x_includes and x_libraries contains unsafe paths. +# (/usr/X11R6/include and /usr/X11R6/lib)
And ? What are you doing about this ?
package/sfml/sfml.mk line 27
Quoted 10 lines
package/sfml/sfml.mk new file +10
-0+ifeq ($(BR2_PACKAGE_SFML_X11),y) +SFML_DEPENDENCIES += xlib_libX11 xlib_libXext +endif + +ifeq ($(BR2_PACKAGE_SFML_OPENGL),y) +SFML_DEPENDENCIES += libgl +endif + + +# Make sure to disable documentation
Comment is not needed.
package/sfml/sfml.mk line 36
Quoted 9 lines
package/sfml/sfml.mk new file +9
-0+SFML_CONF_OPTS += -DSFML_BUILD_DOC=OFF + + +# Build type +ifeq ($(BR2_ENABLE_DEBUG),y) +SFML_CONF_OPTS += -DCMAKE_BUILD_TYPE=Debug +else +SFML_CONF_OPTS += -DCMAKE_BUILD_TYPE=Release +endif
This is not needed: CMAKE_BUILD_TYPE is already passed correctly by the cmake-package infrastructure.
package/sfml/sfml.mk line 35
Quoted 1 line
package/sfml/sfml.mk new file +1
-0+# Exemples
This comment is not needed, and is in french :)
Quoted 24 lines
package/sfml/sfml.mk new file +24
-0+ifeq ($(BR2_PACKAGE_SFML_EXAMPLES),y) +SFML_CONF_OPTS += -DSFML_BUILD_EXAMPLES=ON +else +SFML_CONF_OPTS += -DSFML_BUILD_EXAMPLES=OFF +endif + +ifeq ($(BR2_PACKAGE_SFML_AUDIO),y) +SFML_DEPENDENCIES += openal libogg libvorbis flac +SFML_CONF_OPTS += -DSFML_BUILD_AUDIO=ON +else +SFML_CONF_OPTS += -DSFML_BUILD_AUDIO=OFF +endif + +ifeq ($(BR2_PACKAGE_SFML_GRAPHICS),y) +SFML_DEPENDENCIES += jpeg freetype +SFML_CONF_OPTS += -DSFML_BUILD_GRAPHICS=ON +else +SFML_CONF_OPTS += -DSFML_BUILD_GRAPHICS=OFF +endif + +ifeq ($(BR2_PACKAGE_SFML_WINDOW),y) +SFML_CONF_OPTS += -DSFML_BUILD_WINDOW=ON +else +SFML_CONF_OPTS += -DSFML_BUILD_WINDOW=OFF
package/sfml/sfml.mk line 73
Quoted 10 lines
package/sfml/sfml.mk new file +10
-0+endif + +ifeq ($(BR2_PACKAGE_SFML_NETWORK),y) +SFML_CONF_OPTS += -DSFML_BUILD_NETWORK=ON +endif + +# Do not used provided external libs +ifneq ($(BR2_PACKAGE_SFML_EXTLIB),y) +SFML_CONF_OPTS += -DSFML_USE_SYSTEM_DEP=ON +endif
This should be unconditionally set to "ON".
package/sfml/sfml.mk line 77
Quoted 3 lines
package/sfml/sfml.mk new file +3
-0+ifeq ($(BR2_PACKAGE_SFML_PKGCONF),y) +SFML_CONF_OPTS += -DSFML_INSTALL_PKGCONFIG_FILES=ON +endif
Ditto.
package/sfml/sfml.mk line 79
Quoted 3 lines
package/sfml/sfml.mk new file +2
-0+ +$(eval $(cmake-package))
Please have a final new line at the end of the file.
Overall, most comments can be addressed fairly easily. The only significant comment is whether we want separate options for X11 and WINDOW.
Best regards,
Thomas
Signature · 3 lines
Thomas Petazzoni, CTO, Bootlin Embedded Linux and Kernel engineering https://bootlin.com