:static and :shared specifiers for links are not documented

[KyrietS]

When linking to a library you can specify additional decorators:

links { "some_syslib:static" }
links { "some_syslib:shared" }

It works only for GCC compiler. This feature was introduced in 5.0-alpha11 and is implemented here: https://github.com/premake/premake-core/blob/master/src/tools/gcc.lua#L571

As pointed out in the discussion #1817 it should be documented.

Suggested locations where documentation can be extended:

• https://premake.github.io/docs/Linking/
• https://premake.github.io/docs/links/

[nickclark2016]

Since Clang relies pretty heavily on GCC, do we know if Clang supports this as well?

[KyrietS]

I'm not the one who knows the answer 😄
I have no experience with Clang ._.

[nickclark2016]

As part of this, we should probably investigate the clang and msvc toolsets.