{"payload":{"allShortcutsEnabled":false,"fileTree":{"premake":{"items":[{"name":"Cygwin","path":"premake/Cygwin","contentType":"directory"},{"name":"Linux","path":"premake/Linux","contentType":"directory"},{"name":"MinGW","path":"premake/MinGW","contentType":"directory"},{"name":"VisualC","path":"premake/VisualC","contentType":"directory"},{"name":"Xcode-iOS","path":"premake/Xcode-iOS","contentType":"directory"},{"name":"Xcode","path":"premake/Xcode","contentType":"directory"},{"name":"config","path":"premake/config","contentType":"directory"},{"name":"patches","path":"premake/patches","contentType":"directory"},{"name":"projects","path":"premake/projects","contentType":"directory"},{"name":"util","path":"premake/util","contentType":"directory"},{"name":"README-cygwin.txt","path":"premake/README-cygwin.txt","contentType":"file"},{"name":"README-ios.txt","path":"premake/README-ios.txt","contentType":"file"},{"name":"README-linux.txt","path":"premake/README-linux.txt","contentType":"file"},{"name":"README-macosx.txt","path":"premake/README-macosx.txt","contentType":"file"},{"name":"README-mingw.txt","path":"premake/README-mingw.txt","contentType":"file"},{"name":"README-windows.txt","path":"premake/README-windows.txt","contentType":"file"},{"name":"README.txt","path":"premake/README.txt","contentType":"file"},{"name":"changelog","path":"premake/changelog","contentType":"file"},{"name":"premake4.lua","path":"premake/premake4.lua","contentType":"file"}],"totalCount":19},"":{"items":[{"name":"VisualC-WinRT","path":"VisualC-WinRT","contentType":"directory"},{"name":"VisualC","path":"VisualC","contentType":"directory"},{"name":"Xcode-iOS","path":"Xcode-iOS","contentType":"directory"},{"name":"Xcode","path":"Xcode","contentType":"directory"},{"name":"acinclude","path":"acinclude","contentType":"directory"},{"name":"android-project","path":"android-project","contentType":"directory"},{"name":"build-scripts","path":"build-scripts","contentType":"directory"},{"name":"cmake","path":"cmake","contentType":"directory"},{"name":"debian","path":"debian","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"include","path":"include","contentType":"directory"},{"name":"premake","path":"premake","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"test","path":"test","contentType":"directory"},{"name":"visualtest","path":"visualtest","contentType":"directory"},{"name":".hgignore","path":".hgignore","contentType":"file"},{"name":"Android.mk","path":"Android.mk","contentType":"file"},{"name":"BUGS.txt","path":"BUGS.txt","contentType":"file"},{"name":"CMakeLists.txt","path":"CMakeLists.txt","contentType":"file"},{"name":"COPYING.txt","path":"COPYING.txt","contentType":"file"},{"name":"CREDITS.txt","path":"CREDITS.txt","contentType":"file"},{"name":"INSTALL.txt","path":"INSTALL.txt","contentType":"file"},{"name":"Makefile.in","path":"Makefile.in","contentType":"file"},{"name":"Makefile.minimal","path":"Makefile.minimal","contentType":"file"},{"name":"Makefile.pandora","path":"Makefile.pandora","contentType":"file"},{"name":"Makefile.psp","path":"Makefile.psp","contentType":"file"},{"name":"Makefile.wiz","path":"Makefile.wiz","contentType":"file"},{"name":"README-SDL.txt","path":"README-SDL.txt","contentType":"file"},{"name":"README.txt","path":"README.txt","contentType":"file"},{"name":"SDL2.spec.in","path":"SDL2.spec.in","contentType":"file"},{"name":"TODO.txt","path":"TODO.txt","contentType":"file"},{"name":"VisualC.html","path":"VisualC.html","contentType":"file"},{"name":"WhatsNew.txt","path":"WhatsNew.txt","contentType":"file"},{"name":"autogen.sh","path":"autogen.sh","contentType":"file"},{"name":"cmake_uninstall.cmake.in","path":"cmake_uninstall.cmake.in","contentType":"file"},{"name":"configure","path":"configure","contentType":"file"},{"name":"configure.in","path":"configure.in","contentType":"file"},{"name":"sdl2-config.cmake.in","path":"sdl2-config.cmake.in","contentType":"file"},{"name":"sdl2-config.in","path":"sdl2-config.in","contentType":"file"},{"name":"sdl2.m4","path":"sdl2.m4","contentType":"file"},{"name":"sdl2.pc.in","path":"sdl2.pc.in","contentType":"file"}],"totalCount":41}},"fileTreeProcessingTime":4.217169,"foldersToFetch":[],"repo":{"id":330008801,"defaultBranch":"main","name":"SDL","ownerLogin":"libsdl-org","currentUserCanPush":false,"isFork":false,"isEmpty":false,"createdAt":"2021-01-15T19:55:54.000Z","ownerAvatar":"https://avatars.githubusercontent.com/u/77683370?v=4","public":true,"private":false,"isOrgOwned":true},"symbolsExpanded":false,"treeExpanded":true,"refInfo":{"name":"ce0f90ffb9c845d70ce833e75b3764a8246213cb","listCacheKey":"v0:1709678518.0","canEdit":false,"refType":"tree","currentOid":"ce0f90ffb9c845d70ce833e75b3764a8246213cb"},"path":"premake/README-linux.txt","currentUser":null,"blob":{"rawLines":["You may generate GNU makefiles for building SDL2 and its related test suite by","using the gmake shell script in the Linux/build-scripts folder.","","Linux support is currently experimental for the meta-build system. Most of the","progress made on this support happened toward the end of the meta-build system","project, so there is a lot currently missing that could be added in the future.","For the most part, the Linux support works well, but there is a significant","amount of testing needed to verify it can be built in many different","environments.","","The Linux project does not target every dependency it should (as seen in the","autotools configure script or in the CMake script), but it does target the","following dependencies:",""," -D-Bus (required to build Linux at all)"," -DLOpen (most of the other dependencies are dependent on this)"," -ALSA"," -PulseAudio"," -ESD"," -NAS"," -OSS"," -X11"," -OpenGL","","Also, the Linux system should be building the SDL2 library as a shared library,","but it builds it as a static library because of a few premake-related issues.","This is because when the makefile generated by premake tells the linker where to","find the definitions library (libSDL2.o), it also gives a hint to the loader to","find libSDL2.so in the same place, with a relative path. This means in order to","execute the program dynamically linked to SDL2, it's looking in some path like:",""," \"../../SDL2/Build/Debug\"","","Now, while this path works at the location of the makefile (such as","./tests/testsprite), it does not make sense from the actual location of the","executable (./tests/testsprite/Build/Debug). Furthermore, it's just massively","inconvenient to have a relative path to look for the shared object. Moving","libSDL2.so into the same directory as the executable does not solve this issue.","Unfortunately, premake also does not allow an install target to be created for","the makefiles, which is another one of the major issues related to building SDL2","as a shared library on Linux. Once these problems are solved, this support","should be very straightforward to add to this system in the future.","","The Linux system does have both an automated test and cleaning shell files for","running through the entire supported test suite and cleaning up the generated","and built files, respectively."],"stylingDirectives":[[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[]],"colorizedLines":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":false,"configFilePath":null,"networkDependabotPath":"/libsdl-org/SDL/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":null},"displayName":"README-linux.txt","displayUrl":"https://github.com/libsdl-org/SDL/blob/ce0f90ffb9c845d70ce833e75b3764a8246213cb/premake/README-linux.txt?raw=true","headerInfo":{"blobSize":"2.21 KB","deleteTooltip":"You must be signed in to make or propose changes","editTooltip":"You must be signed in to make or propose changes","ghDesktopPath":null,"isGitLfs":false,"onBranch":false,"shortPath":"9374b72","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2Flibsdl-org%2FSDL%2Fblob%2Fce0f90ffb9c845d70ce833e75b3764a8246213cb%2Fpremake%2FREADME-linux.txt","isCSV":false,"isRichtext":false,"toc":null,"lineInfo":{"truncatedLoc":"46","truncatedSloc":"39"},"mode":"executable file"},"image":false,"isCodeownersFile":null,"isPlain":false,"isValidLegacyIssueTemplate":false,"issueTemplate":null,"discussionTemplate":null,"language":"Text","languageID":372,"large":false,"planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/libsdl-org/SDL/blob/ce0f90ffb9c845d70ce833e75b3764a8246213cb/premake/README-linux.txt","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","releasePath":"/libsdl-org/SDL/releases/new?marketplace=true","showPublishActionBanner":false},"rawBlobUrl":"https://github.com/libsdl-org/SDL/raw/ce0f90ffb9c845d70ce833e75b3764a8246213cb/premake/README-linux.txt","renderImageOrRaw":false,"richText":null,"renderedFileInfo":null,"shortPath":null,"symbolsEnabled":true,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timed_out":false,"not_analyzed":true,"symbols":[]}},"copilotInfo":null,"copilotAccessAllowed":false,"csrf_tokens":{"/libsdl-org/SDL/branches":{"post":"jGnx3nTWCc_CBwzYuG77mPoAwj9YWU24uBfw6EmYKeUSPy7IK7cUlbREBwXWRNsYHIj_UbUdiS2SqK-laYPCuA"},"/repos/preferences":{"post":"kR4ahnYAQgpKxm7SqixHwR7_gK01u7K-Mqnd4Gf0TrQPU-urGLnSC3mtmAaQkeipr-3tVm0x1wH_LpOwB26ZsQ"}}},"title":"SDL/premake/README-linux.txt at ce0f90ffb9c845d70ce833e75b3764a8246213cb ยท libsdl-org/SDL"}