wut/CHANGELOG.md

wut 1.0.0-beta10

Breaking changes

• libwhb's network command server (WHBCommandServer) functions and the associated <whb/commandserver.h> header have been removed.

Deprecations

• The CMake macro wut_create_rpl has been re-implemented. The new version doesn't create a build target for the rpx/rpl binary, and only regenerates the rpx/rpl when actually necessary. The new syntax is wut_create_rpl(<TARGET>). Deprecated calls in the form wut_create_rpl(file.rpx <TARGET>) will fall through to the old implementation.

API additions

• Cafe functions inet_ntoa_r, inet_ntop, and inet_pton have been added to <nsysnet/socket.h> (thanks @Crayon2000!)
• Cafe functions VPADGetTPCalibratedPointEx, VPADGetTPCalibrationParam, and VPADSetTPCalibrationParam have been added to <vpad/input.h>.
• Cafe functions OSGetOSID and __OSGetProcessSDKVersion have been added to <coreinit/systeminfo.h> (thanks @Maschell!)
• Cafe function _SYSGetSystemApplicationTitleId has been added to <sysapp/title.h> (thanks @Maschell!)
• Cafe functions SYSGetCallerPFID, _SYSGetSystemApplicationTitleIdByProdArea, and SYSGetCallerTitleId have been added <sysapp/title.h>.
• Cafe functions OSReportVerbose, OSReportInfo, and OSReportWarn have been added to <coreinit/debug.h>.
• New libwhb functions WHBGfxGetTVColourBuffer, WHBGfxGetTVDepthBuffer, WHBGfxGetTVContextState, and equivalents for the DRC, have been added to <whb/gfx.h>.
• Helper functions have been added to <gx2/shaders.h> which can look up shader uniforms by name.
• A new header file, <nn/acp.h>, has been added for nn_acp's meta.xml functionality (thanks @Maschell!)
• Cafe structure KPADStatus (from <padscore/kpad.h>) has been documented, had accelerometer data added, and had nunchuk-specific values added (thanks @Crayon2000!)
• Various Cafe structures in <coreinit/mcp.h> have been updated with newly-discovered members (thanks @Maschell, again!)
• Cafe enum GX2PrimitiveMode has been updated to include the LINES_ADJACENCY, LINE_STRIP_ADJACENCY, TRIANGLES_ADJACENCY, TRIANGLE_STRIP_ADJACENCY, RECTS, and LINE_LOOP primitives.

Other changes

• Cafe functions throughout the GX2 headers have had const applied as appropriate, allowing for better compiler optimisations.
• libwhb's Console and graphics helpers have been refactored to better support Cafe's multitasking and home menu overlay. Applications using WHBConsole can now be backgrounded and resumed without issue.
• Cafe's KPAD library has been documented, WPAD has been partially documented, and various fixes were made to the VPAD documentation (thanks @Crayon2000!)
• CMake now searches for libraries in internal devkitPPC folders, allowing find_library(m) (and CMake pkg-config equivalents) to work as expected.
• CMake now sets the pkg-config binary to powerpc-eabi-pkg-config, installable from the dkp-libs repo as wiiu-pkg-config. Application scripts no longer need to set PKG_CONFIG_EXECUTABLE.
• wutstdc++'s threading implementation has been changed to behave more like a pre-emptive scheduler, yielding a thread after 1ms runtime. This applies to std::thread and <threads.h>, not applications working with OSThread directly.

wut 1.0.0-beta9

Breaking changes

• coreinit's exit is no longer defined in <coreinit/exit.h>. Please use <stdlib.h> instead, which pulls in newlib's exit.
• RPL import sections (.fimport_coreinit etc.) are now garbage-collected when using wut-tools 1.1.0 or above (required). Code relying on weak links to Cafe functions may exhibit different behaviour.
• snd_core and snd_user are no longer linked, due to naming conflicts with sndcore2 and snduser2. wut has never shipped headers for these libraries, but if you are using them, please switch to sndcore2 and snduser2.
• Changes to CMake's linker flags may cause existing build trees to fail. Please delete any old build files and re-run CMake.
• Two new symbols, __rpx_start and __rpl_start, are now used internally by the toolchain, while _start is now undefined. As usual, applications are strongly discouraged from prefixing any symbol with two underscores, in order to avoid conflicts of this type.

Deprecations

• WUT_ROOT should no longer be defined in the user's environment, and will be set to $DEVKITPRO/wut internally. CMake lists and makefiles that use $WUT_ROOT/share to find wut.mk or wut.toolchain.cmake should be changed to $DEVKITPRO/wut/share.
• All of wut's static libraries (-lcoreinit, -lwhb, etc.) have been merged into a single libwut, which gets automatically linked in for all builds. While empty static libraries have been provided for CMake builds to ease the transition, these will be removed eventually. Applications should remove the build flags to link any of wut's libraries.
• Similarly, wut's build configuration options (devoptab, wutmalloc, newlib) are now integrated into libwut. For CMake builds, the wut_enable_* macros will now log a deprecation warning, and should be removed as soon as possible.
• Use of wut.mk as a build system is now deprecated. Applications should move to wut_rules and devkitPro-style makefiles, such as those in the samples. wut.mk will not be updated further, and will be removed in a future release.

Other changes

• Builds refactored: wut now uses Makefiles to build itself, as well as providing a devkitPro-style wut_rules file - see the samples/make folder. The cmake samples are now in samples/cmake.
• A new linking feature, __rplwrap, was added to help deal with conflicts between newlib's and Cafe's functions. Because of this, wut 1.0.0-beta9 requires wut-tools 1.1.0 or newer.
• Using rplwrap, newlib's exit is now correctly chained with coreinit's - calls like atexit should work; whether calling exit or just returning from main. Applications using coreinit's _Exit are encouraged to migrate to a normal exit call.
• A new header file, <coreinit/codegen.h>, has been added and documented for OSCodegen functionality.

wut 1.0.0-beta8