premake/website/docs/linkgroups.md
2021-03-12 22:10:24 +01:00

13 lines
664 B
Markdown

Turns on/off linkgroups for gcc/clang in the gmake backend.
```lua
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](links.md) API.