premake/website/docs/linkgroups.md

13 lines
664 B
Markdown
Raw Normal View History

2021-03-11 20:29:22 +00:00
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.