premake/website/docs/linkgroups.md

Turns on/off linkgroups for gcc/clang in the gmake backend.

linkgroups ("value")

Parameters

value is a boolean value, i.e. "On" or "Off".

When linking against another projects or libraries gcc/clang by default have order dependent linking, at least with the general default linker. While it is generally beleived to be slower, you can enable order independent linking within a group of libraries by putting them inside of a link-group using the -Wl,--start-group and -Wl,--end-group command line arguments.

This API turns this grouping on or off (it is off by default), and applies to all libraries specified in the links API.